升级SpringBoot至2.7.14后集成测试报EmbeddedKafkaBroker初始化错误

这个错误主要是依赖版本不匹配导致的，具体原因和修复方式如下：

核心问题：版本适配冲突 #

Spring Boot的spring-boot-dependencies对第三方库有版本管理约束，你手动指定的版本和Spring Boot 2.7.14默认适配的版本存在冲突：

• Spring Boot 2.7.14默认适配的Spring Kafka版本是2.8.12，而你使用的2.9.10主要适配Spring Boot 3.x版本，跨版本搭配会引发依赖链冲突；
• 你指定的Apache Kafka客户端（kafka-clients）和服务端（kafka_2.13）版本3.4.1，与Spring Kafka 2.9.x虽理论兼容，但和Spring Boot 2.7.x的依赖体系不匹配，最终导致EmbeddedKafkaBroker初始化时类加载失败。

修复步骤 #

1. 移除手动指定的版本号，依赖Spring Boot自动管理
   让Spring Boot的依赖管理机制自动选择兼容版本，避免手动指定带来的冲突：

   // Kafka
   implementation group: 'org.apache.kafka', name: 'kafka-clients'
   implementation group: 'org.springframework.kafka', name: 'spring-kafka'
   testImplementation group: 'org.springframework.kafka', name: 'spring-kafka-test'
   testImplementation group: 'org.apache.kafka', name: 'kafka_2.13'
   testImplementation group: 'org.apache.kafka', name: 'kafka-metadata'
   

2. 若需手动指定版本，严格遵循适配规则

   • Spring Boot 2.7.x搭配Spring Kafka 2.8.x，对应Apache Kafka版本为3.1.x（Spring Boot 2.7.x默认Kafka版本）；
   • 若要使用Kafka 3.4.x，需搭配Spring Kafka 2.9.x，但需确认项目中其他依赖是否兼容，优先推荐使用Spring Boot默认管理的版本。

3. 清理依赖缓存
   执行Gradle命令清理旧缓存，确保新依赖生效：

   ./gradlew clean build --refresh-dependencies
   

额外排查点 #

如果修复后仍有问题，可检查：

• 用./gradlew dependencies查看依赖树，排查是否有其他依赖引入了冲突的Kafka/Spring Kafka版本，如有则通过exclude排除；
• 测试类中@EmbeddedKafka注解的参数配置是否正确，是否存在非法参数导致初始化失败。

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