.NET Standard引入Microsoft.Extensions引发.NET Core依赖异常求助

我之前碰到过好几例类似的问题，核心原因基本都是Microsoft.Extensions系列包的版本冲突——.NET Standard 2.0和.NET Core 2.1的依赖体系有重叠，但对这类基础库的版本要求存在细微差异，当类库引用的包版本和控制台应用中其他包依赖的版本不匹配时，就会触发类型加载失败的异常。

下面是几个经过验证的解决方案，按优先级尝试：

1. 统一管理所有项目的Microsoft.Extensions包版本 #

最有效的方法是在解决方案层面统一指定这些包的版本，避免各项目各自引用导致的版本不一致。你可以在解决方案根目录创建一个Directory.Build.props文件，内容如下：

<Project>
  <!-- 统一指定Microsoft.Extensions系列包的版本，建议选择和.NET Core 2.1兼容的稳定版，比如2.1.1 -->
  <PropertyGroup>
    <MicrosoftExtensionsPackageVersion>2.1.1</MicrosoftExtensionsPackageVersion>
  </PropertyGroup>
  <!-- 强制所有项目使用指定版本的包 -->
  <ItemGroup>
    <PackageReference Update="Microsoft.Extensions.Configuration" Version="$(MicrosoftExtensionsPackageVersion)" />
    <PackageReference Update="Microsoft.Extensions.Primitives" Version="$(MicrosoftExtensionsPackageVersion)" />
    <PackageReference Update="Microsoft.Extensions.Logging" Version="$(MicrosoftExtensionsPackageVersion)" />
    <!-- 按需添加其他Microsoft.Extensions相关包 -->
  </ItemGroup>
</Project>

添加后重新加载解决方案，所有项目都会自动使用这个统一版本的包，从根源上减少冲突。

2. 排查控制台应用的依赖树，解决冲突 #

如果统一版本后还是有问题，需要检查控制台应用的所有依赖（包括间接引用的包）：

• 打开Package Manager Console或者终端，进入控制台应用的项目目录，运行命令：

  dotnet list package --include-transitive
  

• 查看输出中所有Microsoft.Extensions.*开头的包版本，找到和统一版本不一致的条目。
• 对于冲突的包，可以在控制台应用的.csproj文件中添加PackageReference并指定Update属性强制版本，比如：

  <PackageReference Update="Microsoft.Extensions.DependencyInjection" Version="2.1.1" />
  

3. 清理缓存与重建解决方案 #

有时候本地残留的旧编译文件或NuGet缓存会导致异常，执行以下步骤：

• 删除所有项目下的bin和obj目录
• 在终端运行命令清理NuGet缓存：

  dotnet nuget locals all --clear
  

• 重新生成整个解决方案，确保所有文件都是基于最新的包版本编译的。

4. 升级.NET Core版本（可选但推荐） #

.NET Core 2.1已经停止官方维护了，它对.NET Standard 2.0的兼容性虽然支持，但不如后续版本稳定。如果项目允许，建议把控制台应用升级到.NET Core 3.1（长期支持版）或者更高版本，这样不仅能解决当前的包冲突问题，还能获得更好的性能和安全性更新。

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