Jackson自定义反序列化器丢失前置字段问题及解决方案咨询

问题原因 #

Jackson默认采用流式逐字段反序列化机制：当解析到Product类的store_condition字段时，JSON解析器的指针已经移动到该字段对应的位置，前面的store_code等字段已经被读取过，无法回溯。

你当前的StoreConditionDeserializer里连续两次调用jp.getCodec().readValue(jp, JsonNode.class)，第一次会读取当前指针位置的store_condition字段值（也就是"F"），第二次会尝试读取下一个JSON节点（比如location），完全无法获取到store_code这类已解析过的前置字段，这就是问题的核心。

解决办法 #

方案1：构造函数注入（推荐） #

放弃字段级自定义反序列化器，改用@JsonCreator标注的构造函数，一次性获取所有需要的JSON字段，直接在构造逻辑中生成StoreCondition：

修改Product类如下：

@Getter
@ToString
@JsonIgnoreProperties(ignoreUnknown = true)
public class Product implements Serializable {

    private String itemName;
    private String itemCode;
    private boolean isDemandItem;
    private long upcCode;
    private StoreCondition storeCondition;

    // 其他字段省略...

    @JsonCreator
    public Product(
            @JsonProperty("item_name") String itemName,
            @JsonProperty("item_code") @JsonDeserialize(using = CommonDeserializer.Trim.class) String itemCode,
            @JsonProperty("demand_status") @JsonDeserialize(using = ProductDeserializer.DemandStatus.class) boolean isDemandItem,
            @JsonProperty("upc") long upcCode,
            @JsonProperty("store_condition") String storeCondValue,
            @JsonProperty("store_code") String storeCode,
            @JsonProperty("location") String location,
            @JsonProperty("W_Code") String wCode
    ) {
        this.itemName = itemName;
        this.itemCode = itemCode;
        this.isDemandItem = isDemandItem;
        this.upcCode = upcCode;
        // 在这里组合所有需要的字段生成StoreCondition，包括API调用等逻辑
        this.storeCondition = buildStoreCondition(storeCondValue, storeCode, location, wCode);
    }

    // 封装StoreCondition的构建逻辑
    private StoreCondition buildStoreCondition(String condValue, String storeCode, String location, String wCode) {
        // 你的业务逻辑、API调用等
        return new StoreCondition(...);
    }
}

这种方式不需要额外的字段反序列化器，所有依赖字段都能直接获取，逻辑更清晰。

方案2：类级自定义反序列化器 #

如果要保留原有字段结构，可以编写类级别的反序列化器，一次性读取完整JSON节点后再逐个解析：

1. 编写类级反序列化器：

public class ProductDeserializer extends JsonDeserializer<Product> {
    @Override
    public Product deserialize(JsonParser jp, DeserializationContext context) throws IOException {
        // 一次性读取整个JSON为JsonNode
        JsonNode rootNode = jp.getCodec().readValue(jp, JsonNode.class);

        // 解析各个字段，可复用原有反序列化器的逻辑
        String itemName = rootNode.get("item_name").asText();
        String itemCode = new CommonDeserializer.Trim().deserialize(
                new TreeTraversingParser(rootNode.get("item_code")), context);
        boolean isDemandItem = new ProductDeserializer.DemandStatus().deserialize(
                new TreeTraversingParser(rootNode.get("demand_status")), context);
        long upcCode = rootNode.get("upc").asLong();

        // 获取生成StoreCondition需要的所有字段
        String storeCondValue = rootNode.get("store_condition").asText();
        String storeCode = rootNode.get("store_code").asText();
        String location = rootNode.get("location").asText();
        String wCode = rootNode.get("W_Code").asText();

        // 构建StoreCondition
        StoreCondition storeCondition = new StoreCondition(...); // 你的业务逻辑

        // 组装Product对象
        Product product = new Product();
        product.setItemName(itemName);
        product.setItemCode(itemCode);
        product.setDemandItem(isDemandItem);
        product.setUpcCode(upcCode);
        product.setStoreCondition(storeCondition);

        return product;
    }
}

2. 在Product类上标注该反序列化器：

@Getter
@Setter // 需要添加Setter或者用全参构造函数初始化
@ToString
@JsonIgnoreProperties(ignoreUnknown = true)
@JsonDeserialize(using = ProductDeserializer.class)
public class Product implements Serializable {
    // 字段定义保持不变
    private String itemName;
    private String itemCode;
    private boolean isDemandItem;
    private long upcCode;
    private StoreCondition storeCondition;
    // 其他字段省略...
}

方案3：预读取完整JSON节点（不推荐） #

先把整个JSON读取为JsonNode，再转换成Product，这种方式可以保留部分字段反序列化器，但需要额外处理字段传递，效率和可读性不如前两种：

ObjectMapper mapper = new ObjectMapper();
// 先读取完整JSON
JsonNode rootNode = mapper.readTree(jsonInput);
// 再转换为Product
Product product = mapper.treeToValue(rootNode, Product.class);

如果要在StoreConditionDeserializer中访问其他字段，还需要通过上下文传递rootNode，实现起来比较繁琐。

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