NuGet包引用错误.NET框架/标准的原因及强制使用.NET Standard 2.0方法

一、为什么MQTTNet会加载net461版本？ #

NuGet的依赖解析逻辑是：对于.NET Framework项目，会优先选择与目标框架直接匹配的包版本，而非.NET Standard版本。.NET Framework 4.7.2虽完全兼容.NET Standard 2.0，但NuGet默认会优先挑选针对.NET Framework编译的特定版本（如net461），认为这是更“适配”的实现——即便你的项目版本更高。

二、如何强制依赖项使用.NET Standard 2.0版本？ #

以下是按优先级排序的可靠解决方法：

1. 配置PackageReference的AssetTargetFallback #

若项目使用PackageReference（而非旧版packages.config），可在.csproj文件中添加配置，强制NuGet优先选择.NET Standard 2.0资产：

<PropertyGroup>
  <!-- 优先选用.NET Standard 2.0的包版本 -->
  <AssetTargetFallback>$(AssetTargetFallback);netstandard2.0</AssetTargetFallback>
  <!-- 禁用.NET Framework特定版本的优先匹配逻辑 -->
  <DisableImplicitFrameworkReferences>true</DisableImplicitFrameworkReferences>
</PropertyGroup>

同时，为MQTTNet的引用明确排除net461版本：

<PackageReference Include="MQTTNet" Version="4.1.3.436">
  <ExcludeAssets>runtime; build; native; contentfiles; analyzers</ExcludeAssets>
  <IncludeAssets>compile</IncludeAssets>
  <!-- 指定仅使用netstandard2.0版本 -->
  <TargetFrameworks>netstandard2.0</TargetFrameworks>
</PackageReference>

2. 迁移至PackageReference（若使用packages.config） #

若项目仍用packages.config，建议迁移到PackageReference——它的依赖解析逻辑更灵活，更易控制目标框架选择。迁移步骤：

• 右键项目 → 管理NuGet程序包 → 点击界面顶部的“迁移”按钮
• 完成迁移后，再应用上述AssetTargetFallback配置

3. 手动指定HintPath（临时备选） #

若上述方法无效，可临时在.csproj中硬编码MQTTNet的netstandard2.0路径，但此方法维护性差，仅作应急方案：

<Reference Include="MQTTnet">
  <HintPath>packages\MQTTnet.4.1.3.436\lib\netstandard2.0\MQTTnet.dll</HintPath>
</Reference>

注意：需确保所有子依赖也适配netstandard2.0，否则可能引发新的兼容性问题。

三、.NET Framework 4.7.2引用.NET Standard 2.0包的特殊步骤？ #

正常情况下无需特殊步骤，因为.NET Framework 4.7.2完全兼容.NET Standard 2.0，但需注意：

• 确认项目目标框架确实为.NET Framework 4.7.2（右键项目→属性→应用程序→目标框架）
• 避免同时引用同一包的.NET Framework特定版本和.NET Standard版本，防止依赖冲突
• 若使用VS2017之前的旧版本，需安装.NET Standard 2.0支持包（VS2017及以后默认已包含）

崩溃问题的额外排查 #

若切换到netstandard2.0版本后仍崩溃，可能原因及解决：

• MQTTNet的netstandard2.0实现中仍存在基于运行时检测的.NET Framework分支逻辑，可尝试添加编译符号强制使用.NET Standard路径：
  在.csproj中添加：

  <PropertyGroup>
    <DefineConstants>$(DefineConstants);NETSTANDARD2_0</DefineConstants>
  </PropertyGroup>
  

• 项目中存在其他依赖引入了旧版System.Net.Sockets组件，导致冲突，可清理NuGet缓存后重新安装所有包

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