Um teste do caso de uso com um repositório em memória consegue provar que a aplicação recusa uma despesa inválida. Para provar que duas transações disputam a mesma restrição única, o teste precisa passar pelo PostgreSQL. É o banco que decide a ordem dos bloqueios e o resultado do conflito.
Suba um banco descartável e execute as migrações reais
Use um banco ou schema isolado para a suíte e rode as mesmas migrações da aplicação. Evite recriar tabelas à mão dentro do teste. Uma coluna ou restrição esquecida nesse schema paralelo permite que a suíte passe enquanto a aplicação falha após o deploy.
Para casos comuns de repositório, prepare os dados mínimos e confira tanto o retorno quanto o estado persistido. Se os testes rodam em paralelo, reserve escopos de dados independentes. Um rollback ao final ajuda apenas quando o código exercitado usa a mesma transação do teste. Uma requisição HTTP que abre sua própria conexão pode escapar desse isolamento.
Controle a ordem de eventos
Em um teste de idempotência, mantenha a primeira transação aberta depois de reservar a chave. Dispare a segunda tentativa por outra conexão e libere a primeira usando uma barreira explícita. A suíte deve ter timeout para evitar ficar presa se o código entrar em deadlock. Compare o número de linhas e os IDs devolvidos pelas duas operações.
Teste também a atualização a partir da versão anterior do schema quando a mudança transforma dados existentes. Criar um banco vazio cobre a instalação inicial. Atualizar um banco com registros antigos cobre o caminho que a produção vai percorrer.
Pacote testing da biblioteca padrão de Go · Idempotência com PostgreSQL
Faça a suíte sobreviver à ordem e à concorrência
Um teste de integração precisa poder rodar sozinho ou junto dos demais. Dê nomes ou IDs exclusivos aos registros, evite depender de uma ordem implícita e limpe recursos mesmo quando uma asserção falhar. Se cada teste cria um schema, avalie o tempo de migração; se compartilha um banco, isole os dados e nunca use dados de produção. Registre no erro qual operação e qual estado esperado falharam.
Transações de teste simplificam a limpeza quando o código de produção participa da transação oferecida pelo harness. Quando o handler abre outra conexão, o rollback externo não engloba a escrita. Nesse caso use schema por teste, banco descartável ou uma rotina explícita de limpeza. O método escolhido deve refletir como o serviço realmente acessa o banco.
Valide comportamento observável
Além da quantidade de linhas, confira o código de erro, os campos persistidos e as relações entre as entidades. Um teste de migração pode iniciar da versão anterior, inserir registros representativos, aplicar as novas migrations e confirmar que os dados continuam legíveis. Um teste de concorrência deve abrir conexões independentes, porque duas goroutines compartilhando uma transação não reproduzem duas requisições concorrentes.
Separe testes que precisam de um servidor PostgreSQL de testes rápidos de domínio. Uma suíte muito lenta reduz a frequência com que desenvolvedores a executam. Use os dois níveis: lógica pura para regras locais e integração para SQL, constraints, migrações e isolamento. Mantenha as dependências de infraestrutura documentadas e ofereça uma mensagem clara quando o banco de teste não estiver disponível.