如何对使用MainThread类的MAUI应用代码段进行单元测试？

问题描述 #

我正在用xUnit对MAUI应用的ViewModel类做单元测试，测试时发现以下代码片段无法正常执行：

if (MainThread.IsMainThread)
{
    DoSomething();
}
else
{
    MainThread.BeginInvokeOnMainThread(DoSomething);
}

触发的异常信息如下：

Microsoft.Maui.ApplicationModel.NotImplementedInReferenceAssemblyException:
'This functionality is not implemented in the portable version of this
assembly. You should reference the NuGet package from your main
application project in order to reference the platform-specific implementation.'

希望在不用专门为单元测试设置条件符号的前提下解决问题，请问有没有遗漏的xUnit配置方式？

解决方案 #

xUnit本身没有直接配置项能解决这个问题，异常本质是MAUI的MainThread类在非平台测试环境下缺少具体实现。以下两种无需条件编译的方案可以解决：

1. 依赖注入抽象接口隔离平台依赖 #

通过抽象接口封装主线程操作，让ViewModel依赖接口而非具体的MainThread类：

• 定义抽象接口：

  public interface IMainThreadService
  {
      bool IsMainThread { get; }
      void BeginInvokeOnMainThread(Action action);
  }
  

• MAUI项目中实现接口：

  public class MainThreadService : IMainThreadService
  {
      public bool IsMainThread => MainThread.IsMainThread;
  
      public void BeginInvokeOnMainThread(Action action)
      {
          MainThread.BeginInvokeOnMainThread(action);
      }
  }
  

• 修改ViewModel通过构造函数注入接口：

  public class YourViewModel
  {
      private readonly IMainThreadService _mainThreadService;
  
      public YourViewModel(IMainThreadService mainThreadService)
      {
          _mainThreadService = mainThreadService;
      }
  
      public void YourMethod()
      {
          if (_mainThreadService.IsMainThread)
          {
              DoSomething();
          }
          else
          {
              _mainThreadService.BeginInvokeOnMainThread(DoSomething);
          }
      }
  
      private void DoSomething()
      {
          // 原有业务逻辑
      }
  }
  

• 单元测试时用Mock框架（如Moq）模拟接口实现：

  [Fact]
  public void YourMethod_ExecutesDoSomething()
  {
      var mockMainThread = new Mock<IMainThreadService>();
      mockMainThread.Setup(m => m.IsMainThread).Returns(true);
      mockMainThread.Setup(m => m.BeginInvokeOnMainThread(It.IsAny<Action>()))
                    .Callback<Action>(action => action());
  
      var viewModel = new YourViewModel(mockMainThread.Object);
      viewModel.YourMethod();
  
      // 根据业务逻辑添加断言，验证DoSomething是否执行
  }
  

2. 替换MAUI MainThread的测试实现 #

如果不想修改ViewModel代码，可以在测试项目中替换MainThread的默认实现：

• 编写测试用的IMainThread实现：

  public class TestMainThread : IMainThread
  {
      public bool IsMainThread => true;
  
      public void BeginInvokeOnMainThread(Action action)
      {
          action();
      }
  
      public Task InvokeOnMainThreadAsync(Action action)
      {
          action();
          return Task.CompletedTask;
      }
  
      public Task<T> InvokeOnMainThreadAsync<T>(Func<T> func)
      {
          return Task.FromResult(func());
      }
  }
  

• 在测试初始化时替换MainThread：

  [CollectionDefinition("MAUI Test Collection")]
  public class MauiTestCollection : ICollectionFixture<MauiTestFixture>
  {
  }
  
  public class MauiTestFixture
  {
      public MauiTestFixture()
      {
          MainThread.SetCurrent(new TestMainThread());
      }
  }
  

• 测试类标记使用该集合：

  [Collection("MAUI Test Collection")]
  public class YourViewModelTests
  {
      [Fact]
      public void YourMethod_Test()
      {
          var viewModel = new YourViewModel();
          viewModel.YourMethod();
  
          // 添加断言逻辑
      }
  }
  

这两种方案都无需添加条件编译符号，核心是通过抽象或替换实现，隔离MAUI的平台依赖，让单元测试能在非平台环境下正常执行。

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