--- theme: channing-cyan --- ### 前言 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/606a43cc826a4b33956f188f6a965c84~tplv-k3u1fbpfcp-zoom-1.image) 最近在接到了一个需求，大概是通过RabbitMq给xx子系统同步用户数据，要提供单个同步和批量同步。内心暗喜这不简单的很嘛。三下五除二就把代码给写完了，大概长这样： ```java public void syncUserSingle(User user) { // 省略一大堆业务代码 rabbitTemplate.convertAndSend("q_sync_user_single", user); } public void syncUserBatch(List userList) { // 省略一大堆业务代码 rabbitTemplate.convertAndSend("q_sync_user_batch", userList); } ``` 但是在联调的过程中，遇到了一个比较奇葩的问题。单个用户进行同步时，子系统可以正常消费。然后进行批量同步的时候，子系统报错了。并抛出`java.lang.ClassCastException`提示 `LinkedHashMap cannot xxxx class` 。于是负责子系统的哥们笑嘻嘻的（表面笑嘻嘻）走过来对我说，不是约定List 为啥发个Map过来？看到这个错误，着实让我摸不到头脑。顿时一堆疑问用上心头，为啥单个对象可以，List就不行呢？我发的是List数据，为啥变成Map了？虽然一大堆疑问，但是只能笑嘻嘻的说，我检查一下哈。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/6f4238b075114f53b8e50fde0fba6087~tplv-k3u1fbpfcp-zoom-1.image) ### 问题重现 - 项目依赖 ```xml 4.0.0 org.springframework.boot spring-boot-starter-parent 2.3.2.RELEASE org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-amqp ``` #### 发送方 - 初始化队列 ```java @Configuration public class QueueConfig { @Bean public Queue test() { return new Queue("test"); } } ``` - 配置RabbitTemplete ```java @Configuration public class RabbitTemplateConfig { @Autowired public RabbitTemplateConfig(RabbitTemplate rabbitTemplate) { // 设置Json消息转换器 rabbitTemplate.setMessageConverter(new Jackson2JsonMessageConverter()); } } ``` - 发送接口 ```java @Controller @RequestMapping("/test") public class TestController { @Resource private RabbitTemplate template; @GetMapping("/send") public void send() { template.convertAndSend("test", Collections.singletonList(new User(20, "不一样的科技宅"))); } } ``` - User类 ```java @Data @AllArgsConstructor public class User { /** * 年龄 */ private Integer age; /** * 姓名 */ private String name; } ``` #### 接收方 - 监听配置 ```java @Configuration public class RabbitListenerConfig { @Bean public SimpleRabbitListenerContainerFactory customFactory(SimpleRabbitListenerContainerFactoryConfigurer configurer, ConnectionFactory connectionFactory) { SimpleRabbitListenerContainerFactory factory = new SimpleRabbitListenerContainerFactory(); // 设置消息转换器 factory.setMessageConverter(new Jackson2JsonMessageConverter()); configurer.configure(factory, connectionFactory); return factory; } } ``` - 接收方 ```java @Service public class UserService { public void save(List userList) { userList.forEach(System.out::println); } } ``` ```java @Component public class Receiver { @Resource private UserService userService; @RabbitListener(queues = "test", containerFactory = "customFactory") public void receive(@Payload List msg) { userService.save(msg); } } ``` ### 错误日志 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/7ee9e5bb8ed14a37b693c69f43a3297c~tplv-k3u1fbpfcp-zoom-1.image) > 好家伙果然失败了，这百分百必现的bug呀。 ### 分析问题原因首先错误信息是在消费端抛出来的，按理应该是消费端出问题概率较大。但是如果和他说的一样，我生产端发送的消息就是错误的，从而导致消费端出问题呢？这对这个疑问，我先断开消费端，然后发送一条消息，并通过Rabbitmq的管控台来查看消息的内容是否正确。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/0d052a3d59ce4ff996600c0e6c1538da~tplv-k3u1fbpfcp-zoom-1.image) 消息内容如下图所示： ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/dd211c89fafd46aab7174ddb24161685~tplv-k3u1fbpfcp-zoom-1.image) 通过上图可以发现，消息体(payload)是一个标准的json串，并且TypeId也是`List`，并不是错误信息中的`LinkedHashMap`。哈哈哈，到此可以石锤是消费端反序列化的问题了。赶紧把锅甩出去，抽他呀的（自嗨而已），我写的代码怎么可能有bug。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/8be39d6b89a64aba8e2cd7d53b9880b1~tplv-k3u1fbpfcp-zoom-1.image) 对我爱学习的我，肯定不愿意就这样算了。必须刨根问底，给他上一课。于是我在google一圈发现这竟然是这个bug。有个老哥也发现了，并提交了一个issues: [spring-ampq/issues/1279](https://github.com/spring-projects/spring-amqp/issues/1279)。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/43b864117369482a85801685e5a456e1~tplv-k3u1fbpfcp-zoom-1.image) 大致是说：尝试从 Spring Boot 2.3.1 升级到 2.3.3，然后再升级到 2.3.6。错误信息依然是：`List foos`是LikedHashMap，而不是Foo对象。并通过远程调试确认了这种情况。出于某种原因，他认为没有正确使用泛型类型。恢复到 Spring-AMQP 2.2.7 使它再次工作，并且对象确实是Foo。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/4f64f889390744409612c8912878a678~tplv-k3u1fbpfcp-zoom-1.image) 然后garyrussell这个人说：他们添加了对抽象类反序列化的支持，如果配置不正确，这会对消息转换器产生一些副作用。然后调查了一下，确认这是一个错误。是由于List是抽象的，新代码认为它不能反序列化。解决方法是： ```java converter.setAlwaysConvertToInferredType(true); ``` 后面还提到在 [GH-1729: Fix JSON Regression](https://github.com/spring-projects/spring-amqp/pull/1280)修复这个问题，修复的代码如下： ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/33175ddb4fc94b9f967d4adfdc9c65f2~tplv-k3u1fbpfcp-zoom-1.image) 通过阅读代码发现，修改前的逻辑是: 如果推断类型是抽象的，则返回false也就代表不能转换成推断类型。然后被转换成LinkedHashMap。这也就是出现 `LinkedHashMap cannot cast xxxx class`的主要原因。修改后变成了：如果推断类型是抽象的并且不是容器类型，返回false。也就意味着，虽然推断类型是抽象的，但是如果是容器类型，并且容器内的对象不是抽象的，则可以被转换。这样一来避免了上述问题的产生了。前面还提到了通过增加配置来解决。解决起来就相对简单粗暴了，始终转换推断类型。 ### 解决办法到此问题分析完毕，简单总结一下解决方法。主要有两种： 1. 在消费端开启如下配置即可： ```java // 始终转换推断类型 converter.setAlwaysConvertToInferredType(true); ``` 2. 升级版本：由于[GH-1729: Fix JSON Regression](https://github.com/spring-projects/spring-amqp/pull/1280)合并到了2.2.13.RELEASE。所以只需要将 spring-amqp 升级到 2.2.13.RELEASE 或以上。或者升级SpringBoot版本到2.3.7.RELEASE。 ### 结尾如果觉得对你有帮助，可以多多评论，多多点赞哦，也可以到我的主页看看，说不定有你喜欢的文章，也可以随手点个关注哦，谢谢。我是不一样的科技宅，每天进步一点点，体验不一样的生活。我们下期见！