Reduzir a reprodução de um bug sem eliminar a condição que o causa

Objetivo

Minimizar um exemplo que falha, verificando que o caso reduzido ainda demonstra o defeito original e não um erro diferente, mais fácil de produzir.

Pré-requisitos

Tenha uma falha reproduzível, a assinatura observada dessa falha e um ambiente isolado. Antes de remover entradas ou simplificar a configuração, defina quais saídas ou transições de estado identificam o problema original.

Passos

1. Registre a menor observação confiável que distingue o defeito reportado do comportamento esperado. Anote o ambiente e as entradas relevantes, sem copiar dados privados desnecessários.

2. Remova uma categoria de complexidade de cada vez, como campos não relacionados, componentes opcionais ou etapas extras. Após cada redução, execute de novo a observação que distingue o defeito, em vez de verificar apenas se continua a ocorrer algum erro.

3. Se a falha mudar, restaure a última condição relevante e registre por que ela importava. Um erro de dependência ausente após a simplificação não preserva nenhuma evidência sobre o defeito original de concorrência ou de parsing.

4. Mantenha uma ligação entre o caso reduzido e o comportamento real que ele representa. Explique as premissas mantidas sobre temporização, ordem, codificação ou estado, para que outra pessoa que investigue possa julgar se o modelo é fiel.

5. Use o caso reduzido para avaliar uma correção candidata e, depois, verifique o cenário original ou uma versão representativa autorizada. Uma correção que satisfaz apenas o caso simplificado pode deixar intacto o gatilho em produção.

Resultado esperado

A reprodução final é pequena o bastante para ser inspecionada e deixa explícitas as condições que preservam o defeito. Quem investiga pode usá-la como evidência, e não apenas como um script que falha de forma conveniente.

Limites e base de verificação

Este é um procedimento de depuração original, sem que se afirme ter sido feita qualquer execução de reprodução. Algumas falhas intermitentes resistem a uma minimização estável. Nesse caso, reporte a frequência e as condições observadas somente se tiverem sido realmente medidas, e evite afirmar que uma não reprodução refuta a existência do problema.