Docker COPY指令未复制更新文件，docker-compose构建缓存异常求解

问题根因 #

你遇到的是Docker构建时COPY层偶发缓存误命中的问题，核心是两个常见诱因：

1. COPY指令目标路径写法有歧义，你写的configuration没有末尾斜杠，Docker无法明确区分目标是目录还是普通文件，部分场景下会直接复用旧缓存层。
2. 本地构建上下文缓存异常，或者修改后的文件哈希/修改时间没有被Docker正确识别，导致Docker判定文件无变化复用旧层。

解决方案 #

1. 修正COPY指令消除歧义

将Dockerfile中的COPY语句修改为明确的目录目标写法，从根源避免路径解析异常：

# 旧写法
# COPY server/configuration/db_tdb.ttl configuration
# 新写法
COPY server/configuration/db_tdb.ttl ./configuration/

2. 低成本强制刷新COPY层（不重建前面的层）

如果还是偶发缓存异常，可以在COPY指令前加一个无副作用的ARG参数作为缓存扰动开关，仅刷新COPY及之后的层，完全不影响前面的基础镜像、目录创建等层的缓存，速度接近正常缓存构建：

WORKDIR /fuseki

# 新增扰动参数，默认值不影响正常构建
ARG CACHEBUST=1
COPY server/configuration/db_tdb.ttl ./configuration/

需要强制更新配置文件时，执行以下命令即可，仅会重建最后两层，不会全量构建：

docker-compose build --build-arg CACHEBUST=$(date +%s)
docker-compose up -d

3. 开发环境最优方案：用挂载卷跳过构建流程

开发阶段频繁修改配置文件完全不需要重新构建镜像，直接在docker-compose中添加本地文件挂载，修改本地文件后容器内实时生效，连build步骤都省了：

services:
  jena-fuseki-server:
    # 原有配置保留，新增以下volumes配置
    volumes:
      - ./server/configuration/db_tdb.ttl:/fuseki/configuration/db_tdb.ttl

4. 异常排查方法

如果问题仍然复现，可以执行以下命令查看构建过程的详细日志，确认COPY步骤是否读取到了新版本文件：

docker-compose build --no-cache --progress=plain

同时检查项目根目录的.dockerignore文件，确认没有规则匹配到db_tdb.ttl，导致新版本文件没有被传入构建上下文。

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