GitHub工作流拉取同组织NuGet包时401认证失败求助

问题根源 #

仅设置GITHUB_TOKEN环境变量不足以让dotnet自动关联GitHub Packages源的认证信息，尤其是项目配置多个NuGet源时，dotnet无法识别令牌对应的目标源。此外需确认PAT权限是否适配GitHub Actions场景。

解决方案 #

1. 显式配置NuGet源与凭据 #

在dotnet restore步骤前添加命令，直接为GitHub Packages源绑定认证信息：

- name: Configure GitHub NuGet source
  run: |
    dotnet nuget add source \
      --username ${{ github.actor }} \
      --password ${{ secrets.GH_TOKEN }} \
      --store-password-in-clear-text \
      --name github \
      "https://nuget.pkg.github.com/你的组织名/index.json"
- name: Restore dependencies
  run: dotnet restore

注：--store-password-in-clear-text在GitHub Actions runner环境中安全，会话结束后会自动清理临时配置。

2. 修正nuget.config配置 #

若项目已包含nuget.config，需确保它正确配置GitHub源的凭据占位符，并在Actions中传递令牌：

项目根目录的nuget.config示例：

<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <add key="github" value="https://nuget.pkg.github.com/你的组织名/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <github>
      <add key="Username" value="任意GitHub用户名" />
      <add key="ClearTextPassword" value="%GITHUB_TOKEN%" />
    </github>
  </packageSourceCredentials>
</configuration>

对应Actions步骤：

- name: Restore dependencies
  run: dotnet restore
  env:
    GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}

3. 验证PAT权限范围 #

确保PAT包含以下必要权限：

• read:packages：读取GitHub Packages中私有/内部包的核心权限
• repo（可选）：若包存储在私有仓库中，需此权限关联仓库访问

额外排查点 #

• 确认GitHub Packages源地址格式正确：应为https://nuget.pkg.github.com/组织名/index.json，而非单个包的下载URL
• 检查是否存在多源认证冲突，比如多个NuGet源误用了相同的环境变量名

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