Docker failed to compute cache keyの直し方

failed to compute cache key: failed to calculate checksum of ref ...: "/target/app.jar": not found は、Dockerfile の COPY で指定したファイルが、ビルドに渡したフォルダ（ビルドコンテキスト）の中に見つからないときのエラーです。 「キャッシュ」という言葉が入っていますが、キャッシュを消しても直りません。

エラー文の最後の "/target/app.jar" が、見つからなかったパスです。先頭の / は、ビルドコンテキストのフォルダを表します。

確認環境：Docker Engine 29.4.3（BuildKit）、buildx 0.33.0 で再現しました（確認日 2026年10月11日）。

ビルドコンテキスト（docker build . の「.」）とは

proj/                      ← docker build . をここで実行すると、proj がビルドコンテキスト
├── Dockerfile
├── app/
│   ├── config.txt
│   └── target/
│       └── app.jar
└── docker/
    └── Dockerfile

docker build . の最後の . は「このフォルダの中身をビルドに渡す」という意味です。 Docker の公式ドキュメントでは、ビルドコンテキストは「ビルドがアクセスできるファイルの集まり」で、COPY・ADD はその中のファイルを参照できると説明されています。COPY のパスは、Dockerfile の場所ではなく、ビルドコンテキストから見たパスです。

再現① COPY のパスが違う

FROM bb:1
COPY target/app.jar /app.jar

Dockerfile:2
--------------------
   1 |     FROM bb:1
   2 | >>> COPY target/app.jar /app.jar
--------------------
ERROR: failed to build: failed to solve: failed to compute cache key: failed to calculate checksum of ref 0hy7s7o90zcvnd5j0tzlnl263::wkap9la13fefta7t17snv7wdc: "/target/app.jar": not found

proj から見ると、jar は app/target/app.jar にあります。 COPY app/target/app.jar /app.jar に直すと、ビルドが通りました。>>> の付いた行が、失敗した COPY です。

再現② .dockerignore で除外している

# .dockerignore
target
**/target

ERROR: ... failed to compute cache key: failed to calculate checksum of ref ...: "/app/target/app.jar": not found

ファイルは存在するのに、.dockerignore で除外されているため、ビルドには渡されません。 ビルドを速くするために target・build・node_modules を除外し、その中のファイルを COPY しようとして起きます。

! を付けた行は、除外の例外になりました。 「すべて除外して、必要なものだけ ! で入れる」書き方では、入れ忘れたファイルが not found になります。

再現③ Dockerfile が別のフォルダにある

# proj/docker/Dockerfile
FROM bb:1
COPY app/target/app.jar /app.jar

-f は Dockerfile の場所、最後の . はビルドコンテキストです。 2つは別々に指定できます。

COPY ../ では、外のファイルを取れない

# proj/docker/Dockerfile2（proj/docker でビルド）
COPY ../app/target/app.jar /app.jar

ERROR: ... "/app/target/app.jar": not found

確認環境では、../ は無視され、ビルドコンテキストの中の /app/target/app.jar として探されました。 ビルドコンテキストの外のファイルは使えないので、上のように、ビルドコンテキストを上のフォルダにします。

再現④ マルチステージの COPY --from

FROM bb:1 AS build
RUN mkdir -p /work/out && echo x > /work/out/app.jar
FROM bb:1
COPY --from=build /work/target/app.jar /app.jar

ステージ名を間違えると、Docker Hub の builder というイメージを探しに行きました（確認環境では取得できずエラー）。メッセージの最後の (did you mean build?) が、正しいステージ名の手がかりです。

そのほかの形

Linux 上の Docker では、大文字小文字が区別されます。 Windows・Mac で作ったフォルダ名の大文字小文字が、Dockerfile と違っていないかを確かめます。

ビルドに渡されたファイルを確かめる

# Dockerfile.ls（確認用）
FROM bb:1
COPY . /ctx
RUN find /ctx -type f | sort

docker build --progress=plain --no-cache -f Dockerfile.ls .

#7 0.173 /ctx/app/config.txt
#7 0.173 /ctx/app/target/app.jar
#7 0.173 /ctx/docker/Dockerfile

ビルドコンテキストの中身（.dockerignore で除外されたものを除く）が一覧で表示されます。 探しているファイルがこの一覧に無ければ、パスかビルドコンテキストか .dockerignore が原因です。

確認の手順（チェックリスト）

6番のように、そもそも jar がまだ作られていない（ビルドを忘れた）こともあります。

よくある質問

Q. docker compose でビルドするときはどうなりますか。 A. compose.yaml の build.context がビルドコンテキスト、build.dockerfile が Dockerfile の場所です。Docker Compose v5.1.3 で、context: . と dockerfile: docker/Dockerfile を指定するとビルドが通り、context: docker にすると同じ not found になりました。Compose の書き方は、既存の記事「Docker Composeの使い方｜compose.yamlの書き方と開発環境の作り方」で扱っています。

まとめ

• COPY したファイルが、ビルドコンテキストの中に無いエラー。キャッシュは関係ない
• COPY のパスは、Dockerfile の場所ではなく、ビルドコンテキスト（docker build . の .）から見たパス
• .dockerignore で除外したファイルは、存在しても not found
• 別の場所の Dockerfile は docker build -f docker/Dockerfile .
• COPY ../ は外に出られない。ステージ名の間違いは did you mean が手がかり

参考・出典

確認日はいずれも 2026年10月11日です。

• Docker Docs「Build context」：https://docs.docker.com/build/concepts/context/

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。