1. 導入: なぜ -failfast が重要なのか
Goで大規模なプロジェクトを開発していると、テストスイートの実行時間が数分に及ぶことは珍しくありません。通常、`go test ./…` を実行すると、一部のテストが失敗しても全てのテストが完了するまで待機する必要があります。CI/CDパイプラインやローカルでの修正サイクルにおいて、この「待ち時間」は開発のボトルネックとなります。
`go test -failfast` フラグは、最初のテスト失敗を検知した瞬間にテストスイートを中断させます。これにより、フィードバックループを最短化し、デバッグ効率を劇的に向上させることができます。
2. 基礎知識: テスト実行の仕組み
Goのテストツールは、デフォルトではパッケージ内の全テストケースを走査し、結果を最後にまとめて出力します。これは、全てのテストが独立して実行されることを保証し、網羅的なレポートを作成するためには有用です。
しかし、開発中の「修正→テスト→修正」というイテレーションにおいては、全てのテスト結果を待つ必要がないケースが多々あります。`failfast` オプションは、実行エンジンに対して「失敗が発生した時点でプロセスを終了させる」というシグナルを送る役割を果たします。
3. 実装/解決策: 活用手順
実務では、単にコマンドを叩くだけでなく、MakefileやCI設定と組み合わせるのが定石です。
基本コマンド:
go test -v -failfast ./…
このコマンドを実行すると、最初の失敗が発生した時点でテストプロセスが即時停止し、終了コードが非ゼロ（失敗）で返されます。これにより、GitHub ActionsなどのCIツール上でも、即座にビルドを失敗させて開発者に通知を送ることが可能です。
4. サンプルプログラム: テストの失敗をシミュレートする
以下のコードは、あえてテストを失敗させることで `failfast` の効果を実感するための例です。
// calculator_test.go
package main
import (
“testing”
)
// 正常に終了するテスト
func TestSuccess(t testing.T) {
t.Log(“このテストは成功します”)
}
// 意図的に失敗させるテスト
func TestFailure(t testing.T) {
t.Error(“ここで失敗が発生します”)
}
// failfast使用時にスキップされるテスト
func TestWillBeSkipped(t testing.T) {
t.Log(“failfastが有効な場合、このテストは実行されません”)
}
// 実行方法:
// go test -failfast .
// 結果: TestFailure で停止し、TestWillBeSkipped は実行されません。
5. 応用・注意点: 現場での運用ルール
注意点1: 並列実行との相性
`t.Parallel()` を使用してテストを並列実行している場合、`failfast` がトリガーされた瞬間に稼働中の他のテストが強制終了されます。この際、リソースのクリーンアップ（DBの接続解除や一時ファイルの削除）が中途半端になる可能性があるため、テストのセットアップ・ティアダウン処理は適切に実装してください。
注意点2: CI環境での使い分け
ローカル開発では `-failfast` を常用し、素早いフィードバックを得ることを推奨します。一方で、CIの「最終結果」を確認するステージでは、全ての失敗箇所を特定するために `-failfast` を外す運用が一般的です。全ての失敗を一度に確認することで、複数のバグを一括で修正できるためです。
まとめ
`go test -failfast` は、開発者の「待ち時間」をコストとして捉えるエンジニアにとって不可欠なツールです。適切なフェーズで使い分け、より高速でストレスのない開発体験を実現しましょう。
コメント