基于MsTest v2的.NET 5项目dotnet test单元测试无法并行执行

常见原因及对应解决方法 #

• 未安装适配版本的MSTest相关包
  仅安装MSTest.TestFramework无法启用并行能力，需同时安装版本一致的MSTest.TestAdapter，且包版本需≥2.2.3才可支持方法级并行，同时需配套安装Microsoft.TestPlatform.TestHost。
  解决方法：修改测试项目.csproj文件中的包引用配置，示例如下：

  <PackageReference Include="MSTest.TestAdapter" Version="2.2.10" />
  <PackageReference Include="MSTest.TestFramework" Version="2.2.10" />
  <PackageReference Include="Microsoft.TestPlatform.TestHost" Version="17.2.0" />
  

  修改后执行dotnet restore再重新运行测试即可。
  注意：两个MSTest相关包的版本必须严格一致，否则会出现适配异常

• 代码中显式禁用了并行
  若程序集、测试类或测试方法上标记了[DoNotParallelize]特性，对应范围的测试会强制串行执行；若测试逻辑依赖未隔离的静态共享资源、加了排他锁，也会出现串行运行的假象。
  解决方法：

  1. 全局搜索代码中的[DoNotParallelize]特性，移除不必要的并行禁用配置
  2. 优化测试逻辑，避免共享独占资源，保证测试用例的独立性

• runsettings配置未正常加载
  命令中使用的相对路径解析错误会导致配置文件未被识别，并行规则不生效。
  解决方法：

  1. 先切换到项目根目录再执行测试命令，简化路径引用：

     cd projectRepo
     dotnet test --settings:test.runsettings
     

  2. 可将并行配置直接写入测试项目的AssemblyInfo.cs文件，优先级高于runsettings配置，示例如下：

     [assembly: Parallelize(Workers = 3, Scope = ExecutionScope.MethodLevel)]
     

• 多测试项目未启用程序集级并行
  原有配置仅控制单测试程序集内的并行逻辑，若存在多个测试项目，需额外添加程序集级并行配置。
  解决方法：修改test.runsettings，新增RunConfiguration节点配置：

  <?xml version="1.0" encoding="utf-8"?>
  <RunSettings>
    <RunConfiguration>
      <!-- 配置同时运行的测试程序集数量，设为0时使用CPU核心数作为最大值 -->
      <MaxCpuCount>3</MaxCpuCount>
    </RunConfiguration>
    <MSTest>
      <Parallelize>
        <Workers>3</Workers>
        <Scope>MethodLevel</Scope>
      </Parallelize>
    </MSTest>
  </RunSettings>
  

• SDK版本兼容问题
  旧版本.NET 5 SDK与高版本MSTest适配器存在兼容问题，会导致并行配置失效。
  解决方法：

  1. 升级.NET 5 SDK到最新补丁版本，项目允许的情况下可升级到.NET 6 LTS版本
  2. 运行测试时添加--no-build参数，确保运行的是最新编译的测试程序集：

     dotnet test --settings:test.runsettings --no-build
     

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