如何将格式多变的JSON映射为Java对象？

针对你遇到的这种JSON格式不固定的解析问题，我有几个实用的解决方案，分享给你：

1. 先判断JSON类型再针对性处理（推荐） #

这种方法比盲目尝试解析再捕获异常要更优雅，也更高效。以常用的Jackson库为例，你可以先把JSON解析成JsonNode，然后判断它是数组还是对象，再分别处理：

ObjectMapper mapper = new ObjectMapper();
JsonNode rootNode = mapper.readTree(jsonString);

CustomObj result;
if (rootNode.isArray()) {
    // 处理列表转对象的逻辑，比如你的示例[12, [100, 100, 100]]
    result = new CustomObj();
    // 提取第一个元素作为ID
    result.setId(rootNode.get(0).asInt());
    // 提取第二个数组元素作为RGB值
    JsonNode rgbArray = rootNode.get(1);
    result.setRgb(Arrays.asList(
        rgbArray.get(0).asInt(),
        rgbArray.get(1).asInt(),
        rgbArray.get(2).asInt()
    ));
} else if (rootNode.isObject()) {
    // 直接将对象节点转换为目标Java对象
    result = mapper.treeToValue(rootNode, CustomObj.class);
} else {
    // 处理既不是数组也不是对象的异常情况
    throw new IllegalArgumentException("Unsupported JSON format");
}

这种方式的优势在于逻辑清晰，避免了异常捕获带来的性能开销，而且能精准控制每种格式的转换细节。

2. 尝试解析+捕获异常（备选） #

如果你的场景中可能的JSON类型非常少，也可以用“尝试解析→捕获异常→尝试另一种类型”的思路，但这种方法不够优雅，而且异常处理的开销相对较大：

ObjectMapper mapper = new ObjectMapper();
CustomObj result = null;
try {
    // 先尝试直接解析成目标对象
    result = mapper.readValue(jsonString, CustomObj.class);
} catch (JsonParseException e) {
    try {
        // 解析失败则尝试解析成列表，再转换为对象
        List<Object> jsonList = mapper.readValue(
            jsonString,
            new TypeReference<List<Object>>() {}
        );
        result = convertListToCustomObj(jsonList);
    } catch (JsonProcessingException ex) {
        // 两种解析都失败，抛出真正的格式错误
        throw new IllegalArgumentException("Invalid JSON input", ex);
    }
}

// 辅助转换方法
private CustomObj convertListToCustomObj(List<Object> list) {
    CustomObj obj = new CustomObj();
    obj.setId((Integer) list.get(0));
    List<Integer> rgb = (List<Integer>) list.get(1);
    obj.setRgb(rgb);
    return obj;
}

这种方法适合快速临时解决问题，但长期维护起来不如第一种方法清晰。

3. 自定义反序列化器（优雅封装） #

如果希望把转换逻辑封装起来，让代码更整洁，可以自定义Jackson的反序列化器，统一处理两种格式：

public class CustomObjDeserializer extends JsonDeserializer<CustomObj> {
    @Override
    public CustomObj deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.readValueAsTree();
        
        if (node.isArray()) {
            CustomObj obj = new CustomObj();
            obj.setId(node.get(0).asInt());
            JsonNode rgbNode = node.get(1);
            obj.setRgb(Arrays.asList(
                rgbNode.get(0).asInt(),
                rgbNode.get(1).asInt(),
                rgbNode.get(2).asInt()
            ));
            return obj;
        } else if (node.isObject()) {
            // 复用Jackson自带的对象转换逻辑
            return ctxt.readTreeAsValue(node, CustomObj.class);
        }
        
        throw new IllegalArgumentException("Unsupported JSON type for CustomObj");
    }
}

然后在你的目标对象类上添加注解，指定使用这个反序列化器：

@JsonDeserialize(using = CustomObjDeserializer.class)
public class CustomObj {
    private Integer id;
    private List<Integer> rgb;
    // getter、setter、构造方法省略
}

这样之后，你只需要正常调用mapper.readValue(jsonString, CustomObj.class)，Jackson会自动根据JSON类型选择对应的转换逻辑，代码调用方完全不需要关心格式差异，非常优雅。

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