如何处理含动态键的JSON到Java POJO的映射问题？

针对你遇到的动态键无法直接映射、List类型触发Jackson异常的问题，提供三个实用解决方案：

方案1：用Map<String, GqCustomPOConfigAttributes>接收动态键 #

JSON中的config-1、config-2本质是键值对结构，直接用Map接收最简便，Jackson会自动将所有以config-开头的键值对映射到Map中。之后可通过Map的values()方法转成List使用。

示例代码：

public class GqCustomPOCAList {
    // 用LinkedHashMap可保留JSON中键的顺序，HashMap不保证顺序
    private Map<String, GqCustomPOConfigAttributes> configMap = new LinkedHashMap<>();

    // 提供转List的方法
    public List<GqCustomPOConfigAttributes> getConfigList() {
        return new ArrayList<>(configMap.values());
    }

    // getter/setter
    public Map<String, GqCustomPOConfigAttributes> getConfigMap() {
        return configMap;
    }

    public void setConfigMap(Map<String, GqCustomPOConfigAttributes> configMap) {
        this.configMap = configMap;
    }
}

方案2：使用@JsonAnySetter注解收集动态键 #

通过Jackson的@JsonAnySetter注解，可捕获所有未被POJO属性匹配的字段，手动将config-*对应的值添加到List中。

示例代码：

public class GqCustomPOCAList {
    private List<GqCustomPOConfigAttributes> configList = new ArrayList<>();

    // 捕获所有未匹配的属性
    @JsonAnySetter
    public void handleDynamicConfig(String key, GqCustomPOConfigAttributes value) {
        // 仅处理以config-开头的键
        if (key.startsWith("config-")) {
            configList.add(value);
        }
    }

    // getter
    public List<GqCustomPOConfigAttributes> getConfigList() {
        return configList;
    }
}

方案3：自定义JSON反序列化器 #

如果需要更精细的控制（比如排序、复杂字段校验），可以自定义Jackson反序列化器，手动解析JSON中的动态键并收集到List里。

示例代码：

// 自定义反序列化器
public class GqCustomPOCAListDeserializer extends JsonDeserializer<GqCustomPOCAList> {
    @Override
    public GqCustomPOCAList deserialize(JsonParser parser, DeserializationContext context) throws IOException {
        JsonNode root = parser.getCodec().readTree(parser);
        GqCustomPOCAList po = new GqCustomPOCAList();
        List<GqCustomPOConfigAttributes> configs = new ArrayList<>();

        // 遍历所有JSON字段
        for (Iterator<Map.Entry<String, JsonNode>> it = root.fields(); it.hasNext(); ) {
            Map.Entry<String, JsonNode> entry = it.next();
            String key = entry.getKey();
            if (key.startsWith("config-")) {
                // 将JsonNode转换为目标对象
                GqCustomPOConfigAttributes config = parser.getCodec().treeToValue(entry.getValue(), GqCustomPOConfigAttributes.class);
                configs.add(config);
            }
        }

        po.setConfigList(configs);
        return po;
    }
}

// 在POJO类上指定反序列化器
@JsonDeserialize(using = GqCustomPOCAListDeserializer.class)
public class GqCustomPOCAList {
    private List<GqCustomPOConfigAttributes> configList;

    // getter/setter
    public List<GqCustomPOConfigAttributes> getConfigList() {
        return configList;
    }

    public void setConfigList(List<GqCustomPOConfigAttributes> configList) {
        this.configList = configList;
    }
}

额外提示 #

• 如果需要保留config-1、config-2的顺序，方案1中建议使用LinkedHashMap，方案2和3会自然保留JSON中的顺序。
• 若只想忽略未识别的字段（不推荐，会丢失数据），可以给ObjectMapper配置configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)，但这只是规避问题而非解决问题。

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