xUnit运行大量测试用例时无法生成XML结果文件问题

问题 #

当我在包含大量测试用例的项目上运行xUnit测试时，不会生成XML结果文件；若将同一项目的测试用例数量缩减为较小规模，则可正常生成结果文件，请问该问题是什么原因导致的？

详细信息 #

我的项目在Jenkins构建中运行约3200个xUnit测试用例，使用如下命令执行测试：

dotnet test --logger:"xunit;LogFilePath=/results/integrationtest_results.xml"

但执行后并未创建integrationtest_results.xml文件，我已确认测试确实已运行，仅未生成结果文件。

当我使用如下命令将测试用例过滤至1000个以内时，能够正常创建integrationtest_results.xml结果文件：

dotnet test --logger:"xunit;LogFilePath=/results/integrationtest_results.xml" --filter:"someAttribute=someValue"

在同一个Jenkins构建任务中，我另有一个运行500个单元测试的项目，使用如下命令执行：

dotnet test --logger:"xunit;LogFilePath=/results/unittest_results.xml"

该命令始终可正常生成预期的unittest_results.xml文件。

在无法生成结果文件的场景中，我未在日志中看到任何与xUnit结果文件相关的错误记录。

环境信息 #

• C# dotnet core 6.0
• Xunit v2.4.1
• 测试日志组件：XunitXml.TestLogger v3.0.70

回答 #

根因分析 #

该问题由旧版XunitXml.TestLogger的实现逻辑和CI环境的进程回收规则共同导致：

1. v3.0.70版本的XunitXml.TestLogger默认采用全量结果存入内存、测试全部结束后一次性写入磁盘的逻辑，不支持流式写入。3200个测试用例附带的执行输出、异常栈、耗时统计等元数据会占用大量内存，而Jenkins构建节点默认给单个进程分配的内存通常低于本地开发环境，序列化大体积XML文件时容易触发静默内存溢出，dotnet进程被系统直接回收，不会执行后续写文件逻辑，也不会输出错误日志。
2. 该版本logger默认通过后台线程执行文件写入操作，CI环境中测试命令执行完成后，父进程会立刻回收所有子线程，不会等待后台IO任务完成。测试用例量小时写入速度快，能在进程回收前完成落盘；测试量大时写入耗时变长，后台线程被强制终止就会出现文件缺失的情况。

解决方案 #

按优先级依次尝试即可：

• 直接升级XunitXml.TestLogger到最新稳定版，新版本已经重构为流式写入逻辑，不需要将全量测试结果缓存在内存中，从底层解决大测试集的写入失败问题。
• 暂时无法升级依赖时，修改测试执行命令，给xUnit logger开启同步写入开关，强制写入逻辑在主线程执行，避免后台线程被提前回收：

dotnet test --logger:"xunit;LogFilePath=/results/integrationtest_results.xml;Synchronous=true"

• 调整Jenkins构建步骤的dotnet进程内存配额，避免大结果集序列化时触发OOM。可以在执行测试命令前配置环境变量DOTNET_GCHeapHardLimit=1073741824，给dotnet进程分配至少1G的可用堆内存。
• 可临时换用dotnet内置的trx日志格式做问题定位：

dotnet test --logger:"trx;LogFileName=/results/integrationtest_results.trx"

trx日志组件是dotnet test框架内置实现，默认采用同步流式写入逻辑，如果该格式下3200个测试能正常生成结果文件，即可完全确认问题出在旧版XunitXml.TestLogger上。

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