Pular para o conteúdo

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:

  1. O que exatamente você viu? Peça o texto do erro ou um screenshot, não uma descrição dele.
  2. Onde você estava? A URL ou o nome da tela, e a conta.
  3. O que você fez logo antes? As duas ou três últimas ações normalmente bastam para começar a reproduzir.
  4. Acontece toda vez? Se não, mais ou menos com que frequência, e alguma coisa parece torná-lo mais provável?
  5. 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.