GitHub Actions中npm ci安装私有GitHub依赖失败求助

针对GitHub Actions中npm ci拉取私有GitHub仓库依赖失败的问题，按以下步骤逐一排查：

1. 确认Access Token的有效性与权限 #

• 检查使用的**个人访问令牌（PAT）**是否具备repo权限（必须能访问目标私有仓库），且未过期、未被撤销。
• 若你在package.json中用占位符{access_token}，需确认Actions环境中是否正确注入了实际token：
  绝对不要在package.json硬编码token，建议通过GitHub Secrets存储，再在工作流中引用。

2. 检查package.json中的依赖URL格式 #

• 确认URL中的{owner}、{repo name}已替换为实际值，分支后缀（如#master）是否与目标仓库的分支名一致（若仓库默认分支是main则需修改）。
• 若本地是通过脚本动态替换占位符（如sed），需在Actions工作流中添加相同的替换步骤，否则URL会保留占位符导致仓库找不到。

3. 配置GitHub Actions的git认证 #

• 默认的GITHUB_TOKEN仅拥有当前仓库的权限，无法访问其他私有仓库，需使用自己的PAT：
  在npm ci步骤前添加以下配置，让git自动用PAT认证GitHub请求：

  git config --global url."https://${{ secrets.PRIVATE_REPO_TOKEN }}@github.com/".insteadOf "https://github.com/"
  

• 或者通过创建.npmrc文件配置npm认证：

  echo "//github.com/:_authToken=${{ secrets.PRIVATE_REPO_TOKEN }}" >> ~/.npmrc
  

4. 排查环境差异 #

• 对比本地与Actions环境的npm版本：在setup-node步骤中指定与本地一致的npm版本，比如：

  - uses: actions/setup-node@v3
    with:
      node-version: 16
      npm-version: 8.x
  

• 若使用企业GitHub，检查是否有IP白名单限制，GitHub Actions的runner IP是否在允许列表内。

5. 网络连通性测试 #

• 在Actions中添加临时步骤，测试目标仓库的访问性：

  curl -v https://github.com/{owner}/{repo name}.git
  

  查看输出是否有认证失败或连接错误的信息。

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