Cucumber-JVM与Maven Surefire 3.5.3兼容性问题解析

在基于Spring Boot 3和JUnit 5的Java项目中，开发者可能会遇到一个奇怪的现象：虽然Cucumber测试用例能够正常执行并生成测试报告，但Maven构建输出中却显示"Tests run: 0"。更令人困惑的是，即使测试用例失败，构建过程仍然会显示成功。这种现象主要出现在使用Maven Surefire插件3.5.3及以上版本的Spring Boot项目中。

问题现象

当开发者使用以下技术栈组合时：

• Spring Boot 3.x
• JUnit 5
• Cucumber-JVM 7.x
• Maven Surefire插件3.5.3+

执行mvn test命令后，控制台输出会显示：

[INFO] Tests run: 0, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

但实际上Cucumber测试已经执行并生成了测试报告文件（如results.html和results.ndjson）。

问题根源

经过分析，这个问题源于Maven Surefire插件3.5.3版本引入的某些变更与Cucumber-JVM的Spring Boot集成方式存在兼容性问题。具体表现为：

1. Surefire 3.5.3对测试发现机制进行了调整
2. 这种调整影响了Cucumber通过JUnit 5平台运行测试时的报告机制
3. 测试执行结果无法正确反馈给Maven构建系统

解决方案

目前确认的解决方案是将Maven Surefire插件降级到3.5.2版本。在项目的pom.xml文件中进行如下配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.5.2</version>
</plugin>

技术背景

这个问题特别出现在Spring Boot项目中，因为：

1. Spring Boot使用特殊的测试上下文管理机制
2. Cucumber-JVM与Spring Boot集成时需要特殊的配置
3. JUnit 5平台作为测试执行引擎
4. Maven Surefire作为测试执行和报告工具

这四者之间的交互在Surefire 3.5.3版本中出现了断层，导致测试执行结果无法正确上报。

最佳实践

对于使用Cucumber-JVM的Spring Boot项目，建议：

1. 明确指定Maven Surefire插件版本为3.5.2
2. 定期检查Cucumber-JVM和Surefire插件的更新日志
3. 在升级任何相关组件后，验证测试报告机制是否正常工作
4. 考虑在CI/CD流水线中添加测试结果验证步骤

总结

这个兼容性问题展示了现代Java测试生态系统中各组件间复杂的依赖关系。作为开发者，在遇到类似问题时，应当：

1. 首先确认各组件的版本组合
2. 查阅相关组件的变更日志
3. 尝试隔离问题（如不使用Spring Boot时是否重现）
4. 关注社区已知问题

通过理解这些底层机制，开发者可以更高效地解决测试框架集成中的各种问题。