本文へスキップ

バグ報告の例|良い書き方と悪い書き方を並べて比較

現実的なバグ報告の例を 4 つ、弱いレポートと改善したレポートの両方で紹介。すぐ対応できるバグ報告にするためのポイントも解説します。

良いバグ報告の例には、いつも同じ要素がそろっています。具体的なタイトル、環境、既知の開始地点からの番号付きの再現手順、正確なエラーメッセージを含む期待される結果と実際の結果、発生頻度、そして証拠です。以下では、現実にありそうな 4 つのバグを、それぞれ 2 回書いています。最初はよくある報告のされ方で、次は開発者が 1 つも質問せずに対応できるように書き直したものです。

例は、最もよくある種類のバグを扱っています。何も言わずに失敗するフロー、特定のデバイスでのレイアウトの問題、間違ったデータ、そしてときどきしか起きないエラーです。空欄の書式が欲しい場合は、バグ報告テンプレートをコピーしてください。各項目を書く理由については、「バグ報告の書き方」をご覧ください。

例 1:何も言わずに失敗するフロー

ユーザーがパスワードをリセットしたのに、メールが届きません。

弱いレポート

タイトル:パスワードリセットが壊れている

パスワードリセットが動きません。何度か試しました。至急直してください。

このレポートでは、開発者にはほとんど何もわかりません。どのアカウントなのか。どの環境なのか。フォームにエラーが出たのか、それとも成功したと表示されたのか。「何度か試しました」は何かを示唆していますが、それが何かはわかりません。そして、影響の説明がない「至急」は、優先順位を決める助けになりません。

改善したレポート

タイトル:Google ログインで作成したアカウントにパスワードリセットのメールが送信されない

環境
- URL:https://app.example.com/forgot-password
- Chrome 154、macOS 26
- アカウント:[email protected](「Continue with Google」で作成)
- 日時:2026-11-10 09:12 UTC

再現手順
1. サインアウトした状態で /forgot-password に移動する。
2. [email protected] と入力し、「Send reset link」をクリックする。

期待される結果
数分以内にリセット用のメールが届く。

実際の結果
ページには「Check your inbox」と表示される。メールは届かない(30 分待ち、
迷惑メールフォルダも確認済み)。ネットワーク:POST /api/auth/reset が 200 を返し、
ボディは {"sent": false, "reason": "no_password_identity"}。

発生頻度
Google で作成したアカウントでは毎回(3 回中 3 回)。メールアドレスとパスワードの
アカウント([email protected])では正常に動作する。

重大度
重大:Google で登録したユーザーがパスワードを設定できない。

ここが良い

報告者は 2 種類のアカウントを比べ、パターンを見つけました。影響を受けるのは Google ログインで作成したアカウントだけです。この 1 つの比較で、原因の候補が「メールが壊れている」から、コード内の特定の分岐にまで絞り込まれます。報告者はネットワークパネルも開いてレスポンスボディをコピーしており、ページが成功を表示している一方で、サーバーは何も送っていないことを把握しているとわかります。この食い違いは、別のバグとして記録する価値があります。正確な時刻があれば、チームはメール配信サービスのログを確認できます。ネットワークリクエストを見たことがない場合は、「Chrome でネットワーク通信をキャプチャする方法」で手順を説明しています。

例 2:特定のデバイスでのレイアウトのバグ

小さなスマートフォンの画面で、ユーザーが押す必要のあるボタンをバナーが覆っています。

弱いレポート

タイトル:スマホで保存をクリックできない

スマホで保存ボタンが動きません。

「動かない」は、ボタンを押しても何も起きないのか、エラーが出るのか、ボタンに手が届かないのか、どれとも取れます。「スマホ」は、何千もあるデバイスとブラウザのどれでもありえます。大きなスマートフォンでテストした開発者は、おそらく問題を確認できず、チケットを閉じてしまうでしょう。

改善したレポート

タイトル:小さな画面でプロフィールページの Save ボタンを Cookie バナーが覆っている

環境
- URL:https://app.example.com/settings/profile
- iPhone SE(第 3 世代)の Safari、iOS 26、縦向き
- ビューポート 約 375 x 667
- iPhone 15 Pro とデスクトップでは再現しない

再現手順
1. プライベートタブで URL を開く(Cookie バナーが表示されるように)。
2. [email protected] でサインインする。
3. プロフィールフォームの一番下までスクロールする。

期待される結果
Save ボタンが Cookie バナーの上に表示され、タップできる。

実際の結果
Cookie バナー(固定表示、高さ約 180 px)が Save ボタンを覆っている。
ボタンがあるはずの場所をタップすると、バナーの「Settings」リンクが開く。
バナーを閉じると Save を押せるようになる。

回避策
先に Cookie バナーを承認するか閉じる。

添付ファイル
- スクリーンショット:profile-save-hidden-iphone-se.png(バナーを赤枠で囲んである)

ここが良い

レイアウトのバグは画面サイズに左右されるので、正確なデバイス、向き、ビューポートが重要な事実になります。報告者はほかのデバイスでもテストし、起きない環境を書き留めています。これで開発者は、小さな画面向けのスタイルを調べればよいとわかります。プライベートタブの手順でバナーが確実に表示されるので、開発者は同じ画面を見られます。回避策は、サポートが今日ユーザーに何を伝えればよいかを示し、チームが自分で判断できる形で緊急度を下げてくれます。

例 3:間違ったデータ

ダッシュボードの合計が、エクスポートした数値と一致しません。

弱いレポート

タイトル:数字が間違っている

ダッシュボードの売上が間違っています。エクスポートと違う数字が出ます。
どちらが正しいかわかりませんが、どちらかが壊れています。

報告者は実際の問題に気づいていますが、「数字が間違っている」では、開発者はどの数字が、どの期間で、どれだけずれているのかを探し回ることになります。データのバグには正確な値が必要です。差の大きさそのものが手がかりになることが多いからです。

改善したレポート

タイトル:10 月のダッシュボードの売上が CSV エクスポートより $1,240 少ない

環境
- URL:https://app.example.com/reports/revenue?period=2026-10
- ワークスペース:Acme Demo(ID 4821)、タイムゾーンは America/Los_Angeles
- Chrome 154、Windows 11

再現手順
1. 「Reports」、「Revenue」の順に開く。
2. 2026 年 10 月を選ぶ。
3. カードに表示された合計をメモする。
4. 「Export CSV」をクリックし、Amount 列を合計する。

期待される結果
ダッシュボードの合計と CSV の合計が一致する。

実際の結果
ダッシュボード:$48,310.00。CSV の合計:$49,550.00。差:$1,240.00。
差は、ロサンゼルス時間の 10 月 31 日 17:00 以降に入った 3 件の注文
(ID 99812、99815、99820)の合計と一致する。

発生頻度
10 月は毎回。9 月の合計は一致する。

メモ(推測)
ダッシュボードは UTC の日付で集計し、エクスポートはワークスペースの
タイムゾーンで集計しているように見える。

ここが良い

このレポートには、両方の数値、その差、そして差を構成する注文が書かれています。最後の作業には報告者が数分かけましたが、開発者にとってはそれよりずっと長い時間の節約になります。タイムゾーンについての推測ははっきりと推測だと明記され、観察とは分けて書かれています。9 月は一致すると書いてあることで、バグがレポート全体ではなく特定のデータに結びついていることがわかります。

例 4:ときどき起きるエラー

アップロードがときどき失敗し、誰にも理由がわかりません。

弱いレポート

タイトル:アップロードがときどき失敗する

ときどきアップロードがエラーで失敗します。ランダムに起きます。

「ランダム」とは、たいてい「まだ誰も理由を見つけていない」という意味です。エラーメッセージ、ファイルの詳細、回数がなければ、調べようがありません。

改善したレポート

タイトル:10 MB を超えるファイルのアップロードが「Upload failed (413)」で失敗する

環境
- URL:https://app.example.com/projects/218/files
- Chrome 154 と Firefox 158、Windows 11、社内ネットワーク

再現手順
1. プロジェクトを開き、「Files」タブを開く。
2. 「Upload」をクリックし、10 MB を超える PDF を選ぶ
   (試したサイズ:10.4 MB、12 MB、25 MB)。

期待される結果
ファイルがアップロードされ、一覧に表示される。

実際の結果
プログレスバーが約 90% まで進んだあと、「Upload failed (413)」と表示される。
ネットワーク:POST /api/files が 413 Request Entity Too Large を返し、
レスポンスボディは JSON ではなく HTML のエラーページ。
コンソール:Uncaught (in promise) SyntaxError: Unexpected token '<'

発生頻度
10 MB を超えるファイルでは毎回(6 回中 6 回)。9 MB 未満のファイルでは一度もない(8 回中 0 回)。

添付ファイル
- アップロードが失敗する様子の画面録画(40 秒)
- 1 回分のサニタイズ済み HAR ファイル

ここが良い

「ランダム」なバグは、実はファイルサイズに依存していました。報告者は、しきい値の両側での回数を示してそれを証明しています。413 のステータスと HTML のレスポンスは、アプリの手前のどこかにサイズ制限があることを示しています。そしてコンソールのエラーは、ユーザーに一般的なメッセージしか表示されなかった理由を説明しています。アプリが HTML ページを JSON として読もうとしたのです。HAR ファイルには Cookie やトークンが含まれるので、サニタイズしてあります。HAR サニタイザーを使えば、ブラウザ内でそれらを取り除けます。

弱いレポートを良いレポートに書き直す

サポートや QA チームでバグのトリアージをしていると、上の弱いレポートのような報告をたくさん受け取ります。差し戻すより自分で書き直したほうが早く済みます。ただし、次の 5 つの質問に答えてもらえることが条件です。

  1. 具体的に何が見えましたか? 説明ではなく、エラーメッセージそのものかスクリーンショットをもらいましょう。
  2. どこにいましたか? URL か画面の名前、そしてアカウントです。
  3. 直前に何をしましたか? 再現を始めるには、たいてい最後の 2〜3 個の操作がわかれば十分です。
  4. 毎回起きますか? そうでなければ、だいたいどのくらいの頻度か、起きやすくなる条件がありそうかを聞きます。
  5. 何をしようとしていましたか? これで、期待される結果と実際の影響がわかります。

5 つの質問は 1 通のメッセージでまとめて聞きましょう。報告者、特に顧客は、1 回の質問には快く答えてくれますが、3 往復になるとあきらめてしまいます。答えがそろったら、自分でバグを再現してみて、わかったことを書き加えます。上の例のような比較がそれにあたります。自分の証拠を添えて再現済みのバグは、転送されただけのメールよりずっと早く処理されます。

良い例に共通すること

  • 機能名だけでなく、症状と条件を説明するタイトル。
  • 既知の開始地点と、使った正確なデータ。
  • 「間違っている」「エラーが出る」ではなく、正確な数値とエラーメッセージ。
  • 比較:正常に動く別のアカウント、デバイス、月、ファイルサイズ。
  • 機密情報を取り除いたうえで添付された証拠。
  • 推測であることが明記された推測。

証拠をもっと手早く集める

上の改善したレポートのほとんどは、コンソールとネットワークパネルの情報を必要としていました。無料の Chrome 拡張機能 Midge は、画面を録画するかスクリーンショットを撮る間に、その両方を記録します。すべての録画に、コンソールログ、ネットワークリクエスト、ユーザー操作、デバイス情報が含まれます。パスワード、カード番号、トークン、Cookie は、デバイスから送信される前にブラウザ内で伏せられます。タイトル、手順、期待される結果はあなたが書きますが、技術的な詳細は自動で添付されます。

関連ガイド

よくある質問

良いバグ報告の例とはどのようなものですか?

具体的なタイトル、環境、既知の開始地点からの番号付きの手順、正確なエラーメッセージを含む期待される結果と実際の結果、発生頻度、そしてスクリーンショット、コンソールのエラー、失敗したリクエストなどの証拠がそろったものです。

バグ報告で最もよくあるミスは何ですか?

再現手順がない、またはあいまいなことです。手順がないと、開発者はバグがどう起きたのかを推測するしかなく、「再現できず」としてチケットが閉じられることがよくあります。

バグ報告にスクリーンショットは必要ですか?

問題が目に見えるものなら、必要です。エラーメッセージもテキストで添えましょう。テキストなら検索もコピーもできます。バグが複数の手順やタイミングに関わる場合は、短い録画も加えましょう。

この書式の空欄版はどこで手に入りますか?

Midge のドキュメントにある、コピーしてそのまま使えるバグ報告テンプレートを使ってください。このページの良い例と同じ項目がそろっています。