GitHub自托管Runner执行CI步骤时命令未找到问题求助

以下是针对你遇到的问题的具体排查和解决方案：

• 检查Runner环境变量的继承逻辑
  GitHub自托管Runner的官方启动脚本可能会重置环境变量，仅依赖$GITHUB_PATH可能无法让配置生效。建议直接将工具路径写入系统全局环境配置文件，确保所有shell环境都能读取：

  # 在Dockerfile中添加，将npm路径写入全局环境变量
  RUN echo 'PATH="$PATH:/usr/bin"' >> /etc/environment
  

  或者在自定义ENTRYPOINT脚本中，先加载全局配置再启动runner：

  # 自定义entrypoint.sh内容
  source /etc/environment
  ./run.sh "$@"
  

• 验证工具的实际安装路径
  本地运行镜像时执行which npm确认真实路径，避免路径配置错误。如果是通过nvm等方式安装Node.js，路径通常在/root/.nvm/versions/node/<版本号>/bin，需将该路径添加到全局PATH：

  RUN echo 'export PATH="$PATH:/root/.nvm/versions/node/v18.17.0/bin"' >> /etc/bash.bashrc
  

• 指定CI步骤的交互式shell
  GitHub Actions默认使用非交互式shell，不会加载~/.bashrc或/etc/profile。在workflow中指定交互式shell：

  - name: 启动服务
    shell: bash -l {0}
    run: npm run dc-up
  

  或者在步骤中手动导出路径：

  - name: 启动服务
    run: |
      export PATH="$PATH:/usr/bin"
      npm run dc-up
  

• 调试CI环境状态
  在CI流程中添加调试步骤，确认PATH和工具存在性：

  - name: 调试环境变量
    run: |
      echo 当前PATH: $PATH
      which npm || echo "npm未找到"
      ls -la /usr/bin/npm || echo "/usr/bin/npm不存在"
  

根据输出结果定位路径配置或工具安装的问题。

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