PAYATHON 2026

JetBrains Rider 中 MSTest 挂起后报 dotnet.exe 退出码 0,如何排查?

排障赵师傅

结论

这条错误表示,Rider 记录到 dotnet.exe 以退出码 0 结束,但测试运行器没有按预期完成本次测试会话。退出码 0 只反映进程的退出状态,不能证明测试已经执行或通过。

目前的信息还不足以确定根因,也无法据此认定是 Moq、.NET 8 或 Rider 的某个已知缺陷。最有效的排查顺序是:先在命令行运行同一个测试,确认测试方法是否进入执行,再检查运行器日志和挂起时的线程堆栈。

为什么退出码是 0,Rider 仍然报错?

进程退出状态和测试结果是两回事。Rider 需要获取测试的执行状态和结果。如果测试会话尚未完成,承载测试运行器的进程就已退出,即使退出码是 0,Rider 也可能将这次运行标记为异常。JetBrains 文档说明,无法读取测试运行器的输出会导致测试被标记为异常状态。参见 Rider 测试结果说明。

这里的 JetBrains.Util.LoggerException 是 Rider 侧报告的异常,单凭这段消息无法定位被测代码中的异常。日志中的“进程退出”也不足以证明发生了 CLR 崩溃。

两条日志相隔约 83.9 秒:

12:48:06.061  Discovery result processing finished
12:49:29.975  Process ... exited with code '0'

这段间隔只能说明期间没有显示更多日志,不能证明测试方法执行了这么久,也不能证明存在固定的“90 秒超时”。问题可能出在启动等待、初始化阻塞、测试执行或结束阶段,仍需进一步定位。

先在命令行运行同一个测试

在解决方案目录中执行以下命令,将项目路径和测试完整名称替换为实际值:

dotnet test .\MyTests\MyTests.csproj `
  --framework net8.0 `
  --filter "FullyQualifiedName=MyTests.ServiceTests.MyTest" `
  --logger "console;verbosity=detailed" `
  --diag .\vstest-diag.log

这个示例适用于使用 VSTest 的测试项目。--diag 会记录测试平台的诊断信息,也可能在指定日志旁生成测试宿主等组件的日志。如果项目已显式切换到 Microsoft.Testing.Platform,请使用该平台支持的参数,不能直接套用全部 VSTest 选项。参见 Microsoft 命令文档。

先检查输出,确认选中了目标测试,避免将“没有匹配到测试”误认为执行成功。

命令行表现 下一步
测试通过,Rider 中失败 对比 Rider 和终端的 SDK、运行设置、环境变量及运行方式
同样挂起或提前退出 检查项目配置、测试生命周期代码和测试宿主日志
无法发现目标测试 检查筛选表达式、测试属性及适配器配置
有明确异常或依赖加载错误 优先处理最早出现的错误

命令行测试通过后,排查范围会缩小,但还需要排除运行环境差异,才能判断是否属于 Rider 的问题。

确认挂在测试执行的哪个阶段

在测试方法的第一行和最后一行设置断点。如果第一行始终没有命中,重点检查测试启动和初始化;如果最后一行已经执行,随后才挂起,就检查清理和会话结束阶段。

即使测试方法很简单,测试生命周期中的其他代码也可能影响运行。还需要检查:

  • 测试类及其基类的构造函数、字段初始化。
  • [AssemblyInitialize]、[ClassInitialize]、[TestInitialize]。
  • [TestCleanup]、[ClassCleanup]、[AssemblyCleanup],以及相关资源释放逻辑。

这些初始化和清理方法会在测试方法之外执行。参见 MSTest 生命周期文档。

可以在当前项目中新建一个不继承业务测试基类的测试类:

using Microsoft.VisualStudio.TestTools.UnitTesting;

[TestClass]
public class RunnerSmokeTests
{
    [TestMethod]
    public void Minimal_test_completes()
    {
        Assert.IsTrue(true);
    }
}

单独运行这个测试,然后逐步加入 mock 创建、service 构造和目标方法调用,观察从哪一步开始复现。

同一程序集中的 [AssemblyInitialize] 等逻辑仍可能影响这个最小测试。如果它也挂起,可以再用独立的最小测试项目作对照。

目前没有证据指向 Moq。如果问题稳定出现在某个 mock 的创建、配置或调用阶段,再继续检查对应的 Setup、Callback 或其他相关代码。

查看完整日志,并在挂起期间获取堆栈

在 Rider 的 Unit Tests 窗口中打开会话选项,查看:

Diagnostics | Show Last Launch Log
Diagnostics | Show Last Runner Log

这是 JetBrains 提供的测试执行日志入口,具体位置可能随版本变化。参见 Rider 日志入口说明。

先找最终退出消息之前出现的第一处异常,再检查以下线索:

  • 运行器实际启动的命令、进程和目标程序集。
  • 测试宿主是否启动,是否建立连接。
  • 程序集或依赖项加载失败。
  • 测试开始、结束和清理阶段的记录。
  • 超时、取消或通信中断信息。

需要更详细的信息时,可以按 JetBrains 的说明临时启用测试运行器 TRACE 日志,复现并收集日志后关闭详细记录。参见日志配置说明。

如果进程仍在等待,尽量在它退出前暂停调试器,检查所有线程的调用栈。进程退出后,仅凭退出码通常无法还原等待位置。

如果 VSTest 项目在命令行下也能复现,可以尝试采集挂起转储:

dotnet test .\MyTests\MyTests.csproj `
  --framework net8.0 `
  --filter "FullyQualifiedName=MyTests.ServiceTests.MyTest" `
  --blame-hang `
  --blame-hang-timeout 30s `
  --results-directory .\TestResults

这里的 30s 是人为设置的诊断阈值。达到阈值后,工具会尝试采集挂起转储并终止测试宿主,这会改变本次运行的行为。如果阻塞发生在测试宿主正常启动之前,这种方式未必能获取所需证据。参见挂起诊断参数说明。

根据证据修复,避免一次改动太多

如果只有 Rider 失败,先核对它使用的 .NET CLI 路径、SDK、目标架构、.runsettings 和环境变量是否与命令行一致。也可以比较普通 Run、Debug 和启用覆盖率工具时的运行结果。

如果两边都失败,记录实际使用的 SDK 和包版本:

dotnet --info
dotnet list .\MyTests\MyTests.csproj package --include-transitive

对于使用传统 VSTest 配置的 MSTest 项目,重点核对 Microsoft.NET.Test.Sdk、MSTest.TestAdapter、MSTest.TestFramework,同时检查 Moq 及相关传递依赖。按兼容要求选择版本即可,这些包不需要使用相同的版本号。

如果怀疑构建产物陈旧,可以停止相关测试进程,清理测试项目的 bin、obj 后重新构建。升级 Rider 或调整测试包版本时,每次只改一项,并保留调整前后的日志,以便判断哪个变化有效。

如果问题仍能稳定复现,提交问题时应附上最小复现项目、Rider 版本、dotnet --info、包版本、命令行对照结果及完整运行日志。挂起时的线程堆栈和退出前的日志,比最后一句 exited with code '0' 更有助于诊断这类问题。

备注:内容仅供参考。