Cuidado ao usar express.json e express.raw na mesma aplicação

Quando você trabalha com webhooks ou integrações que precisam de payloads brutos, usar express.json pode acabar te travando.

No meu time, já passei por isso ao tentar receber dados do Stripe. O padrão é usar express.json para interpretar o corpo das requisições, mas em casos específicos como webhooks, isso causa problemas na validação do segredo.

A solução foi incluir express.raw antes do express.json, assim: app.use(express.raw({ type: "application/json" })). app.use(express.json()). Isso garante que os payloads brutos sejam recebidos e processados corretamente, sem perder a integridade do conteúdo para validação. Sem esse critério, a solução pode parecer simples no começo e cara no suporte.

A questão é: até que ponto podemos confiar na ordem dessas middlewares para não quebrar outros endpoints? E qual impacto isso tem na performance e na segurança? O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar.

Na prática, ajustar o pipeline de middlewares exige atenção, principalmente se você trabalha com múltiplos tipos de payloads. Uma abordagem mais segura seria separar esses endpoints, usando middlewares específicos para cada caso, ao invés de colocar tudo no mesmo pipeline. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois.

Quem aí já passou por esse tipo de ajuste? Como vocês lidam com esses trade-offs na rotina de produção? Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois.