Docker镜像构建成功本地运行失败，GitHub Actions运行正常求助

1. 本地构建带入了本地node_modules目录 #

Dockerfile先执行yarn install安装容器内依赖，之后执行COPY . /app，如果本地目录已存在node_modules，会覆盖容器中安装的依赖。而GitHub Actions拉取的是仓库干净代码，无本地node_modules，因此CI能正常运行。

解决办法：

• 在项目根目录创建.dockerignore文件，添加以下内容：

  node_modules
  .git
  .env
  

  构建时将跳过这些本地目录，避免污染镜像内的依赖环境。

2. COPY文件后的权限异常 #

切换到raj用户后执行COPY . /app，Docker默认以root权限复制文件，导致容器内/app下文件属主为root，raj用户可能无读写权限，触发本地运行报错；而GitHub Actions运行环境有特殊权限配置，因此未出现问题。

解决办法：

• 修改COPY命令，添加--chown=raj:teams参数，确保复制的文件属主为raj：

  COPY --chown=raj:teams *package*json /app
  COPY --chown=raj:teams . /app
  

3. 环境变量缺失 #

测试脚本可能依赖特定环境变量，GitHub Actions已配置这些变量，但本地运行镜像时未传入，导致测试失败。

解决办法：

• 运行镜像时通过-e参数传入所需环境变量：

  docker run -e TEST_ENV=your_value your-image-name
  

• 也可在Dockerfile中用ENV命令直接设置必要的环境变量。

4. 本地与CI的Docker环境差异 #

比如本地是Windows/WSL环境，GitHub Actions是纯Linux环境，可能存在文件换行符（CRLF vs LF）差异，导致测试脚本在容器内执行报错。

解决办法：

• 在项目中配置.gitattributes文件，强制文本文件使用LF换行符：

  * text=auto eol=lf
  

  确保代码在本地和CI环境中格式一致。

快速排查技巧 #

1. 运行镜像时添加-it参数进入容器，手动执行命令排查错误：

   docker run -it --entrypoint bash your-image-name
   

   在容器内执行yarn run test，查看具体报错信息再针对性解决。
2. 对比本地构建命令与GitHub Actions中的构建命令，确保参数一致（比如是否使用--no-cache等）。

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