できない.dev

Go の go test がキャッシュで再実行されない

コード未変更で go test を再実行すると (cached) と表示されてテストが走らない場合、-count=1 を付けるか go clean -testcache でキャッシュを破棄する。

公開: 更新:

症状できない
go test ./...
ok  	example.com/cachedemo	0.002s
解決後できた · exit 0
go test ./...
ok  	example.com/cachedemo	(cached)

2026-09-07 に golang:1.23(Go 1.23.12) で実際に打って取った出力。検証環境の詳細

要約

go test ./... を 2 回目に流したら ok ... (cached) と出てテストが走らない、というのは Go のテストキャッシュが効いている状態だ。
意図的に再実行するなら -count=1 を付けるのが公式推奨のイディオムだ。

go test -count=1 ./...

キャッシュ自体を全部消したいなら次のコマンドを使う。

go clean -testcache

実行例

ソースを変えずに go test を続けて流すと、2 回目だけ実行時間の代わりに (cached) と表示される。
-count=1 を付けた場合と go clean -testcache の後は、いずれも秒数の表示に戻っている。

$ go test ./...
ok  	example.com/cachedemo	0.002s
$ echo $?
0
$ go test ./...
ok  	example.com/cachedemo	(cached)
$ echo $?
0
$ go test -count=1 ./...
ok  	example.com/cachedemo	0.001s
$ echo $?
0
$ go clean -testcache
$ go test ./...
ok  	example.com/cachedemo	0.002s
$ echo $?
0

— 2026-09-07 時点の出力

検証環境Python 3.11.2 / Git 2.39.5 / Go 1.23.12 / 2026-09-07 検証
検証日
実行環境
golang:1.23 Debian GNU/Linux 12 (bookworm)
バージョン
  • Python 3.11.2
  • Git 2.39.5
  • Go 1.23.12

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. その場で再実行したいだけなら -count=1

go test -count=1 ./pkg/foo

-count は本来「テストを N 回ループ実行する」フラグだが、-count=1 を指定するとキャッシュをバイパスする副作用があるのが公式の推奨イディオムだ(Testing flags(新しいタブで開く))。

2. キャッシュ自体を消したい

go clean -testcache

$GOCACHE 配下のテスト結果を全削除する。
CI のキャッシュレイヤと組み合わせている場合はこちらが確実だ。

3. CI ではキャッシュ無効化をデフォルトに

CI で go test を流すなら、最初から -count=1 を付けておくと「キャッシュで実行されない」事故を防げる。

- run: go test -count=1 ./...

go test は -cpu / -tags / -race などの引数が変わると、別キーとして扱う。
そのため -race を付けたり外したりすると、意図せず再実行される。

よくある原因

  1. 入力が変わっていない。
    Go は「テストバイナリ・対象パッケージのソース・環境変数・コマンドライン引数」が同じなら結果をキャッシュする。
    コードを 1 byte も変えずに再実行すれば、当然 (cached) になる。
  2. 外部依存(DB・API・時刻)の変化は、Go の検出対象に入らない。
    テスト関数の中で外部リソースを呼んでいても、Go から見ればソースが同じなので「同じ結果になる」とみなされる。
    フレーキーテストを調べるときに困るのは、この挙動である。
  3. CI で 2 回叩いた。
    パイプラインで go test を 2 段階に分けると、2 段目がキャッシュにヒットして実質スキップになる。