推送代码至GitHub时Dockerfile构建遇NuGet认证错误如何解决？

核心问题是Docker构建过程中未正确传入GitHub Packages的认证令牌，导致拉取私有NuGet包时认证失败，最终触发dotnet restore返回非零错误码。以下是具体解决步骤：

• 确认GitHub访问令牌权限
  创建或检查个人访问令牌（PAT），必须包含read:packages权限（用于读取GitHub Packages），如果包关联私有仓库，还需添加repo权限。

• 在GitHub Actions中传递令牌到Docker构建
  在Workflow文件里，通过build-args将令牌传入Docker构建流程，示例代码：

  - name: Build Docker image
    run: docker build --build-arg GITHUB_TOKEN=${{ secrets.GITHUB_TOKEN }} .
  

  若使用自定义PAT，需先将其存入仓库Secrets，再替换上述的secrets.GITHUB_TOKEN为自定义密钥名称。

• 修改Dockerfile注入认证配置
  在dotnet restore步骤前添加NuGet源的认证配置，示例Dockerfile片段：

  ARG GITHUB_TOKEN
  # 添加GitHub Packages NuGet源并配置认证
  RUN dotnet nuget add source --username YOUR_GITHUB_USERNAME --password ${GITHUB_TOKEN} --store-password-in-clear-text --name github "https://nuget.pkg.github.com/YOUR_GITHUB_OWNER/index.json"
  
  # 执行restore命令
  RUN dotnet restore ./
  

  替换YOUR_GITHUB_USERNAME为你的GitHub用户名，YOUR_GITHUB_OWNER为包所在的组织或个人用户名。

• 验证构建命令与参数
  确认dotnet build ./ -t test中的-t test目标不会干扰restore流程，若restore仍失败，可单独执行dotnet restore命令排查，必要时指定项目文件路径（如dotnet restore ./WebApplication2/WebApplication2.csproj）。

• 额外排查项

  • 核对GitHub Packages源URL是否正确，格式应为https://nuget.pkg.github.com/OWNER/index.json
  • 检查自定义PAT是否过期，可在GitHub账号设置的"开发者设置"中查看
  • 确认令牌所属账号拥有目标NuGet包的读取权限

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