Docker中RUN缓存挂载后COPY操作失效问题排查

这是Docker BuildKit缓存挂载的特性导致的，不是写法错误，但需要调整缓存策略才能兼顾编译加速和产物复制。

问题根源 #

当你用--mount=type=cache挂载/home/root/workspace/target时，这个目录是BuildKit提供的临时缓存卷——它只在当前RUN命令的执行过程中存在，不会被写入到build阶段的镜像层里。

也就是说，cargo build确实把产物编译到了缓存卷的target/release里，但build阶段的镜像本身并没有这个目录的内容。后续example-service阶段尝试从build镜像复制该路径时，自然会提示找不到文件。而注释掉target缓存后，cargo build会把产物直接写入到镜像的文件系统中，所以复制正常。

解决方案 #

方案1：保留缓存，同时把产物写入镜像层（推荐）

修改build阶段的RUN命令，在编译完成后把需要的产物复制到镜像的固定目录（比如你已经用到的/usr/local/bin），后续阶段直接从这个目录复制：

# build阶段
FROM rust:1.71.0-slim-bookworm AS build
WORKDIR /home/root/workspace
# 安装编译依赖（根据你的实际需求调整）
RUN apt-get update && apt-get install -y --no-install-recommends build-essential
# 挂载缓存加速编译，同时将产物复制到镜像层的/usr/local/bin
RUN --mount=type=cache,target=/usr/local/cargo/registry \
    --mount=type=cache,target=/home/root/workspace/target \
    cargo build --release --all-features && \
    cp target/release/example-service /usr/local/bin/

# example-service阶段
FROM debian:bookworm-slim
COPY --from=build /usr/local/bin/example-service /usr/local/bin/
# 后续的启动命令、用户配置等...

这种方式既利用了缓存加速编译，又确保产物被保留在build镜像中，后续阶段可以稳定复制。

方案2：调整缓存挂载参数（可选，可靠性稍差）

如果你坚持要从target目录复制，可以先在build镜像中创建target/release目录，再给缓存挂载加上sharing=locked参数，强制编译产物写入镜像层：

# build阶段
FROM rust:1.71.0-slim-bookworm AS build
WORKDIR /home/root/workspace
RUN apt-get update && apt-get install -y --no-install-recommends build-essential
# 先创建target目录，确保镜像层存在该路径
RUN mkdir -p target/release
# 挂载缓存并设置sharing=locked
RUN --mount=type=cache,target=/home/root/workspace/target,sharing=locked \
    --mount=type=cache,target=/usr/local/cargo/registry \
    cargo build --release --all-features

# example-service阶段
FROM debian:bookworm-slim
COPY --from=build /home/root/workspace/target/release/example-service /usr/local/bin/

不过这种方式依赖BuildKit的缓存卷行为，可能出现缓存失效或内容不一致的情况，不如方案1稳妥。

内容的提问来源于stack exchange，提问作者diviquery