.NET 8.0 MAUI中xUnit测试抛出TypeInitializationException问题

核心排查与修复方案 #

1. 补全MAUI运行时初始化 #

xUnit测试默认不会启动MAUI运行时，而AlertService这类依赖MAUI平台的组件必须在初始化环境中才能正常工作：

• 在测试类的构造函数或集合初始化方法中添加MAUI启动代码：

Microsoft.Maui.MauiProgram.CreateBuilder().Build().Start();

• 也可使用MauiTesting.Xunit库简化流程，先安装对应NuGet包，再标记测试集合：

[Collection("MAUI")]
public class SettingsViewModelTests
{
    public SettingsViewModelTests(IMauiTestContext context)
    {
        // 上下文已完成MAUI环境初始化
    }
}

2. 排查静态成员初始化错误 #

TypeInitializationException本质是目标类（或其依赖类）的静态构造函数/静态成员初始化失败：

• 检查SettingsViewModel及依赖类的静态代码块，确认是否有未处理的异常
• 排查是否有静态成员直接依赖DeviceInfo、Preferences等MAUI原生服务，这类服务在未初始化的测试环境中会抛出异常

3. 完整模拟Moq对象的依赖链 #

单独测试AlertService仍失败，说明服务本身依赖的底层接口未被正确模拟：

• 若AlertService依赖IPopupService等原生抽象，需先模拟这些底层依赖，再实例化AlertService：

var mockPopupService = new Mock<IPopupService>();
var alertService = new AlertService(mockPopupService.Object);

// 验证AlertService方法调用逻辑
alertService.ShowAlert("Test Alert");
mockPopupService.Verify(s => s.ShowAsync(It.IsAny<AlertPopup>()), Times.Once);

4. 对齐项目目标配置 #

确保测试项目与主MAUI项目的Windows目标版本完全一致：

• 右键测试项目→属性→目标框架，确认Windows版本（如Windows 10.0.19041.0）与主项目匹配
• 在测试项目的.csproj中移除Mac/Android相关配置，仅保留Windows目标：

<PropertyGroup>
  <TargetFrameworks>net8.0-windows10.0.19041.0</TargetFrameworks>
  <UseMaui>true</UseMaui>
  <SingleProject>true</SingleProject>
</PropertyGroup>

关键调试技巧 #

• 重点查看TypeInitializationException的InnerException，这是触发错误的真正原因
• 启用测试调试模式：在Visual Studio中右键测试用例→调试，逐行跟踪静态初始化流程

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