.NET MAUI/WPF单元测试遇NU1201错误：目标框架兼容性问题

核心问题分析 #

你遇到的本质问题是测试项目与被测项目的目标框架不兼容：被测项目依赖net8.0-windows（带特定Windows版本的OS目标框架），而默认创建的MSTest/xUnit/NUnit项目目标是通用net8.0，导致跨框架引用失败或测试无法运行。

直接解决方案：让测试项目匹配OS目标框架 #

修改测试项目的.csproj文件，使其目标框架与被测项目完全一致，步骤如下：

1. 调整测试项目的TargetFramework

找到测试项目.csproj中的<PropertyGroup>节点，将通用net8.0替换为被测项目使用的net8.0-windows[版本号]，同时添加对应项目类型的启用属性：

针对WPF Blazor Hybrid测试项目的示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 必须与被测WPF项目的Windows版本一致，比如10.0.19041.0或10.0.22621.0 -->
    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
    <UseWPF>true</UseWPF> <!-- 启用WPF支持，匹配被测项目类型 -->
    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <!-- 保留原有的测试框架NuGet引用 -->
  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
    <PackageReference Include="MSTest.TestAdapter" Version="3.1.1" />
    <PackageReference Include="MSTest.TestFramework" Version="3.1.1" />
    <PackageReference Include="coverlet.collector" Version="6.0.0" />
  </ItemGroup>

  <!-- 添加对被测WPF项目的引用 -->
  <ItemGroup>
    <ProjectReference Include="..\YourWpfBlazorProject\YourWpfBlazorProject.csproj" />
  </ItemGroup>
</Project>

针对MAUI测试项目的示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 匹配MAUI项目的Windows目标版本，通常为10.0.22621.0 -->
    <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
    <UseMaui>true</UseMaui> <!-- 启用MAUI支持（若测试UI相关逻辑） -->
    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <!-- 测试框架NuGet引用 -->
  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
    <PackageReference Include="MSTest.TestAdapter" Version="3.1.1" />
    <PackageReference Include="MSTest.TestFramework" Version="3.1.1" />
    <PackageReference Include="coverlet.collector" Version="6.0.0" />
  </ItemGroup>

  <!-- 引用被测MAUI项目 -->
  <ItemGroup>
    <ProjectReference Include="..\YourMauiProject\YourMauiProject.csproj" />
  </ItemGroup>
</Project>

2. 关键注意事项

• Windows版本号必须完全一致：查看被测项目的.csproj，确保测试项目的net8.0-windows后缀版本号和被测项目完全相同，比如被测项目是net8.0-windows10.0.22621.0，测试项目不能用10.0.19041.0。
• 强制重新生成：修改.csproj后，右键解决方案选择「清理」，再右键测试项目选择「重新生成」，避免缓存导致的问题。
• 兼容测试框架版本：确保Microsoft.NET.Test.Sdk等NuGet包版本与.NET 8兼容（推荐17.8及以上版本）。

更优实践：分离业务逻辑 #

如果测试UI相关代码遇到持续问题，建议将项目中的纯业务逻辑抽离到独立的类库项目（目标框架设为通用net8.0），这样测试项目可以直接引用这个类库，无需匹配OS特定框架，大幅降低测试复杂度。

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