如何通过Jenkins构建步骤执行指定测试类

核心原因：未使用测试类的完全限定名 #

NUnit的--where参数中，class条件匹配的是测试类的完全限定名（命名空间+类名），仅写类名会导致NUnit无法定位到目标测试类，这是此类问题最常见的触发点。

具体修复步骤 #

1. 获取测试类的完全限定名

   • 打开测试项目，找到BaseActionsTests类，查看文件顶部的namespace声明。比如命名空间是DTAF.Tests，那么完全限定名就是DTAF.Tests.BaseActionsTests。
   • 也可以直接运行不带--where的NUnit命令，查看输出的测试结果，里面会显示每个测试类的完整名称。

2. 修改--where参数写法
   将命令中的类名替换为完全限定名，示例如下：

   C:\Users\<username>\Downloads\NUnit.Console-3.16.1\bin\nunit3-console.exe "%WORKSPACE%\\tree\main\DTAF\DTAF\DTAF\bin\debug\DTAF.dll" --where "class == DTAF.Tests.BaseActionsTests"
   

3. 排查其他潜在问题

   • 检查大小写：NUnit的--where匹配严格区分大小写，确保完全限定名的大小写和代码中的一致。
   • 验证引号转义：如果完全限定名包含特殊字符，可在Batch中对特殊字符额外转义；普通命名空间+类名用当前引号写法即可正常工作。
   • 尝试包含匹配：可以用~做模糊匹配（比如class ~ BaseActionsTests），但优先推荐完全匹配以避免误触其他同名类。

快速验证方法 #

如果不确定完全限定名，先运行以下命令查看DLL中所有测试类的完整元数据：

C:\Users\<username>\Downloads\NUnit.Console-3.16.1\bin\nunit3-console.exe "%WORKSPACE%\\tree\main\DTAF\DTAF\DTAF\bin\debug\DTAF.dll" --explore

执行后找到BaseActionsTests的完整名称，再替换到--where参数中即可。

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