升级Java17+SpringBoot3后RabbitMQ监听器报类型转换异常

核心原因 #

1. 类加载器不一致 #

Spring Boot 3.x基于Spring 6，对JPMS模块化支持更严格，类加载机制发生变化。如果生产者和消费者端的ScannerPub类由不同类加载器加载，即使全类名完全一致，JVM也会判定为不同类型，导致targetPayloadType.isInstance(payload)返回false。常见场景：

• 多模块项目中，类被重复打包进不同jar，触发类加载器重复加载
• 模块化配置下，类被加载到不同模块的类加载器实例中

2. 序列化元数据格式变化 #

Spring AMQP 3.x默认的Jackson2JsonMessageConverter序列化时的类型标识逻辑有调整：旧版本仅存储全类名，新版本可能附加JPMS模块信息。反序列化时，若消费者端无法识别带模块信息的类型标识，会用不同类加载器加载ScannerPub，引发类型不匹配。

3. Spring Core类型校验逻辑严格化 #

Spring Core 6.x对类型相等性判断做了严谨优化，移除了旧版本中对类加载器差异的兼容逻辑，直接遵循JVM的类相等性规则——只有全类名+类加载器完全一致，才会判定为同一类型。

解决办法 #

1. 排查并统一类加载器 #

• 打印类加载器信息确认差异：

  // 消费者端调试代码
  System.out.println("Payload类加载器: " + payload.getClass().getClassLoader());
  System.out.println("目标类型类加载器: " + targetPayloadType.getClassLoader());
  

• 用依赖分析工具排查重复依赖：Maven执行mvn dependency:tree，Gradle执行./gradlew dependencies，排除多余的ScannerPub所在模块引用。

2. 统一MessageConverter配置 #

显式配置Jackson转换器，强制使用全类名作为类型标识，避免模块信息干扰：

@Configuration
public class RabbitConfig {
    @Bean
    public MessageConverter jackson2JsonMessageConverter() {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.registerModule(new JavaTimeModule());
        // 强制使用全类名作为类型字段，忽略JPMS模块信息
        objectMapper.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL, JsonTypeInfo.As.PROPERTY);
        return new Jackson2JsonMessageConverter(objectMapper);
    }
}

确保生产者和消费者端使用完全相同的MessageConverter配置。

3. 解除模块化类加载隔离（非模块化项目） #

若项目未使用JPMS模块化，添加启动参数禁用模块隔离：

--add-opens ca.bc.gov.open.crdp.process.models=ALL-UNNAMED

或在Maven编译插件中配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <release>17</release>
        <compilerArgs>
            <arg>--add-opens</arg>
            <arg>ca.bc.gov.open.crdp.process.models=ALL-UNNAMED</arg>
        </compilerArgs>
    </configuration>
</plugin>

4. 检查Spring AMQP消息头配置 #

通过RabbitMQ管理控制台查看消息的__TypeId__头，确保仅包含全类名，无附加模块前缀。若存在模块信息，调整序列化逻辑移除。

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