Docker COPY命令未复制特定config.yaml文件问题排查

你遇到的问题和COPY指令放在FROM前后没有直接关系，本质是拷贝源认知偏差加命令写法错误导致的：

1. 你当前多阶段构建里最终阶段的COPY --from=buildcontainer dist dist，拷贝的源是第一个构建阶段（buildcontainer）容器内部生成的dist目录，不是你本地宿主机上的dist目录。你的npm run build构建逻辑（比如tsc编译）默认只会输出js、类型声明、sourcemap三类文件（也就是你看到的configuration.d.ts、configuration.js、configuration.map），根本没有把config.yaml复制到构建阶段的dist目录里，所以从buildcontainer拷贝时自然拿不到这个yaml文件。
2. 你调试时观察到的位置差异本质是拷贝源变了：如果把COPY指令写在第一个FROM之前，或者在FROM之后写不带--from参数的普通COPY指令，拷贝的源是你本地传入Docker构建上下文的文件，所以能拿到本地dist里的config.yaml；用--from=buildcontainer时拷贝源是前序构建阶段的文件系统，和你本地文件没有直接关系。
3. 你当前使用的构建命令本身有参数错误：docker build -t drs:1.0.0 -f . /srs/sync-data里-f参数需要指定Dockerfile的具体路径，你传入.属于无效写法，会导致构建上下文解析、.dockerignore规则匹配出现异常，进一步放大文件拷贝的问题。

按优先级依次操作即可：

• 首先修正build命令参数，明确指定Dockerfile路径，比如Dockerfile在当前执行目录的话，命令改成：
  docker build -t drs:1.0.0 -f ./Dockerfile /srs/sync-data
• 检查当前目录下的.dockerignore文件，删除其中过滤yaml文件的规则（比如*.yaml、config.yaml这类条目），如果确实需要忽略其他yaml文件，就加一行白名单规则!dist/config.yaml，保证构建上下文能读取到这个配置文件。
• 如果你最终镜像里要用的config.yaml是本地维护的静态版本，不需要在构建阶段生成，直接在最终镜像阶段加一行单独的拷贝指令即可，不需要修改构建脚本：

COPY --from=buildcontainer dist dist
COPY dist/config.yaml dist/
COPY --from=buildcontainer node_modules node_modules

• 如果你希望构建阶段生成的dist目录就自带config.yaml，直接修改package.json里的build脚本，在编译完成后追加复制配置文件的逻辑，比如：

{
  "scripts": {
    "build": "tsc && cp config.yaml dist/"
  }
}

如果是Windows环境把cp换成copy即可，这样构建阶段的dist目录里会自带四个文件，后续--from拷贝时就能完整复制所有内容。

如果要确认构建阶段的dist目录实际内容，可以单独构建buildcontainer阶段，进入容器查看目录内容，命令如下：

docker build --target buildcontainer -t test:build .
docker run --rm -it test:build ls -la dist

执行后就能直接看到build阶段生成的dist里到底包含哪些文件，不用反复构建全量镜像排查。

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