GitLab CI部署NuGet包遇401未授权及源参数失效问题

核心排查方向与解决办法 #

1. 变量引用与权限问题 #

• 先确认NUGET_SOURCE和NUGET_API_KEY这两个变量在GitLab CI中的状态：如果是受保护变量，必须确保你的标签属于「受保护标签」列表，否则流水线无法读取变量，直接导致401。
• 检查命令中的变量引用语法，避免低级错误：比如漏加$、引号使用不当导致source参数被拆分成多个部分。正确写法示例：

  dotnet nuget push "**/*.nupkg" --source "$NUGET_SOURCE" --api-key "$NUGET_API_KEY" --skip-duplicate
  

2. NuGet配置文件干扰 #

• GitLab CI环境（或你使用的Docker镜像）可能自带默认NuGet.Config，里面的源配置会覆盖--source参数。解决办法：
  • 推送前临时添加指定源：

    dotnet nuget add source "$NUGET_SOURCE" --name TempNuGet --username dummy --password "$NUGET_API_KEY" --store-password-in-clear-text
    dotnet nuget push "**/*.nupkg" --source TempNuGet --skip-duplicate
    

  • 或者直接指定项目根目录的自定义NuGet.Config：

    dotnet nuget push "**/*.nupkg" --source "$NUGET_SOURCE" --api-key "$NUGET_API_KEY" --config-file ./NuGet.Config
    

3. 本地与CI环境的隐性差异 #

• 本地可能已经缓存了NuGet凭据，CI环境却是全新的，所以必须确保命令参数完整。可以在CI脚本里加调试命令，验证环境：

  # 打印变量值，确认是否正确传递
  echo "Current NuGet Source: $NUGET_SOURCE"
  # 列出当前NuGet配置的所有源
  dotnet nuget list source
  

• 排查网络问题：GitLab CI runner可能有代理或防火墙限制，导致无法连接NuGet源。加个curl测试：

  curl -v "$NUGET_SOURCE"
  

4. 标签触发的流水线权限 #

• 确认流水线使用的GitLab角色（比如项目CI/CD服务账号）是否拥有NuGet源的推送权限，API密钥是否是具备推送权限的有效密钥。
• 检查.gitlab-ci.yml的触发规则，确保部署阶段只在标签推送时运行，避免分支推送时误触发导致变量未加载。

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