VSTS构建时NuGet还原遇401未授权问题求助

我之前也帮不少人排查过类似的VSTS（现在叫Azure DevOps）构建NuGet认证问题，结合你描述的情况——本地用浏览器、Visual Studio都能正常访问外部NuGet源，构建也没问题，但VSTS构建就返回401未授权——给你几个针对性的排查方向：

1. 确认构建服务账户的权限 #

本地能访问是因为用了你的个人用户身份，但VSTS构建默认使用的是构建服务账户（格式一般是[你的组织名称] Build Service ([项目名称])），而不是你本地的账户。

• 登录到你的NuGet包源管理后台，检查这个构建服务账户有没有被授予读取包的权限。很多人容易只给自己的账户开权限，忘了给构建服务账户配置，这是最常见的坑。

2. 核对NuGet任务的源配置 #

看你附的NuGet任务截图，要注意这几点：

• 任务里指定的NuGet源名称，必须和你在VSTS项目中配置的认证源完全一致（包括大小写、空格，不能有拼写错误）。
• 如果你的项目用nuget.config文件管理源，要确保构建过程中这个文件被正确加载，而且文件里的源配置和VSTS的认证配置没有冲突——比如不要在nuget.config里硬编码过时的凭据，避免覆盖VSTS的配置。

3. 检查凭据的有效性 #

如果在VSTS里配置NuGet源认证时用的是个人访问令牌（PAT）：

• 确认这个PAT的权限足够，至少要包含Packaging (Read)权限，而且没有过期。
• 如果用的是用户名+密码，要注意如果你的账户开启了多因素认证（MFA），普通密码是无效的，必须用PAT替代，因为构建代理无法处理MFA的验证步骤。另外也要检查密码有没有特殊字符，导致在构建过程中被转义出错。

4. 自托管代理的本地测试（如果用的是自托管代理） #

如果你的构建用的是自托管代理，登录到代理所在的机器，打开命令行执行：

nuget list -Source [你的NuGet源完整地址]

如果这个命令也返回401，说明代理机器上的NuGet凭据存储有问题，可以用以下命令重新配置凭据：

nuget sources update -Name [你的源名称] -UserName [PAT对应的用户名，一般填任意字符即可] -Password [你的PAT值]

配置完成后再测试命令，正常的话再重新触发构建。

5. 排查网络层面的干扰 #

有些企业环境里，构建代理所在的网络有防火墙或代理服务器，可能拦截了NuGet的请求——本地能访问是因为你的机器在白名单里，但构建代理不在。

• 可以在构建任务里加一个测试步骤，用curl命令访问NuGet源地址：

curl -I [你的NuGet源地址]

看返回的状态码，如果是401，那还是认证问题；如果是超时或其他错误，就需要联系运维团队，把构建代理的IP加入网络白名单。

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