Cloud Run部署Docker镜像时提示文件不存在但文件实际存在的问题排查

可能的原因 #

• 工作目录不匹配：Dockerfile未指定WORKDIR时，本地运行容器的工作目录可能和Cloud Run中容器默认工作目录不同，导致相对路径./frontend/investpr/dist/index.html指向的位置不一致。
• 构建上下文差异：使用Cloud Build构建镜像时，构建上下文可能未包含frontend/investpr/dist目录，或是.gitignore规则排除了该目录，导致镜像中实际缺失文件；而本地构建时因为上下文完整，文件存在。
• 多阶段构建遗漏文件：如果采用多阶段构建，可能在从构建阶段向运行阶段复制文件时路径错误，或是未将dist目录复制到最终镜像中，本地缓存或环境特性掩盖了这个问题，但Cloud Run运行的镜像确实没有该文件。
• 大小写敏感问题：本地系统（如Windows、macOS）默认大小写不敏感，而Cloud Run的容器基于Linux，大小写敏感。若代码中路径的大小写与实际目录/文件名不符，本地能正常访问，Cloud Run中则会提示文件未找到。

调试方法 #

• 拉取镜像本地验证：将Cloud Run使用的镜像拉到本地，检查文件结构：

  docker pull [你的镜像完整地址]
  docker run --rm -it [镜像名称] /bin/sh
  # 在容器内执行以下命令查找文件
  find / -name index.html
  ls -la ./frontend/investpr/dist/
  

• 明确指定工作目录：在Dockerfile中添加WORKDIR指令，例如：

  WORKDIR /app
  

  确保所有相对路径都基于该目录，让本地与Cloud Run的容器工作目录保持一致。
• 检查Cloud Build构建上下文：若使用Cloud Build，确认构建命令或cloudbuild.yaml中包含了frontend/investpr/dist目录，同时检查.gitignore是否排除了该目录，必要时临时调整规则。
• 添加调试命令到启动流程：修改Dockerfile的启动命令，先打印目录结构再启动服务，例如：

  CMD ["sh", "-c", "ls -la ./frontend/investpr/dist/ && npm start"]
  

  这样Cloud Run的日志会显示该目录下的文件情况，直接确认文件是否存在。
• 查看完整容器日志：在Cloud Run控制台中查看完整的stderr和stdout日志，除了文件未找到的错误，还能获取容器启动时的工作目录、环境变量等信息，定位问题。

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