Dockerfile执行COPY指令时出现异常行为的解决方案求助

该问题由Dockerfile COPY 指令的路径规则使用错误触发：
当COPY指令同时指定多个源文件（包括通配符匹配到的多文件），或单条指令复制单个文件到目标路径时，如果目标路径未以/结尾且镜像内对应路径不是已存在的目录，Docker会将目标路径识别为普通文件，所有写入该路径的内容会互相覆盖，就会出现你遇到的所有文件内容都和index.html一致的问题。

方案1：单条指令批量复制（推荐） #

提前确认目标目录存在，且复制指令的末尾目标路径以/结尾即可，以下是基于nginx基础镜像的完整示例（SPA部署最常用的基础镜像）：

FROM nginx:alpine
# 提前创建目标目录，避免镜像内目录不存在导致的识别异常
RUN mkdir -p /usr/share/nginx/html/
# 批量复制所有需要的静态文件，末尾路径必须带/
COPY index.html style.css app.js /usr/share/nginx/html/
# 如果有子目录资源，单独添加即可
COPY assets/ /usr/share/nginx/html/assets/

方案2：拆分单文件复制 #

如果需要单独控制每个文件的复制逻辑，每条指令明确指定完整的目标文件路径即可：

FROM nginx:alpine
COPY index.html /usr/share/nginx/html/index.html
COPY style.css /usr/share/nginx/html/style.css
COPY app.js /usr/share/nginx/html/app.js

构建镜像后可以直接执行以下命令验证文件内容是否正常，无需启动容器排查：

# 替换为你自己构建的镜像名
docker run --rm --entrypoint cat your-image-name /usr/share/nginx/html/style.css

如果输出为正常的CSS代码，说明复制逻辑正常。

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