Jackson反序列化JSON至Java Map失败，求解决方案

方案一：调整JSON结构适配Java Map #

如果可以修改JSON格式，直接将labelValues从单个键值对对象的数组改为键值对对象，就能直接匹配Java类中的Map<String,String>类型。

原JSON（引发异常的格式）：

{
  "labelValues": [
    {"env": "prod"},
    {"region": "us-east-1"}
  ]
}

修改后的JSON（适配Map）：

{
  "labelValues": {
    "env": "prod",
    "region": "us-east-1"
  }
}

修改后无需调整Java类，Jackson可直接完成解析。

方案二：重构Java类适配现有JSON #

如果不能修改JSON格式，有两种常见处理方式：

方式1：自定义反序列化器 #

在Java类的labelValues字段上添加自定义反序列化器，将数组中的单个键值对对象合并为Map：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.JsonNode;
import java.io.IOException;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;

public class MetricData {
    @JsonDeserialize(using = LabelValuesDeserializer.class)
    private Map<String, String> labelValues;

    // getter、setter方法
}

class LabelValuesDeserializer extends JsonDeserializer<Map<String, String>> {
    @Override
    public Map<String, String> deserialize(JsonParser parser, DeserializationContext context) throws IOException {
        Map<String, String> resultMap = new HashMap<>();
        JsonNode arrayNode = parser.getCodec().readTree(parser);
        
        if (arrayNode.isArray()) {
            for (JsonNode node : arrayNode) {
                if (node.isObject()) {
                    Iterator<Map.Entry<String, JsonNode>> fieldIterator = node.fields();
                    while (fieldIterator.hasNext()) {
                        Map.Entry<String, JsonNode> entry = fieldIterator.next();
                        resultMap.put(entry.getKey(), entry.getValue().asText());
                    }
                }
            }
        }
        return resultMap;
    }
}

方式2：使用中间列表类型，再合并为Map #

先定义匹配JSON数组结构的字段，再通过辅助方法合并为Map：

import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class MetricData {
    private List<Map<String, String>> labelValues;

    // 原有字段的getter、setter
    public List<Map<String, String>> getLabelValues() {
        return labelValues;
    }

    public void setLabelValues(List<Map<String, String>> labelValues) {
        this.labelValues = labelValues;
    }

    // 辅助方法：将数组中的键值对合并为单个Map
    public Map<String, String> getMergedLabelValues() {
        Map<String, String> mergedMap = new HashMap<>();
        if (labelValues != null) {
            for (Map<String, String> entry : labelValues) {
                mergedMap.putAll(entry);
            }
        }
        return mergedMap;
    }
}

这种方式无需自定义反序列化器，直接利用Jackson默认解析能力，再通过业务逻辑合并为所需的Map结构。

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