Banco, migrations e schema

Migrations falhando, schema divergente, ou erros de conexão.

Quando usar

• Migration falha no deploy.

• App sobe, mas dá erro de tabela/coluna inexistente.

• Erros de conexão com banco.

Checklist rápido (2 min)

1. Confirme em qual ambiente o erro ocorre.

2. Verifique a migration mais recente aplicada.

3. Veja se há divergência entre schema esperado e schema real.

Diagnóstico

1) Conexão

• Credenciais/URL corretas?

• Rede/VPC liberada (se aplicável)?

2) Ordem e idempotência de migrations

• Migração depende de outra que não rodou?

• Migração roda duas vezes e quebra?

3) Dados existentes

• Alteração de coluna com dados antigos costuma quebrar.

• Constraints (NOT NULL / FK) exigem backfill.

Como resolver (padrões)

• Erro de coluna/tabela: revisar a última migration e o schema.

• Constraint falhou: fazer backfill antes de aplicar constraint.

• Conexão: validar secrets e permissões de rede.

Quando escalar

• Migration quebra repetidamente no pipeline.

• Corrupção/dados inconsistentes.

• Erro só em Prod e não reproduz em Staging.

Antes de escalar, junte estas evidências. Isso reduz muito o ping-pong.

• Projeto e ambiente (Dev/Staging/Prod).

• Horário do erro (com timezone).

• Passos para reproduzir (curto e determinístico).

• Mensagem de erro completa (sem prints cortados).

• Screenshot da tela (se aplicável).

• Console do browser (erros e warnings relevantes).

• Aba Network (request que falhou + status + payload, se não houver dados sensíveis).

Se existir um requestId, traceId ou link de execução, inclua também.