Docker COPY命令相对于构建上下文的行为说明及父目录复制失败问题求助

我来帮你理清这个问题——核心就是Docker构建上下文与COPY路径的对应关系没搞透，咱们一步步拆解：

先明确Docker构建上下文的行为机制 #

当你执行docker build -t laravel -f docker/php81aws/Dockerfile .，或者在Compose里指定context: ./时，这里的.（app-root目录）就是Docker的构建上下文。Docker会把这个目录下的所有文件/目录打包发送给Docker daemon，后续所有COPY/ADD指令里的源路径，都是相对于这个上下文目录，而不是相对于Dockerfile所在的位置！这是很多人踩坑的关键。

分析你的错误原因 #

你遇到的failed to compute cache key: "/start-container" not found错误，大概率是这两个原因之一：

• .dockerignore文件排除了目标文件：如果你的app-root目录下有.dockerignore，里面如果写了docker/、start-container这类规则，Docker daemon会直接忽略这些文件，导致COPY时找不到。
• 路径拼写错误：Linux环境下路径区分大小写，检查一下文件名/目录名的大小写是否和实际一致（比如是不是写成了Start-Container而非start-container）。

正确的COPY写法验证 #

你的Dockerfile里的指令其实是符合上下文规则的：

• COPY docker/php81aws/start-container /usr/local/bin/start-container：源路径是相对于app-root的docker/php81aws/start-container，这个文件确实存在于你的目录结构中，只要没被忽略，就应该能正常复制。
• COPY --chown=www:www . /var/www/：这条指令正好满足你“复制父目录（app-root）内容到镜像”的需求，因为.代表整个构建上下文（app-root），会把app-root下的app_folders、app_files以及docker/目录全部复制到镜像的/var/www/下。

快速排查步骤 #

1. 先在app-root目录下执行ls docker/php81aws/start-container，确认文件确实存在；
2. 检查app-root下的.dockerignore文件，删除任何可能排除docker/目录或start-container的规则；
3. 重新执行构建命令，或者用docker build --no-cache -t laravel -f docker/php81aws/Dockerfile .跳过缓存，避免缓存导致的问题。

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