Saltar al contenido

Ejemplos de reportes de bugs: buenos y malos, comparados

Cuatro ejemplos realistas de reportes de bugs, cada uno en versión floja y reescrito bien, con notas sobre qué hace que un reporte sea fácil de resolver.

Un buen ejemplo de reporte de bug tiene siempre las mismas partes: un título concreto, el entorno, pasos numerados para reproducirlo desde un punto de partida conocido, el resultado esperado y el real con el texto exacto del error, con qué frecuencia ocurre y pruebas. Abajo hay cuatro bugs realistas, cada uno escrito dos veces: primero como se suelen reportar los bugs y después reescrito de forma que un desarrollador pueda ponerse a trabajar sin hacer ni una sola pregunta.

Los ejemplos cubren los tipos de bug más habituales: un flujo que falla sin avisar, un problema de diseño en un solo dispositivo, datos incorrectos y un error intermitente. Si quieres una versión en blanco del formato, copia nuestra plantilla de reporte de bugs. Para entender el porqué de cada campo, lee cómo escribir un reporte de bug.

Ejemplo 1: Un flujo que falla sin avisar

Un usuario restablece su contraseña, pero el correo nunca llega.

La versión floja

Título: El restablecimiento de contraseña está roto

El restablecimiento de contraseña no funciona. Lo he probado varias veces. Arreglad esto YA.

Este reporte no le da casi nada al desarrollador. ¿Qué cuenta? ¿Qué entorno? ¿El formulario mostró un error o dijo que todo había ido bien? «Lo he probado varias veces» insinúa algo, pero no qué. Y «YA» sin explicar el impacto no ayuda a nadie a priorizar.

La versión buena

Título: No se envía el correo de restablecimiento de contraseña a las cuentas creadas con inicio de sesión de Google

Entorno
- URL: https://app.example.com/forgot-password
- Chrome 154, macOS 26
- Cuenta: [email protected] (creada con "Continue with Google")
- Hora: 2026-11-10 09:12 UTC

Pasos para reproducirlo
1. Ve a /forgot-password sin haber iniciado sesión.
2. Escribe [email protected] y haz clic en "Send reset link".

Resultado esperado
Llega un correo de restablecimiento en pocos minutos.

Resultado real
La página muestra "Check your inbox". No llega ningún correo (esperé 30 minutos,
revisé el spam). Red: POST /api/auth/reset devolvió 200 con el cuerpo
{"sent": false, "reason": "no_password_identity"}.

Frecuencia
Siempre en cuentas creadas con Google (3/3). Funciona en una cuenta con
correo y contraseña ([email protected]).

Gravedad
Mayor: los usuarios que se registraron con Google no pueden crear una contraseña.

Por qué funciona

Quien lo reporta comparó dos tipos de cuenta y encontró el patrón: solo afecta a las cuentas creadas con inicio de sesión de Google. Esa única comparación reduce la causa de «el correo está roto» a una rama concreta del código. También abrió el panel Network y copió el cuerpo de la respuesta, que muestra que el servidor sabe que no ha enviado nada mientras la página dice que todo fue bien. Esa contradicción es un segundo bug que vale la pena anotar. La hora exacta permite al equipo revisar los logs del proveedor de correo. Si nunca has mirado las peticiones de red, nuestra guía sobre cómo capturar el tráfico de red en Chrome te enseña a hacerlo.

Ejemplo 2: Un bug de diseño en un solo dispositivo

En la pantalla de un móvil pequeño, un banner tapa el botón que los usuarios tienen que pulsar.

La versión floja

Título: No puedo darle a guardar en el móvil

El botón de guardar no funciona en mi móvil.

«No funciona» puede significar que el botón no hace nada, que muestra un error o que no se puede alcanzar. «Mi móvil» puede ser cualquiera de miles de dispositivos y navegadores. Un desarrollador que pruebe en un móvil grande probablemente no verá ningún problema y cerrará el ticket.

La versión buena

Título: El banner de cookies tapa el botón Save de la página de perfil en pantallas pequeñas

Entorno
- URL: https://app.example.com/settings/profile
- Safari en iPhone SE (3.ª generación), iOS 26, en vertical
- Viewport de unos 375 x 667
- No se reproduce en iPhone 15 Pro ni en escritorio

Pasos para reproducirlo
1. Abre la URL en una pestaña privada (para que aparezca el banner de cookies).
2. Inicia sesión como [email protected].
3. Desplázate hasta el final del formulario de perfil.

Resultado esperado
El botón Save se ve y se puede tocar por encima del banner de cookies.

Resultado real
El banner de cookies (fijo, de unos 180 px de alto) tapa el botón Save.
Al tocar donde debería estar el botón se abre el enlace "Settings" del banner.
Al cerrar el banner, Save vuelve a estar accesible.

Solución provisional
Acepta o cierra primero el banner de cookies.

Adjuntos
- Captura: profile-save-hidden-iphone-se.png (banner marcado en rojo)

Por qué funciona

Los bugs de diseño dependen del tamaño de pantalla, así que el dispositivo exacto, la orientación y el viewport son los datos clave. Quien lo reporta también probó en otros dispositivos y anotó dónde no ocurre, lo que le indica al desarrollador que mire los estilos para pantallas pequeñas. El paso de la pestaña privada asegura que aparezca el banner, de modo que el desarrollador ve la misma pantalla. La solución provisional le dice a soporte qué responder hoy a los usuarios, y rebaja la urgencia de una forma que el equipo puede valorar por sí mismo.

Ejemplo 3: Datos incorrectos

El total del panel no coincide con los números exportados.

La versión floja

Título: Los números están mal

Los ingresos del panel están mal. La exportación muestra otra cosa.
No sé cuál está bien, pero uno de los dos está roto.

Quien lo reporta notó algo real, pero «los números están mal» obliga al desarrollador a averiguar qué números, de qué periodo y en cuánto. Los bugs de datos necesitan valores exactos, porque el tamaño de la diferencia suele ser la pista.

La versión buena

Título: Los ingresos de octubre en el panel son 1.240 $ menores que en la exportación CSV

Entorno
- URL: https://app.example.com/reports/revenue?period=2026-10
- Espacio de trabajo: Acme Demo (ID 4821), zona horaria America/Los_Angeles
- Chrome 154, Windows 11

Pasos para reproducirlo
1. Abre Reports y después Revenue.
2. Selecciona octubre de 2026.
3. Anota el total de la tarjeta.
4. Haz clic en "Export CSV" y suma la columna Amount.

Resultado esperado
El total del panel y la suma del CSV coinciden.

Resultado real
Panel: 48.310,00 $. Suma del CSV: 49.550,00 $. Diferencia: 1.240,00 $.
La diferencia es igual a los tres pedidos del 31 de octubre después de las 17:00,
hora de Los Ángeles (ID 99812, 99815, 99820).

Frecuencia
Siempre en octubre. Los totales de septiembre coinciden.

Notas (suposición)
Parece que el panel agrupa por fecha UTC y la exportación por la
zona horaria del espacio de trabajo.

Por qué funciona

El reporte da los dos números, la diferencia y los pedidos que la forman. Ese último paso le llevó unos minutos a quien lo reporta, y le ahorra mucho más tiempo al desarrollador. La suposición sobre las zonas horarias está marcada claramente como suposición, separada de lo observado. Mencionar que septiembre coincide demuestra que el bug está ligado a unos datos concretos y no a todo el informe.

Ejemplo 4: Un error intermitente

Las subidas a veces fallan y nadie sabe decir por qué.

La versión floja

Título: La subida falla a veces

A veces las subidas fallan con un error. Pasa al azar.

«Al azar» suele significar «por un motivo que nadie ha encontrado todavía». Sin el texto del error, los datos del archivo o un recuento, no hay nada que investigar.

La versión buena

Título: Subir archivos de más de 10 MB falla con "Upload failed (413)"

Entorno
- URL: https://app.example.com/projects/218/files
- Chrome 154 y Firefox 158, Windows 11, red de la oficina

Pasos para reproducirlo
1. Abre un proyecto y después la pestaña Files.
2. Haz clic en "Upload" y elige un PDF de más de 10 MB
   (probado: 10,4 MB, 12 MB, 25 MB).

Resultado esperado
El archivo se sube y aparece en la lista.

Resultado real
La barra de progreso llega a un 90 % y después aparece "Upload failed (413)".
Red: POST /api/files devolvió 413 Request Entity Too Large,
el cuerpo de la respuesta es una página de error HTML, no JSON.
Consola: Uncaught (in promise) SyntaxError: Unexpected token '<'

Frecuencia
Siempre con archivos de más de 10 MB (6/6). Nunca con archivos de menos de 9 MB (0/8).

Adjuntos
- Grabación de pantalla de una subida fallida (40 segundos)
- Archivo HAR saneado de un intento

Por qué funciona

El bug «aleatorio» resultó depender del tamaño del archivo, y quien lo reporta lo demostró con recuentos a ambos lados del umbral. El estado 413 y la respuesta en HTML apuntan a un límite de tamaño en algún punto delante de la app, y el error de consola explica por qué el usuario vio un mensaje genérico: la app intentó leer una página HTML como JSON. El archivo HAR está saneado, porque los archivos HAR llevan cookies y tokens; el sanitizador de HAR los quita en tu navegador.

Convertir un reporte flojo en uno bueno

Si haces el triaje de bugs para un equipo de soporte o de QA, recibirás muchos reportes como las versiones flojas de arriba. Reescribirlos es más rápido que devolverlos, siempre que consigas respuesta a cinco preguntas:

  1. ¿Qué viste exactamente? Pide el texto del error o una captura, no una descripción.
  2. ¿Dónde estabas? La URL o el nombre de la pantalla, y la cuenta.
  3. ¿Qué hiciste justo antes? Las últimas dos o tres acciones suelen bastar para empezar a reproducirlo.
  4. ¿Pasa siempre? Si no, más o menos con qué frecuencia, y si algo parece hacerlo más probable.
  5. ¿Qué intentabas conseguir? Esto te da el resultado esperado y el impacto real.

Haz las cinco preguntas en un solo mensaje. Quienes reportan, sobre todo los clientes, responden con gusto a una ronda de preguntas; a la tercera se rinden. Cuando tengas las respuestas, intenta reproducir el bug tú mismo y añade lo que descubras, como las comparaciones de los ejemplos de arriba. Un bug reproducido con tus propias pruebas adjuntas avanza por la cola mucho más rápido que un correo reenviado.

Lo que tienen en común los buenos ejemplos

  • Títulos que describen el síntoma y la condición, no solo la función.
  • Un punto de partida conocido y los datos exactos que se usaron.
  • Números y textos de error exactos, nunca «mal» o «un error».
  • Una comparación: otra cuenta, dispositivo, mes o tamaño de archivo con el que funciona.
  • Pruebas adjuntas, sin secretos.
  • Suposiciones marcadas como suposiciones.

Reunir las pruebas más rápido

La mayoría de las versiones buenas de arriba necesitaron la consola y el panel Network. Midge, una extensión de Chrome gratuita, captura ambos mientras grabas tu pantalla o haces una captura. Cada grabación incluye logs de consola, peticiones de red, acciones del usuario y datos del dispositivo. Las contraseñas, números de tarjeta, tokens y cookies se ocultan en tu navegador antes de que nada salga de tu dispositivo. El título, los pasos y el resultado esperado los sigues escribiendo tú; los detalles técnicos llegan adjuntos.

Guías relacionadas

Preguntas frecuentes

¿Cómo es un buen ejemplo de reporte de bug?

Tiene un título concreto, el entorno, pasos numerados desde un punto de partida conocido, el resultado esperado y el real con el texto exacto del error, con qué frecuencia ocurre y pruebas como una captura, un error de consola o una petición que falla.

¿Cuál es el error más común en los reportes de bugs?

Pasos para reproducirlo que faltan o son vagos. Sin ellos, el desarrollador tiene que adivinar cómo ocurrió el bug, y eso suele acabar en un ticket cerrado como no reproducible.

¿Un reporte de bug debe incluir una captura?

Sí, cuando el problema se ve. Añade también el texto del error, porque el texto se puede buscar y copiar, y añade una grabación corta cuando el bug implique varios pasos o dependa del momento.

¿Dónde consigo una versión en blanco de este formato?

Usa la plantilla de reporte de bugs para copiar y pegar de la documentación de Midge. Tiene los mismos campos que los buenos ejemplos de esta página.