
テストが2441個あってカバレッジ9.5% ── 全体の数字を諦め、変更した行だけを見る品質ゲートに切り替えた
はじめに テストカバレッジのゲートを3つのサイトに入れた記録です。 同じドメインで連携する3つのNext.jsサイト(利用者向け / 提供者向け / 社内管理画面)を運用しています。カバレッジを測る設定は、利用者向けでは5月、社内管理画面では6月から入っていました。ただし閾値もCI連携もなく「測れるが誰も追っていない」状態でした。提供者向けでは、計測とゲートを同じ日に入れています。 半期の計画でカバレッジ向上に取り組むことが決まり、まず現状を測るところから始めました。 実測したところ、社内管理画面は テストが2441個あって、カバレッジ9.5% でした。この数字を前にして「まず全体80%を目指そう」と言っても、誰も動きません。 そこで全体の数字を目標にするのをやめ、「変更した行」だけを見るゲートに切り替えました。 この記事で得られること テスト数とカバレッジが比例しない理由と、計測対象の決め方 全体のカバレッジをゲートにすると何がうまくいかないか(未使用コードを消すと率が下がる問題) 変更した行のカバレッジをゲートにする設計と、全体の数字をこれ以上下がったら止める「下限」として使う考え方 外部のカバレッジサービスを使わず、CI内で完結させる実装 計測から外すファイルを決めないと数字が実態とずれる話 既存コードの多いリポジトリで、止めずにゲートを入れる段階の踏み方 1. 3サイトのカバレッジ実測値 まず現状を測りました。CIと同じ環境変数で、全テストが通る状態での実測値です。 Lines Statements Functions Branches テスト規模 社内管理画面 9.5% 9.5% 7.1% 8.4% 176ファイル / 2441テスト 利用者向け 26.8% 26.3% 20.0% 24.2% 70ファイル / 908テスト 提供者向け 34.3% 34.5% 28.9% 32.1% 45ファイル / 625テスト 目を引くのは社内管理画面です。テストが一番多いのに、カバレッジが一番低くなっています。 テストの数とカバレッジが比例しない理由 原因はテストの置き場所が偏っていたことでした。導入時のコミットで測り直し、テストと計測対象の行を突き合わせると、こうなっていました。 1 2 3 4 5 6 7 8 2441テストの内訳 入力チェックの定義(zodのスキーマ)のテスト 1358 自動生成されたAPIクライアントのテスト 195(自動生成コードは計測対象外) その他 888 計測対象 18981行の内訳 入力チェックの定義 143行 74.1%がテストで実行された 画面のコンポーネント 13910行 4.4%がテストで実行された テストの半分以上が入力チェックの定義に集まっていました。定義は1つが数行にまとまるので、計測対象の行数では143行、全体の1%もありません。一方、計測対象の7割以上を占める画面のコンポーネントは、ほとんどテストで実行されていませんでした。 ...


