Que fait Express & Fastify ?
Règles
- Organiser les routes par domaine :
routes/users.ts, routes/orders.ts — un routeur par ressource
- Valider toutes les entrées avec Zod : analyser
req.body, req.params, req.query avant le traitement
- Gestionnaire d'erreurs centralisé : middleware de rattrapage (Express) ou
setErrorHandler (Fastify)
- Renvoyer un format d'erreur cohérent :
{ error: { code: string, message: string, details?: unknown } }
- TypeScript : typer la requête/réponse avec des génériques —
Request<Params, ResBody, ReqBody, Query>
- Ordre des middlewares : CORS, analyseur de corps, authentification, limitation de débit, routes, gestionnaire d'erreurs
- Utiliser des gestionnaires de routes asynchrones — les encapsuler avec la gestion des erreurs ou utiliser
express-async-errors
- Fastify : utiliser le système de plugins pour encapsuler les routes et les décorateurs —
fastify.register()
- Schémas Fastify : définir des schémas JSON ou utiliser
@fastify/type-provider-zod pour la validation et la sérialisation
- Contrôle de santé :
GET /health — renvoyer 200 avec l'état de connectivité DB/Redis
- Arrêt gracieux : écouter SIGTERM, arrêter d'accepter les connexions, terminer les requêtes en cours
Modèles
import { Router } from "express";
import { z } from "zod";
const router = Router();
const CreateUserSchema = z.object({ email: z.string().email(), name: z.string().min(1) });
router.post("/users", async (req, res, next) => {
try {
const body = CreateUserSchema.parse(req.body);
const user = await createUser(body);
res.status(201).json(user);
} catch (err) { next(err); }
});
import Fastify from "fastify";
import { serializerCompiler, validatorCompiler, ZodTypeProvider } from "fastify-type-provider-zod";
const app = Fastify().withTypeProvider<ZodTypeProvider>();
app.setValidatorCompiler(validatorCompiler);
app.setSerializerCompiler(serializerCompiler);
app.post("/users", { schema: { body: CreateUserSchema } }, async (req) => {
return createUser(req.body);
});
À éviter
- Mettre la logique métier dans les gestionnaires de routes — l'extraire dans la couche service/domaine
- Oublier la gestion des erreurs asynchrones dans Express — les rejets non traités font planter le processus
- Importer toutes les routes dans un seul fichier — utiliser
router.use() ou les plugins Fastify pour la modularité
- Ignorer la validation des entrées parce que "le frontend valide" — toujours valider côté serveur