Jackson-databind映射JSON时如何跳过指定层级直接绑定内层字段

结论 #

Jackson 原生的 @JsonProperty 注解本身不支持直接配置点分隔的属性路径，来跳过外层层级绑定嵌套字段，不过有三种常用的原生实现方案可以满足你的需求：

方案1：使用中转内部类（无自定义逻辑，代码侵入性低） #

不需要修改反序列化流程，仅需新增一个轻量内部类承接外层response层级即可：

public class Response {
    @JsonProperty("status")
    private String status;
    
    @JsonProperty("response")
    private ResponseInner responseInner;

    // 直接对外暴露entries的访问方法
    public Collection<ResponseEntry> getEntries() {
        return responseInner == null ? Collections.emptyList() : responseInner.entries;
    }

    // 内部中转类仅做层级承接
    private static class ResponseInner {
        @JsonProperty("entries")
        private Collection<ResponseEntry> entries;
    }
    // 省略status的getter/setter
}

方案2：自定义字段反序列化器（代码最简洁，无额外类定义） #

针对entries字段单独指定自定义反序列化逻辑，直接读取嵌套路径的内容：

1. 先定义字段级反序列化器：

public class EntriesDeserializer extends StdDeserializer<Collection<ResponseEntry>> {
    public EntriesDeserializer() {
        super(Collection.class);
    }

    @Override
    public Collection<ResponseEntry> deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode rootNode = p.getCodec().readTree(p);
        JsonNode entriesNode = rootNode.path("response").path("entries");
        return p.getCodec().convertValue(entriesNode, new TypeReference<Collection<ResponseEntry>>() {});
    }
}

2. 给对应字段添加反序列化注解：

public class Response {
    @JsonProperty("status")
    private String status;
    
    @JsonDeserialize(using = EntriesDeserializer.class)
    private Collection<ResponseEntry> entries;
    // 省略getter/setter
}

方案3：手动解析JSON树（灵活度最高，适合临时映射场景） #

不需要修改Response类的定义，在反序列化调用时手动提取嵌套字段：

ObjectMapper objectMapper = new ObjectMapper();
JsonNode root = objectMapper.readTree(jsonStr);
// 组装Response对象
Response response = new Response();
response.setStatus(root.get("status").asText());
// 提取嵌套entries
Collection<ResponseEntry> entries = objectMapper.convertValue(
    root.path("response").path("entries"),
    new TypeReference<Collection<ResponseEntry>>() {}
);
response.setEntries(entries);

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