Spring Boot 3.2.2升级后EmbeddedKafka测试报NoSuchFieldError:id

问题概述 #

将组件从Spring Boot 2.7.18升级至3.2.2后，所有基于spring-kafka的EmbeddedKafka测试均失败，抛出Spring初始化错误：

java.lang.NoSuchFieldError: id
        at kafka.server.Defaults$.<clinit>(KafkaConfig.scala:187) ~[kafka_2.13-3.6.1.jar:na]
        at kafka.server.KafkaConfig$.<clinit>(KafkaConfig.scala:746) ~[kafka_2.13-3.6.1.jar:na]
        at kafka.server.KafkaConfig.DeleteTopicEnableProp(KafkaConfig.scala) ~[kafka_2.13-3.6.1.jar:na]
        at org.springframework.kafka.test.EmbeddedKafkaKraftBroker.addDefaultBrokerPropsIfAbsent(EmbeddedKafkaKraftBroker.java:256) ~[spring-kafka-test-3.1.1.jar:3.1.1]
        ...

核心原因分析 #

这个错误的本质是Scala版本二进制不兼容：

• Spring Boot 3.2.2依赖的kafka_2.13-3.6.1是基于Scala 2.13编译的；
• 你的测试依赖中引入了org.scala-lang:scala3-library_3:3.3.1，Scala 3与Scala 2.13的二进制格式不兼容，导致Kafka的Scala代码在初始化时无法找到预期的id字段（该字段是Kafka内部配置类的属性，因版本冲突导致反射加载失败）。

解决步骤 #

1. 移除冲突的Scala 3依赖
   从dependencies中删除这一行：

   testImplementation('org.scala-lang:scala3-library_3:3.3.1')
   

   Spring Boot 3.2.2的spring-kafka-test已经依赖了兼容的Scala 2.13库，无需额外引入Scala 3。

2. 清理并刷新依赖
   执行Gradle命令清理旧依赖并重新构建：

   ./gradlew clean build --refresh-dependencies
   

3. 重新运行测试
   启动EmbeddedKafka测试，验证错误是否消失。

排查Scala代码调用的方法 #

针对IntelliJ控制台行号与实际Scala代码不匹配的问题，可以通过以下方式定位：

• 查看Kafka官方源码：找到kafka_2.13-3.6.1版本的KafkaConfig.scala，定位第187行的Defaults$初始化逻辑，确认涉及的id字段相关代码（实际是Kafka内部配置的属性定义）。
• 反编译依赖包：在IntelliJ中找到项目依赖的kafka_2.13-3.6.1.jar，打开kafka.server.Defaults类，查看反编译后的Java代码，分析初始化时的字段加载逻辑，确认是否因Scala版本差异导致字段签名变化。
• 检查依赖树：运行./gradlew dependencies，搜索所有scala-lang相关依赖，确认是否存在Scala 2.13与Scala 3共存的情况，这是冲突的核心线索。

额外验证点 #

• 对比其他成功运行的Spring Boot 3.2.2组件的依赖树，确认它们未引入Scala 3库，或已正确排除冲突版本。
• 确保spring-kafka与spring-kafka-test版本一致（当前均为3.1.1，符合Spring Boot 3.2.2的依赖管理），避免版本不匹配引发的问题。

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