为何安装我的NuGet包会触发依赖DLL版本降级？

你的NuGet包依赖配置 #

<dependencies>
  <dependency id="Microsoft.IdentityModel.Clients.ActiveDirectory" version="5.2.9" />
  <dependency id="Newtonsoft.Json" version="12.0.2" />
  <dependency id="System.Runtime.Caching" version="4.5.0" />
  <dependency id="Polly" version="7.1.0" />
</dependencies>

问题解答 #

1. 为什么Newtonsoft.Json会被降级？

你在nuspec里写的version="12.0.2"是NuGet的最低版本要求，理论上允许安装>=12.0.2的版本，但出现降级通常是这几个原因：

• 团队项目中存在其他NuGet包，依赖了更低版本的Newtonsoft.Json，或者明确限制了版本上限（比如<=12.0.2）。NuGet的依赖解析会选择能满足所有依赖的最高兼容版本，一旦有冲突，会优先满足更严格的版本限制。
• 你混淆了代码引用和NuSpec配置：代码里没硬编码版本，但nuspec里的12.0.2已经明确给NuGet设定了最低版本，若团队项目的依赖树里没有其他包要求更高版本，NuGet会默认安装你指定的最低版本（12.0.2），而非自动升级到13。
• 如果团队使用的是packages.config而非PackageReference，NuGet的版本解析策略更偏向固定版本，不会自动升级到更高版本。

2. 为什么System.Memory（间接依赖）也会被降级？

System.Memory是你的直接依赖带进来的间接依赖：

• 比如Polly 7.1.0或Microsoft.IdentityModel.Clients.ActiveDirectory 5.2.9本身依赖了某个版本的System.Memory。如果团队项目里的其他包依赖了更低版本的System.Memory，NuGet会选择能满足所有依赖的最低兼容版本，导致看起来像是“降级”。
• 若团队项目没有其他依赖要求更高版本的System.Memory，NuGet就会安装你的直接依赖所要求的版本——如果这个版本本身较低，就会出现你看到的情况。

解决建议 #

• 排查依赖冲突：在团队项目里运行dotnet list package --include-transitive，查看所有直接/间接依赖的版本要求，找出哪个包限制了Newtonsoft.Json或System.Memory的版本。
• 调整nuspec的版本范围：把Newtonsoft.Json的版本改成[12.0.2,)，表示允许安装12.0.2及以上的所有版本，让NuGet可以自动选择最高兼容版本。
• 强制指定版本：如果要确保使用特定版本，可以让团队在项目的csproj或Directory.Packages.props里直接添加对应包的引用并指定版本，覆盖间接依赖的版本：

  <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
  <PackageReference Include="System.Memory" Version="4.5.5" />
  

• 升级直接依赖：比如把Polly或Microsoft.IdentityModel.Clients.ActiveDirectory升级到更高版本，它们可能会依赖更高版本的System.Memory，间接解决问题。

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