Kafka监听器接收消息时子对象为null的问题解决咨询

我在Kafka接收监听器类中编写了如下代码：

@EnableKafka
@Service
@Component
@Slf4j
public class MessageListener{
@Autowired
@Qualifier("MessageBeanService")
@KafkaListener(topic={"test-topic"}, autoStartup="true", groupId="test-consumer-group")
@Transactional(propagation=Propagation.REQUIRES_NEW)
public void receiveMessage(@Payload String message) throws JsonProcessingException {
ObjectMapper objMapper=new ObjectMapper();
objMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
CartSt msg=objMapper.readValue(message, CartSt.class);
}

CartSt类包含Item、Price、Quantity等子对象，但发现这些子对象反序列化后均为null。使用的是fasterxml.jackson.databind包中的ObjectMapper，请问如何解决该问题，让CartSt的子对象能正确填充非null值？

• 检查字段命名与JSON结构的匹配性
  Jackson默认通过字段名或getter/setter命名推导匹配JSON键。如果JSON采用下划线命名（如item_name）而Java类用驼峰命名（itemName），要么给字段添加@JsonProperty("item_name")指定对应键，要么全局开启驼峰转下划线配置：

  objMapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
  

• 确保所有类存在无参构造函数
  Jackson反序列化必须依赖目标类（包括CartSt和Item、Price、Quantity等子对象）的无参构造函数才能实例化对象，否则会直接返回null。可以用Lombok的@NoArgsConstructor注解快速生成，或者手动编写无参构造。

• 保证子对象字段可被Jackson访问
  如果子对象的字段是private且没有对应的public setter方法，Jackson无法为其赋值，导致子对象为null。解决方式：

  1. 给字段添加Lombok的@Setter注解，或手动编写public setter；
  2. 开启Jackson直接访问字段的配置：

     objMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
     

• 验证Kafka消息的JSON结构有效性
  确认发送的JSON消息确实包含嵌套的子对象数据，而非扁平化的键值对。比如正确的嵌套结构示例：

  {
    "item": {"id": 1, "name": "test-item"},
    "price": {"amount": 99.9, "currency": "USD"},
    "quantity": 3
  }
  

  如果JSON中子对象字段缺失或格式错误，反序列化必然得到null。

• 优化ObjectMapper的使用方式
  每次接收消息都新建ObjectMapper会浪费资源且容易遗漏配置，建议将其配置为全局单例Bean：

  @Bean
  public ObjectMapper objectMapper() {
      ObjectMapper mapper = new ObjectMapper();
      mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
      // 按需添加命名策略、字段可见性等配置
      return mapper;
  }
  

  之后在MessageListener中注入该Bean使用即可。

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