NuGet pack令牌替换偶发失败：缺失Authors和Description报错

我之前也碰到过类似的偶发NuGet打包异常，结合你的场景和日志信息，给你梳理几个针对性的排查方向和解决办法：

1. 聚焦NuGet版本差异下的令牌替换逻辑 #

你提到的不同版本、不同环境表现不一致是核心线索：

• NuGet 4.7.0及后续版本在元数据读取逻辑上有调整，优先读取csproj文件中的属性，而旧版本（比如4.6.2）更依赖AssemblyInfo.cs的配置。建议你直接在项目的csproj文件中显式添加相关属性，避免令牌替换的不确定性：

  <PropertyGroup>
    <Authors>你的团队/作者名</Authors>
    <Description>类库的详细描述</Description>
  </PropertyGroup>
  

• 确认nuspec文件中的令牌格式是否正确，必须是$authors$、$description$这种全小写格式（NuGet对令牌大小写敏感）

2. 消除MSBuild自动检测的随机性 #

从你的日志能看到MSBuild是自动检测版本的，不同环境的MSBuild版本差异会导致元数据读取不一致：

• 打包时显式指定MSBuild路径，比如添加参数：

  -MSBuildPath "C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\MSBuild\15.0\Bin"
  

  路径根据你实际安装的VS/Build Tools版本调整，避免自动检测带来的版本波动
• 检查TFS代理运行账号的权限，确保它能正常读取AssemblyInfo.cs和csproj文件，偶发的权限不足也会导致令牌读取失败

3. 排查nuspec文件的隐性问题 #

即使是标准配置，也可能存在编码或隐藏字符的干扰：

• 用Notepad++之类的编辑器打开nuspec，检查文件编码是否为UTF-8无BOM格式，BOM字符可能会干扰NuGet的解析逻辑
• 临时在nuspec中硬编码Authors和Description，测试是否还会偶发失败：如果不再失败，说明问题确实出在令牌替换；如果仍失败，就要考虑缓存或工作目录的问题

4. 清理缓存与工作目录 #

偶发问题往往和缓存残留有关：

• 执行nuget locals all -clear清理NuGet本地缓存
• 在TFS构建流程中添加「清理工作目录」步骤，确保每次构建都是从零开始，避免旧的AssemblyInfo、nuspec文件残留干扰

5. 关于令牌替换Bug的验证 #

你查到的令牌替换Bug，大概率对应NuGet 4.7.x版本中，当项目存在延迟计算的MSBuild属性或特殊字符时，元数据读取失败的问题。如果上面的方法都无效，可以尝试：

• 降级到NuGet 4.6.2（如果环境允许）
• 升级到NuGet 5.x及以上版本，新版本修复了大量旧版的令牌替换异常

内容的提问来源于stack exchange，提问作者Bogdan Stăncescu