テストは通ったのにグラフが崩れた原因と直し方4ステップ
こんにちは、時短ギア管理人の清光です。
コードは書けない現役の営業ですが、AIと一緒に、現場が毎日使う業務システムを1年以上つくり続けてきました。
「テストはちゃんと通ったのに、本番で動かしたら画面がおかしい」——そんな経験はありませんか？
私も自作のグラフ機能で、まさにこれにやられました。しかもテストは最後まで緑（成功）のままでした。
この記事では、テストだけでは絶対に見つからない”表示の崩れ”の正体と、本番データで確認する具体的な手順を紹介します。
グラフに、必ず空っぽの棒が2本立っていた
自作の業務ダッシュボードに、月ごとの案件推移を見るグラフを作ったときの話です。
設計もテストも問題なく通り、いつも通り本番に反映しました。
ところが実際のデータを入れて画面を開いたら、毎回決まって同じ2本の棒だけが空っぽでした。
グラフに並ぶ月（棒の1本ずつ）は、案件が持っている「予定日」をもとに自動で作っていました。
問題は、その予定日の中に、まだ日程が確定していない先の月まで含まれていたことです。
確定していない予定日だけで生まれた月は、実績が入りようがなく、構造的に必ず0のままになります。
なぜテストは通ったのに、本番だけ崩れたのか
テストで使っていたデータには、たまたま未確定の予定日が含まれていませんでした。
だから0という表示はテストの中では単純に「正しい値」で、エラーにはなりようがなかったのです。
実は毎朝の自動投稿でも、似た種類の崩れ方に遭遇したことがあります。
そのときの話はこちらの記事にまとめています。
共通しているのは「作った当時のテストは通ってしまい、扱うデータが育ってから急に壊れる」という点です。
見た目の崩れは、テストというしくみだけでは絶対に守り切れません。
グラフの”空っぽの棒”を直す4ステップ
実際にやった直し方を、そのまま真似できる手順にしました。
- まずテストが何を検証しているかを見直す（0という表示自体が「正しい」判定になっていないか確認する）
- 実際のデータを画面に入れて、自分の目で1回眺める（テストが緑になったことを完成の合図にしない）
- グラフの区切り（今回なら「月」）が何をもとに作られているかを洗い出す
- その区切りの元データを、確定した実績だけに絞り直す（未確定の予定はいったん除外する）
直したあとも、必ず実データでもう一度画面を確認します。
ここを飛ばすと、また別の理由で空っぽの棒が復活することがあります。
テストで守れる範囲と、目で見ないと守れない範囲
| チェックの種類 | 見つかる不具合 |
|---|---|
| 自動テスト | 計算が間違っている・エラーで止まる |
| 実データを目で見る | 計算は合っているのに、見た目として不自然 |
Q. テストの数をもっと増やせば防げたのでは？
増やしても防げなかったと思います。
0という表示自体は計算として間違っていないので、テストは正しく「合格」を返し続けます。
Q. 本番のデータを直接見て確認するのは危なくないですか？
読むだけの確認なら基本的に安全です。
今回のような表示の確認は、書き込みを一切しなくても目で見れば十分に判断できます。
Q. こういう”見た目だけ崩れる”バグは、グラフ以外でも起きますか？
起きます。一覧の並び順や、集計の母集団を変えたときによく出ます。
共通点は「区切りや母集団の元データを何にしているか」を見落としていることです。
まとめ：見た目の崩れは、目で見るまで終わっていない
- テストが緑でも、見た目の崩れは検知できないことがある
- グラフや一覧の”区切り”を何から作っているかを、まず確認する
- 直した後も、実データを画面で1回見るまでは完成にしない
この1回の確認を習慣にするだけで、本番で気づいて焦る時間がまるごと減ります。
今日はここまで。この記事が、あなたの時間を少しでも価値に変えるお手伝いになれば嬉しいです。
それでは、また次の時短ハックでお会いしましょう。
自作している業務システムのことや、お仕事のご依頼はお問い合わせからどうぞ。
