Spring Boot库依赖不匹配问题排查求助

我来帮你捋捋这个配置调整后出现的问题——Spring Boot和Cucumber的版本兼容性真的是个容易踩的坑，尤其是你之前应用正常，改了测试配置才出问题，大概率是依赖版本没对齐。

第一步：先确认版本适配关系 #

Cucumber对Spring Boot的版本有明确要求，别搞混了：

• 如果你的Spring Boot是3.x版本，必须用Cucumber 7.x及以上（因为Spring Boot 3切换到了Jakarta EE，Cucumber 7才支持这套API）
• 要是Spring Boot还在2.x，那Cucumber用6.x或者更低版本才稳妥

先核对下你项目里这俩的版本，这是最常见的问题根源。

第二步：揪出依赖冲突 #

你贴的pom代码不完整，不过可以用Maven命令直接看依赖树，找出冲突的地方：

mvn dependency:tree -Dverbose -Dincludes=io.cucumber,org.springframework.boot

这条命令会把所有和Cucumber、Spring Boot相关的依赖列出来，重点看有没有版本不一致的情况——比如某个Cucumber依赖偷偷拉了旧版的Spring组件，或者Spring Boot的依赖覆盖了Cucumber需要的版本。

另外，要保证所有Cucumber相关依赖的版本统一，比如Spring Boot 3.x的正确写法应该是这样：

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-spring</artifactId>
    <version>${cucumber.version}</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-junit-platform-engine</artifactId>
    <version>${cucumber.version}</version>
    <scope>test</scope>
</dependency>

这里的${cucumber.version}要和Spring Boot版本匹配，而且所有Cucumber依赖都要用同一个版本，别有的用7.0，有的用7.5，很容易出问题。

第三步：检查Spring Boot依赖管理的影响 #

如果你用了Spring Boot的parent pom，它会帮你管理很多依赖的版本，但Cucumber不在它的管理范围内，所以你必须手动指定Cucumber的版本，别让Maven自动拉取默认版本（默认版本大概率和你的Spring Boot不兼容）。

还有，spring-boot-starter-test里带的JUnit版本也要注意：Cucumber 7.x必须用JUnit 5（也就是JUnit Platform），如果是Cucumber 6.x，JUnit 4或5都可以，但也要对应上。

第四步：贴完整pom代码（如果还没解决） #

要是上面的步骤都没搞定，建议你把完整的pom.xml贴出来，重点包括：

• Spring Boot parent的版本
• 所有Cucumber相关的依赖
• 测试类的依赖（比如JUnit、spring-boot-starter-test这些）

这样就能更精准地定位到冲突点了。

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