如何动态配置@JsonProperty名称，实现用同一Java类映射结构相似的不同JSON响应

你遇到的问题核心在于@JsonProperty的参数必须是编译时常量，所以没法通过外部传入的变量来动态指定属性名，而且静态内部类也无法访问外部类的非静态字段，这就导致你之前的思路行不通。下面给你几个实用的解决方案：

方法一：使用@JsonAnySetter捕获动态属性 #

这是最简单的方案，适合你这种只有一个动态属性的场景。@JsonAnySetter会自动将所有未匹配到类中字段的JSON属性，调用指定的方法来处理：

@Data
public class QueryResponse {
    private QueryData data;

    @Data
    public static class QueryData {
        // 存储动态属性对应的数据集合
        private Collection<Data> dynamicData;
        // 可选：保存动态属性的名称（比如"Discipline"或"System"）
        private String propertyName;

        // 捕获所有未匹配的JSON属性
        @JsonAnySetter
        public void setDynamicProperty(String key, Collection<Data> value) {
            this.propertyName = key;
            this.dynamicData = value;
        }

        @Data
        public static class Data {
            @JsonProperty("Code")
            private String code;
            @JsonProperty("Description")
            private String description;
        }
    }
}

使用的时候，Jackson会自动把Discipline或System这类动态属性的值赋值给dynamicData，同时你还能通过propertyName知道当前处理的是哪个属性。

方法二：自定义反序列化器（更灵活） #

如果需要对动态属性做更复杂的处理（比如验证属性名合法性、处理多个动态属性等），可以自定义反序列化器来完全控制解析逻辑：

@Data
public class QueryResponse {
    private QueryData data;

    // 指定使用自定义反序列化器
    @JsonDeserialize(using = QueryDataDeserializer.class)
    @Data
    public static class QueryData {
        private String propertyName;
        private Collection<Data> dataItems;

        @Data
        public static class Data {
            @JsonProperty("Code")
            private String code;
            @JsonProperty("Description")
            private String description;
        }
    }

    // 自定义反序列化器
    public static class QueryDataDeserializer extends StdDeserializer<QueryData> {
        protected QueryDataDeserializer() {
            super(QueryData.class);
        }

        @Override
        public QueryData deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
            JsonNode dataNode = p.getCodec().readTree(p);
            QueryData queryData = new QueryData();
            
            // 遍历data节点下的所有属性（这里只会有一个）
            for (Iterator<Map.Entry<String, JsonNode>> iterator = dataNode.fields(); iterator.hasNext(); ) {
                Map.Entry<String, JsonNode> entry = iterator.next();
                queryData.setPropertyName(entry.getKey());
                
                // 将JSON数组转换为Collection<Data>
                ObjectMapper mapper = (ObjectMapper) p.getCodec();
                Collection<QueryData.Data> items = mapper.convertValue(
                    entry.getValue(),
                    new TypeReference<Collection<QueryData.Data>>() {}
                );
                queryData.setDataItems(items);
            }
            return queryData;
        }
    }
}

这种方式可以完全掌控JSON的解析过程，适合复杂的动态场景。

方法三：提前指定属性名（如果反序列化前已知） #

如果在反序列化之前你已经知道要处理的属性名是什么，可以用泛型配合构造器的方式来实现：

@Data
public class QueryResponse {
    private QueryData data;

    @Data
    public static class QueryData {
        private Collection<Data> items;
        private String propertyName;

        // 通过构造器接收动态属性的键值对
        @JsonCreator
        public QueryData(Map<String, Collection<Data>> properties) {
            // 因为只有一个动态属性，直接取第一个键值对
            Map.Entry<String, Collection<Data>> entry = properties.entrySet().iterator().next();
            this.propertyName = entry.getKey();
            this.items = entry.getValue();
        }

        @Data
        public static class Data {
            @JsonProperty("Code")
            private String code;
            @JsonProperty("Description")
            private String description;
        }
    }
}

反序列化的时候直接正常调用ObjectMapper.readValue()即可，Jackson会自动把动态属性封装到Map中传给构造器。

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