App Center构建应用时NuGet还原失败：Base64格式无效错误

这个错误我之前帮同事排查过好几次，核心问题都是NuGet源的凭据配置出了问题，尤其是访问令牌的格式或有效性不符合要求。下面是一步步的解决方法：

1. 重新生成正确的VSTS个人访问令牌（PAT） #

首先，你需要确保手里的PAT是有效的：

• 登录你的VSTS项目，进入用户设置 > 个人访问令牌
• 新建一个令牌，权限范围只勾选Packaging > Read（足够拉取NuGet包），有效期可以设长一点避免过期问题
• 生成后直接复制令牌内容，不要做任何修改（比如添加空格、换行，或者手动Base64编码）

2. 修正App Center中的NuGet源配置 #

打开App Center里你的应用的Build配置，找到NuGet sources区域：

• 确认源URL完全正确：https://{myDomainOnVSTS}.pkgs.visualstudio.com/_packaging/CustomNugetPackages/nuget/v3/index.json（替换掉{myDomainOnVSTS}为你的实际域名）
• 凭据部分：用户名可以随便填一个字符串（比如dummy或者你的用户名），密码直接粘贴刚才生成的PAT——这里绝对不要自己对PAT做Base64编码，App Center会自动处理编码逻辑，手动编码反而会生成无效的Base64字符串，这就是你遇到的错误根源！

3. 清理缓存避免旧配置干扰 #

• 本地端：删除项目根目录下的packages文件夹，然后运行命令清理NuGet缓存：

  nuget locals all -clear
  

• App Center端：重新触发一次构建，确保新的凭据被加载，旧的缓存不会影响新配置

4. 本地验证源的有效性（关键步骤） #

在本地命令行里先测试源是否能正常访问，排除App Center之外的问题：

• 添加源：

  nuget sources add -name "CustomNugetPackages" -source "https://{myDomainOnVSTS}.pkgs.visualstudio.com/_packaging/CustomNugetPackages/nuget/v3/index.json" -username dummy -password {你的PAT}
  

• 运行还原命令：

  nuget restore YourProject.sln -PackagesDirectory ./packages
  

如果本地能成功还原，说明源和凭据都是对的，再回到App Center重新配置即可。

常见坑点提醒 #

• 不要手动编码PAT：很多人误以为需要把PAT转成Base64再填，这完全是多余的，App Center会自动处理
• 权限要够：PAT必须有Packaging Read权限，否则即使令牌正确也会被拒绝访问
• 检查令牌是否过期：如果之前的令牌过期了，也会导致类似的编码错误提示

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