COPY指令用于构建时将本地文件或目录复制到镜像中，仅限构建上下文内路径，支持通配符、--chown和--chmod参数，目标路径不存在时自动创建，受.dockeringore影响，不支持上下文外文件。
COPY 指令本身不提供运行时调试能力，但可通过构建过程观察、分层验证和错误定位来高效排查问题。关键在于理解 COPY 的触发时机（构建阶段）、作用范围（仅限构建上下文）以及缓存机制对调试的影响。
检查构建上下文是否包含目标文件
COPY 只能访问 Dockerfile 所在目录及其子目录 中的文件，不会读取父目录或绝对路径。若提示 “no source files specified” 或 “file not found”，先确认：
- 执行
docker build时当前工作目录是否为 Dockerfile 所在目录 - 源路径是相对路径（如
COPY app.js /app/），且app.js确实存在于该目录下 - 检查
.dockerignore是否意外排除了要复制的文件（如误写了*.js或app*）
利用构建日志与中间镜像逐层验证
Docker 构建输出会明确显示每条 COPY 指令是否命中缓存或执行复制。若 COPY 后的 RUN 指令失败，可临时停在 COPY 层验证内容：
- 添加
RUN ls -la /target/path/紧跟在 COPY 后，查看文件是否真实存在、权限是否符合预期 - 构建时加
--no-cache排除缓存干扰，确认是逻辑问题而非缓存旧状态 - 用
docker build --target builder -o .（配合多阶段）或docker build -t debug-img .构建一个调试镜像，再运行：docker run --rm -it debug-img sh -c "ls -l /app/ && id"
验证文件归属与权限是否正确
宿主机上属主为 root 的文件默认在镜像中也属 root。若应用以非 root 用户运行（如 USER node），可能因无权读取而失败。此时应主动设置：
- 用
COPY --chown=node:node src/ /app/src/直接设定归属 - 避免后续再用
RUN chown，既减少层数又提升安全性 - 用
RUN ls -ld /app/src验证属主和权限是否匹配用户 UID/GID
区分 COPY 和 docker cp 的使用场景
容易混淆的是：COPY 是构建时指令，docker cp 是运行时命令。调试时别误用：
- 想看容器里有没有某个文件？用
docker exec -it container-name ls /path，不是docker cp -
docker cp host-file container:/path只影响正在运行的容器，无法改变镜像内容 - 镜像构建失败必须改 Dockerfile + rebuild，不能靠
docker cp补救
