Busque em todas as páginas da documentação
Um catálogo de frota de armadilhas recorrentes em Rust e correções comprovadas - panics em manipuladores, Mutex entre await, incompatibilidades de ABI FFI, má configuração de pool e descompasso de implantação. Novos contratados leem as dez principais; post-mortems adicionam entradas com links de guardrail.
Cartão de referência rápida - pronto para copiar e colar.
## Lição LL-0042: erro de digitação no pool sqlx no Helm
**Tags:** deploy, oom, latency
**Sintoma:** Aumento de p95, CPU baixa, timeouts de aquisição
**Causa raiz:** `DATABASE_MAX_CONNECTIONS=2` em valores de produção com erro de digitação
**Correção:** Validação de esquema Helm + alerta de pool_acquire
**Guardrail:** PR #8821, regra Grafana 445
**Refs:** PM-2026-07-09Quando usar isso:
| ID | Padrão | Correção rápida |
|---|---|---|
| LL-0001 | unwrap em manipulador Axum | Mapear para AppError; clippy deny |
| LL-0002 | std::fs em rota async | spawn_blocking |
| LL-0003 | API revertida, workers não | Runbook de implantação acoplado |
| LL-0004 | Derivação de struct #[repr(C)] | Teste de layout + cbindgen |
| LL-0005 | format! por requisição em caminho crítico | Reutilização de buffer; Criterion guard |
| LL-0006 | GIT_SHA ausente em logs | Env na inicialização + campo de span |
| LL-0007 | Inchaço de tamanho WASM | wasm-opt CI gate |
| LL-0008 | Flag de recurso ativada por padrão | Política de desativar por padrão |
| LL-0009 | Descompasso cargo.lock API/worker | Liberação de único workspace |
| LL-0010 | Miri pulado em PR unsafe | Trabalho noturno de miri em crates FFI |
panic, async, ffi, oom, deploy, sqlx, tokio, wasm, supply-chain
docs/lessons-learned.md no repositório principal ou índice gerado.| Alternativa | Usar Quando | Não Usar Quando |
|---|---|---|
| Histórico apenas de ADR | Equipe pequena | Necessita de pesquisa baseada em sintomas |
| Apenas tags de ferramenta de incidente | Forte processo de IM | Narrativa de onboarding fraca |
| Runbook por serviço | Isolamento de nível 1 | Padrões de frota se repetem |
Qualquer engenheiro via PR; o mantenedor da guilda mescla.
Redigir nomes; manter o padrão técnico.
URLs de Runbook podem incluir âncora de ID da lição.
Marcar lições com edição/toolchain, se relevante.
Post-mortem é específico do incidente; lição é padrão generalizado.
Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4 e Polars 0.46+.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026