Примеры баг-репортов: хороший и плохой рядом
Четыре реалистичных примера баг-репортов: слабый вариант и сильная переработка, а также разбор того, что делает баг-репорт удобным для работы.
В хорошем примере баг-репорта всегда одни и те же части: конкретный заголовок, окружение, пронумерованные шаги воспроизведения от известной отправной точки, ожидаемый и фактический результат с точным текстом ошибки, частота и улики. Ниже четыре реалистичных бага, каждый описан дважды: сначала так, как о багах часто сообщают, а затем в переработанном виде, с которым разработчик может работать, не задав ни одного вопроса.
Примеры охватывают самые частые виды багов: сценарий, который молча не срабатывает, проблему с вёрсткой на одном устройстве, неверные данные и плавающую ошибку. Если вам нужна пустая версия этого формата, скопируйте наш шаблон баг-репорта. Почему нужно каждое поле, объясняет гайд как написать баг-репорт.
Пример 1: сценарий, который молча не срабатывает
Пользователь сбрасывает пароль, но письмо так и не приходит.
Слабый вариант
Заголовок: Сброс пароля сломан
Сброс пароля не работает. Пробовал несколько раз. Почините срочно.
Этот репорт почти ничего не даёт разработчику. Какой аккаунт? Какое окружение? Форма показала ошибку или сообщила об успехе? «Пробовал несколько раз» на что-то намекает, но непонятно на что. А «срочно» без описания последствий никому не помогает расставить приоритеты.
Сильный вариант
Заголовок: Письмо для сброса пароля не отправляется аккаунтам, созданным через вход с Google
Окружение
- URL: https://app.example.com/forgot-password
- Chrome 154, macOS 26
- Аккаунт: [email protected] (создан через «Продолжить с Google»)
- Время: 2026-11-10 09:12 UTC
Шаги воспроизведения
1. Открыть /forgot-password, не входя в аккаунт.
2. Ввести [email protected] и нажать «Отправить ссылку для сброса».
Ожидаемый результат
Письмо для сброса приходит в течение нескольких минут.
Фактический результат
Страница показывает «Проверьте почту». Письмо не приходит (ждал 30 минут,
проверил спам). Network: POST /api/auth/reset вернул 200 с телом
{"sent": false, "reason": "no_password_identity"}.
Частота
Всегда для аккаунтов, созданных через Google (3 из 3). Для аккаунта
с email и паролем ([email protected]) работает.
Серьёзность
Значительный: пользователи, зарегистрированные через Google, не могут задать пароль.
Почему это работает
Автор сравнил два вида аккаунтов и нашёл закономерность: затронуты только аккаунты, созданные через вход с Google. Одно это сравнение сужает причину с «почта сломана» до конкретной ветки в коде. Он также открыл панель Network и скопировал тело ответа, из которого видно, что сервер знает, что ничего не отправил, а страница при этом сообщает об успехе. Это расхождение — второй баг, который стоит отметить. Точное время позволяет команде проверить логи почтового сервиса. Если вы ещё ни разу не смотрели сетевые запросы, наш гайд о том, как записать сетевой трафик в Chrome, показывает, как это делается.
Пример 2: баг вёрстки на одном устройстве
На маленьком экране телефона баннер закрывает кнопку, которую нужно нажать.
Слабый вариант
Заголовок: Не могу нажать «Сохранить» на мобильном
Кнопка сохранения не работает на моём телефоне.
«Не работает» может значить, что кнопка ничего не делает, показывает ошибку или до неё нельзя добраться. «Мой телефон» — это любое из тысяч сочетаний устройств и браузеров. Разработчик, который проверит на большом телефоне, скорее всего, не увидит проблемы и закроет тикет.
Сильный вариант
Заголовок: Баннер cookies закрывает кнопку «Сохранить» на странице профиля на маленьких экранах
Окружение
- URL: https://app.example.com/settings/profile
- Safari на iPhone SE (3-го поколения), iOS 26, портретная ориентация
- Область просмотра около 375 x 667
- Не воспроизводится на iPhone 15 Pro и на десктопе
Шаги воспроизведения
1. Открыть URL в приватной вкладке (чтобы появился баннер cookies).
2. Войти как [email protected].
3. Прокрутить форму профиля до конца.
Ожидаемый результат
Кнопка «Сохранить» видна и нажимается над баннером cookies.
Фактический результат
Баннер cookies (фиксированный, высотой около 180 px) закрывает кнопку «Сохранить».
Нажатие туда, где должна быть кнопка, открывает ссылку «Настройки» в баннере.
Если закрыть баннер, до «Сохранить» можно добраться.
Обходной путь
Сначала принять или закрыть баннер cookies.
Вложения
- Скриншот: profile-save-hidden-iphone-se.png (баннер обведён красным)
Почему это работает
Баги вёрстки зависят от размера экрана, поэтому точное устройство, ориентация и область просмотра — ключевые факты. Автор также проверил на других устройствах и записал, где бага нет, а это подсказывает разработчику смотреть на стили для маленьких экранов. Шаг с приватной вкладкой гарантирует, что баннер появится и разработчик увидит тот же экран. Обходной путь говорит поддержке, что отвечать пользователям уже сегодня, и снижает срочность так, что команда может оценить это сама.
Пример 3: неверные данные
Итог на дашборде не совпадает с цифрами в экспорте.
Слабый вариант
Заголовок: Неправильные цифры
Выручка на дашборде неправильная. В экспорте другие цифры.
Не знаю, где правильно, но что-то из этого сломано.
Автор заметил реальную проблему, но «неправильные цифры» заставляют разработчика выяснять, какие цифры, за какой период и насколько они расходятся. Багам в данных нужны точные значения, потому что размер расхождения часто и есть подсказка.
Сильный вариант
Заголовок: Выручка за октябрь на дашборде на $1,240 меньше, чем в экспорте CSV
Окружение
- URL: https://app.example.com/reports/revenue?period=2026-10
- Рабочее пространство: Acme Demo (ID 4821), часовой пояс America/Los_Angeles
- Chrome 154, Windows 11
Шаги воспроизведения
1. Открыть «Отчёты», затем «Выручка».
2. Выбрать октябрь 2026.
3. Записать итог на карточке.
4. Нажать «Экспорт CSV» и сложить значения в столбце «Сумма».
Ожидаемый результат
Итог на дашборде и сумма в CSV совпадают.
Фактический результат
Дашборд: $48,310.00. Сумма CSV: $49,550.00. Разница: $1,240.00.
Разница равна трём заказам, оформленным 31 октября после 17:00
по времени Лос-Анджелеса (ID 99812, 99815, 99820).
Частота
Всегда для октября. Итоги за сентябрь совпадают.
Заметки (догадка)
Похоже, дашборд группирует по дате в UTC, а экспорт по часовому
поясу рабочего пространства.
Почему это работает
В репорте есть оба числа, разница и заказы, из которых она складывается. Последний шаг занял у автора несколько минут, а разработчику сэкономит гораздо больше. Догадка о часовых поясах явно помечена как догадка и отделена от наблюдений. Упоминание, что сентябрь сходится, показывает, что баг связан с конкретными данными, а не со всем отчётом.
Пример 4: плавающая ошибка
Загрузки иногда падают, и никто не может сказать почему.
Слабый вариант
Заголовок: Загрузка иногда не работает
Иногда загрузка падает с ошибкой. Случается рандомно.
«Рандомно» обычно значит «по причине, которую пока никто не нашёл». Без текста ошибки, данных о файле и подсчётов расследовать нечего.
Сильный вариант
Заголовок: Загрузка файлов больше 10 МБ падает с «Upload failed (413)»
Окружение
- URL: https://app.example.com/projects/218/files
- Chrome 154 и Firefox 158, Windows 11, офисная сеть
Шаги воспроизведения
1. Открыть проект, затем вкладку «Файлы».
2. Нажать «Загрузить» и выбрать PDF больше 10 МБ
(проверено: 10,4 МБ, 12 МБ, 25 МБ).
Ожидаемый результат
Файл загружается и появляется в списке.
Фактический результат
Индикатор прогресса доходит примерно до 90 процентов, затем «Upload failed (413)».
Network: POST /api/files вернул 413 Request Entity Too Large,
тело ответа — HTML-страница ошибки, а не JSON.
Консоль: Uncaught (in promise) SyntaxError: Unexpected token '<'
Частота
Всегда для файлов больше 10 МБ (6 из 6). Ни разу для файлов меньше 9 МБ (0 из 8).
Вложения
- Запись экрана неудачной загрузки (40 секунд)
- Очищенный HAR файл одной попытки
Почему это работает
«Рандомный» баг оказался зависящим от размера файла, и автор доказал это подсчётами по обе стороны порога. Статус 413 и HTML-ответ указывают на ограничение размера где-то перед приложением, а ошибка в консоли объясняет, почему пользователь увидел общее сообщение: приложение пыталось прочитать HTML-страницу как JSON. HAR файл очищен, потому что HAR файлы содержат cookies и токены; очистка HAR удаляет их прямо в вашем браузере.
Как превратить слабый репорт в сильный
Если вы разбираете баги для команды поддержки или QA, вам будет приходить много репортов вроде слабых вариантов выше. Переписать их быстрее, чем отправлять обратно, если вы получите ответы на пять вопросов:
- Что именно вы увидели? Попросите текст ошибки или скриншот, а не её описание.
- Где вы были? URL или название экрана и аккаунт.
- Что вы сделали прямо перед этим? Двух-трёх последних действий обычно достаточно, чтобы начать воспроизводить.
- Это происходит каждый раз? Если нет, то примерно как часто и делает ли что-то это более вероятным?
- Что вы пытались сделать? Это подскажет ожидаемый результат и реальные последствия.
Задайте все пять вопросов в одном сообщении. Авторы репортов, особенно клиенты, охотно отвечают на один круг вопросов; после трёх кругов они сдаются. Получив ответы, попробуйте воспроизвести баг сами и добавьте то, что узнали, как сравнения в примерах выше. Воспроизведённый баг с вашими уликами проходит очередь гораздо быстрее, чем пересланное письмо.
Что общего у хороших примеров
- Заголовки описывают симптом и условие, а не только функцию.
- Известная отправная точка и точные данные, которые использовались.
- Точные числа и текст ошибки, никогда не «неправильно» или «какая-то ошибка».
- Сравнение: другой аккаунт, устройство, месяц или размер файла, где всё работает.
- Приложенные улики, из которых удалены секреты.
- Догадки помечены как догадки.
Как собрать улики быстрее
Большинству сильных вариантов выше понадобились консоль и панель Network. Midge, бесплатное расширение для Chrome, собирает и то и другое, пока вы записываете экран или делаете скриншот. В каждой записи есть логи консоли, сетевые запросы, действия пользователя и данные об устройстве. Пароли, номера карт, токены и cookies удаляются прямо в браузере, прежде чем что-либо покинет ваше устройство. Заголовок, шаги и ожидаемый результат вы по-прежнему пишете сами, а технические детали прикладываются автоматически.
Похожие гайды
Частые вопросы
Как выглядит хороший пример баг-репорта?
В нём есть конкретный заголовок, окружение, пронумерованные шаги от известной отправной точки, ожидаемый и фактический результат с точным текстом ошибки, частота и улики, например скриншот, ошибка консоли или упавший запрос.
Какая ошибка в баг-репортах самая частая?
Отсутствующие или расплывчатые шаги воспроизведения. Без них разработчику приходится угадывать, как возник баг, и тикет часто закрывают с пометкой «не воспроизводится».
Нужен ли в баг-репорте скриншот?
Да, если проблему видно. Добавьте и текст ошибки, потому что текст можно искать и копировать, а если баг связан с несколькими шагами или таймингом, приложите короткую запись.
Где взять пустую версию этого формата?
Воспользуйтесь шаблоном баг-репорта в документации Midge, который можно скопировать и вставить. В нём те же поля, что и в хороших примерах на этой странице.