Exemplos de bug report: bons e ruins, lado a lado
Quatro exemplos realistas de bug report, cada um numa versão fraca e numa reescrita forte, com notas sobre o que torna um report fácil de resolver.
Um bom exemplo de bug report sempre tem as mesmas partes: um título específico, o ambiente, passos numerados para reproduzir a partir de um ponto de partida conhecido, o resultado esperado e o obtido com o texto exato do erro, a frequência e as evidências. Abaixo estão quatro bugs realistas, cada um escrito duas vezes: primeiro do jeito que os bugs costumam ser reportados, depois uma reescrita com a qual um dev conseguiria trabalhar sem fazer uma única pergunta.
Os exemplos cobrem os tipos de bug mais comuns: um fluxo que falha em silêncio, um problema de layout num único dispositivo, dados errados e um erro intermitente. Se você quer uma versão em branco do formato, copie o nosso modelo de bug report. Para entender o porquê de cada campo, veja como escrever um bug report.
Exemplo 1: Um fluxo que falha em silêncio
Um usuário redefine a senha, mas o e-mail nunca chega.
A versão fraca
Título: Redefinição de senha quebrada
A redefinição de senha não funciona. Tentei várias vezes. Corrijam o quanto antes, por favor.
Este report não dá quase nada ao dev. Qual conta? Qual ambiente? O formulário mostrou um erro ou disse que deu certo? "Tentei várias vezes" sugere alguma coisa, mas não diz o quê. E "o quanto antes" sem dizer qual é o impacto não ajuda ninguém a priorizar.
A versão forte
Título: E-mail de redefinição de senha não é enviado para contas criadas com login do Google
Ambiente
- URL: https://app.example.com/forgot-password
- Chrome 154, macOS 26
- Conta: [email protected] (criada com "Continuar com o Google")
- Horário: 2026-11-10 09:12 UTC
Passos para reproduzir
1. Acesse /forgot-password sem estar logado.
2. Digite [email protected] e clique em "Enviar link de redefinição".
Resultado esperado
Um e-mail de redefinição chega em poucos minutos.
Resultado obtido
A página mostra "Confira sua caixa de entrada". Nenhum e-mail chega (esperei 30 minutos,
conferi o spam). Rede: POST /api/auth/reset retornou 200 com o body
{"sent": false, "reason": "no_password_identity"}.
Frequência
Sempre em contas criadas com o Google (3/3). Funciona numa conta de
e-mail e senha ([email protected]).
Severidade
Grave: usuários que se cadastraram com o Google não conseguem definir uma senha.
Por que funciona
Quem reportou comparou dois tipos de conta e encontrou o padrão: só as contas criadas com login do Google são afetadas. Essa única comparação reduz a causa de "o e-mail está quebrado" para um trecho específico do código. Também abriu o painel Network e copiou o body da resposta, que mostra que o servidor sabe que não enviou nada enquanto a página diz que deu certo. Essa contradição é um segundo bug que vale anotar. O horário exato permite que o time confira os logs do provedor de e-mail. Se você nunca olhou requisições de rede, o nosso guia sobre como capturar o tráfego de rede no Chrome mostra como.
Exemplo 2: Um bug de layout num único dispositivo
Numa tela de celular pequena, um banner cobre o botão que o usuário precisa tocar.
A versão fraca
Título: Não consigo clicar em salvar no celular
O botão de salvar não funciona no meu celular.
"Não funciona" pode querer dizer que o botão não faz nada, que mostra um erro ou que não dá para alcançá-lo. "Meu celular" pode ser qualquer um entre milhares de dispositivos e navegadores. Um dev que testa num celular grande provavelmente não vai ver problema nenhum e vai fechar o ticket.
A versão forte
Título: Banner de cookies cobre o botão Salvar na página de perfil em telas pequenas
Ambiente
- URL: https://app.example.com/settings/profile
- Safari no iPhone SE (3ª geração), iOS 26, na vertical
- Viewport de cerca de 375 x 667
- Não reproduz no iPhone 15 Pro nem no desktop
Passos para reproduzir
1. Abra a URL numa aba anônima (para que o banner de cookies apareça).
2. Faça login como [email protected].
3. Role até o fim do formulário de perfil.
Resultado esperado
O botão Salvar fica visível e dá para tocar nele, acima do banner de cookies.
Resultado obtido
O banner de cookies (fixo, com cerca de 180 px de altura) cobre o botão Salvar.
Tocar onde o botão deveria estar abre o link "Configurações" do banner.
Fechar o banner deixa o Salvar acessível.
Contorno
Aceite ou feche o banner de cookies primeiro.
Anexos
- Screenshot: profile-save-hidden-iphone-se.png (banner contornado em vermelho)
Por que funciona
Bugs de layout dependem do tamanho da tela, então o dispositivo exato, a orientação e o viewport são os fatos principais. Quem reportou também testou em outros dispositivos e anotou onde o problema não acontece, o que diz ao dev para olhar os estilos de telas pequenas. O passo da aba anônima garante que o banner apareça, então o dev vê a mesma tela. O contorno diz ao suporte o que responder aos usuários hoje e reduz a urgência de um jeito que o time pode avaliar sozinho.
Exemplo 3: Dados errados
O total do dashboard não bate com os números exportados.
A versão fraca
Título: Os números estão errados
A receita no dashboard está errada. A exportação mostra outra coisa.
Não sei qual está certa, mas uma das duas está quebrada.
Quem reportou notou algo real, mas "os números estão errados" obriga o dev a sair procurando quais números, de qual período e com quanta diferença. Bugs de dados precisam de valores exatos, porque o tamanho da diferença muitas vezes é a pista.
A versão forte
Título: Receita de outubro no dashboard está US$ 1.240 abaixo da exportação em CSV
Ambiente
- URL: https://app.example.com/reports/revenue?period=2026-10
- Workspace: Acme Demo (ID 4821), fuso horário America/Los_Angeles
- Chrome 154, Windows 11
Passos para reproduzir
1. Abra Relatórios e depois Receita.
2. Selecione outubro de 2026.
3. Anote o total no card.
4. Clique em "Exportar CSV" e some a coluna Valor.
Resultado esperado
O total do dashboard e a soma do CSV batem.
Resultado obtido
Dashboard: US$ 48.310,00. Soma do CSV: US$ 49.550,00. Diferença: US$ 1.240,00.
A diferença corresponde aos três pedidos feitos em 31 de outubro depois das 17:00
no horário de Los Angeles (IDs 99812, 99815, 99820).
Frequência
Sempre em outubro. Os totais de setembro batem.
Notas (palpite)
Parece que o dashboard agrupa pela data em UTC e a exportação pelo
fuso horário do workspace.
Por que funciona
O report traz os dois números, a diferença e os pedidos que compõem a diferença. Esse último passo levou alguns minutos de quem reportou e poupa muito mais tempo do dev. O palpite sobre fusos horários está claramente marcado como palpite, separado das observações. Mencionar que setembro bate mostra que o bug está ligado a dados específicos, e não ao relatório inteiro.
Exemplo 4: Um erro intermitente
Os uploads às vezes falham, e ninguém sabe dizer por quê.
A versão fraca
Título: Upload falha às vezes
Às vezes os uploads falham com um erro. Acontece aleatoriamente.
"Aleatoriamente" normalmente quer dizer "por um motivo que ninguém descobriu ainda". Sem o texto do erro, os detalhes do arquivo ou uma contagem, não há nada para investigar.
A versão forte
Título: Upload de arquivos acima de 10 MB falha com "Upload failed (413)"
Ambiente
- URL: https://app.example.com/projects/218/files
- Chrome 154 e Firefox 158, Windows 11, rede do escritório
Passos para reproduzir
1. Abra um projeto e depois a aba Arquivos.
2. Clique em "Upload" e escolha um PDF maior que 10 MB
(testado: 10,4 MB, 12 MB, 25 MB).
Resultado esperado
O arquivo é enviado e aparece na lista.
Resultado obtido
A barra de progresso chega a cerca de 90 por cento e então aparece "Upload failed (413)".
Rede: POST /api/files retornou 413 Request Entity Too Large,
o body da resposta é uma página de erro em HTML, não JSON.
Console: Uncaught (in promise) SyntaxError: Unexpected token '<'
Frequência
Sempre em arquivos acima de 10 MB (6/6). Nunca em arquivos abaixo de 9 MB (0/8).
Anexos
- Gravação de tela de um upload com falha (40 segundos)
- Arquivo HAR sanitizado de uma tentativa
Por que funciona
O bug "aleatório" acabou dependendo do tamanho do arquivo, e quem reportou provou isso com contagens dos dois lados do limite. O status 413 e a resposta em HTML apontam para um limite de tamanho em algum ponto na frente do app, e o erro de console explica por que o usuário viu uma mensagem genérica: o app tentou ler uma página HTML como JSON. O arquivo HAR está sanitizado, porque arquivos HAR carregam cookies e tokens; o sanitizador de HAR os remove no seu navegador.
Como transformar um report fraco num report forte
Se você faz a triagem de bugs para um time de suporte ou de QA, vai receber muitos reports como as versões fracas acima. Reescrevê-los é mais rápido do que devolvê-los, desde que você consiga respostas para cinco perguntas:
- O que exatamente você viu? Peça o texto do erro ou um screenshot, não uma descrição dele.
- Onde você estava? A URL ou o nome da tela, e a conta.
- O que você fez logo antes? As duas ou três últimas ações normalmente bastam para começar a reproduzir.
- Acontece toda vez? Se não, mais ou menos com que frequência, e alguma coisa parece torná-lo mais provável?
- O que você estava tentando fazer? Isso diz qual é o resultado esperado e o impacto real.
Faça as cinco perguntas numa única mensagem. Quem reporta, principalmente clientes, responde de boa vontade a uma rodada de perguntas; com três rodadas, desiste. Quando tiver as respostas, tente reproduzir o bug você mesmo e acrescente o que descobrir, como as comparações dos exemplos acima. Um bug reproduzido, com as suas próprias evidências anexadas, anda na fila muito mais rápido do que um e-mail encaminhado.
O que os bons exemplos têm em comum
- Títulos que descrevem o sintoma e a condição, não só a funcionalidade.
- Um ponto de partida conhecido e os dados exatos que foram usados.
- Números e textos de erro exatos, nunca "errado" ou "um erro".
- Uma comparação: outra conta, dispositivo, mês ou tamanho de arquivo em que funciona.
- Evidências anexadas, sem segredos.
- Palpites marcados como palpites.
Capture as evidências mais rápido
A maioria das versões fortes acima precisou do console e do painel Network. O Midge, uma extensão grátis do Chrome, captura os dois enquanto você grava a sua tela ou tira um screenshot. Toda gravação inclui logs de console, requisições de rede, ações do usuário e informações do dispositivo. Senhas, números de cartão, tokens e cookies são ocultados no seu navegador antes que qualquer coisa saia do seu dispositivo. Você ainda escreve o título, os passos e o resultado esperado; os detalhes técnicos já vêm anexados.
Guias relacionados
Perguntas frequentes
Como é um bom exemplo de bug report?
Ele tem um título específico, o ambiente, passos numerados a partir de um ponto de partida conhecido, o resultado esperado e o obtido com o texto exato do erro, a frequência e evidências como um screenshot, um erro de console ou uma requisição que falhou.
Qual é o erro mais comum em bug reports?
Passos para reproduzir ausentes ou vagos. Sem eles, o dev precisa adivinhar como o bug aconteceu, o que muitas vezes termina num ticket fechado como impossível de reproduzir.
Um bug report deve incluir um screenshot?
Sim, quando o problema é visível. Acrescente também o texto do erro, porque texto pode ser pesquisado e copiado, e inclua uma gravação curta quando o bug envolve vários passos ou depende do tempo.
Onde encontro uma versão em branco deste formato?
Use o modelo de bug report para copiar e colar na documentação do Midge. Ele tem os mesmos campos dos bons exemplos desta página.