解决JSON反序列化中的字段命名冲突问题：从`in_queue`到`inQueue`的实战经验

2025-08-08 17:38:03 [pool-3-thread-3] ERROR c.p.s.i.RedisOrderQueueServiceImpl - 处理省市队列异常
org.springframework.data.redis.serializer.SerializationException: 
Could not read JSON: Unrecognized field "in_queue" (class com.phone.entity.CustomerOrder), 
not marked as ignorable (21 known properties: "taskId", "cookie", "userId", "customerName", "city", "inQueue", ...)

{
  "id": 31735,
  "userId": 29,
  "inQueue": 1,  // 修改为驼峰命名
  ...
}

import com.fasterxml.jackson.annotation.JsonProperty;

public class CustomerOrder {
    @JsonProperty("in_queue")  // 告诉Jackson，JSON中的"in_queue"映射到该字段
    private Integer inQueue;
    
    // 其他字段...
}

import com.fasterxml.jackson.databind.PropertyNamingStrategies;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
        return mapper;
    }
}

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;

@JsonIgnoreProperties(ignoreUnknown = true)  // 忽略JSON中多余的字段
public class CustomerOrder {
    private Integer inQueue;
    // 其他字段...
}

import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;

public class CustomerOrderDeserializer extends JsonDeserializer<CustomerOrder> {
    @Override
    public CustomerOrder deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        CustomerOrder order = new CustomerOrder();
        
        // 手动映射字段
        if (node.has("in_queue")) {
            order.setInQueue(node.get("in_queue").asInt());
        }
        // 其他字段...
        
        return order;
    }
}

try {
    CustomerOrder order = objectMapper.readValue(json, CustomerOrder.class);
} catch (JsonProcessingException e) {
    log.error("JSON解析失败，原始数据: {}", json, e);
    throw e;
}

@Test
public void testDeserializeWithSnakeCase() throws JsonProcessingException {
    String json = "{\"in_queue\": 1, \"user_id\": 29}";
    ObjectMapper mapper = new ObjectMapper();
    mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
    
    CustomerOrder order = mapper.readValue(json, CustomerOrder.class);
    assertEquals(1, order.getInQueue());
}