Java（Spring Boot API）中有没有处理灵活可变结构JSON的方法？

方案1：直接使用动态类型接收/返回JSON #

不需要定义固定POJO，直接用通用类型承接任意结构的JSON，Spring Boot内置的Jackson序列化器原生支持该特性：

• 可选的通用类型有两种：
  • Map<String, Object>：可以直接通过键值对方式读写所有JSON字段，适合简单的存取场景
  • Jackson自带的JsonNode：类型安全，不需要手动强转，内置了大量类型判断、字段读取方法，适合需要对动态字段做复杂处理的场景
• 控制器示例代码：

// 使用JsonNode的示例
@PostMapping("/json/manage")
public JsonNode handleDynamicJson(@RequestBody JsonNode jsonData) {
    // 读取固定字段：String name = jsonData.get("name").asText();
    // 读取未来新增的数组字段：JsonNode dataArray = jsonData.get("data_array");
    // 处理逻辑直接操作JsonNode即可，不需要修改代码就能适配后续JSON结构调整
    return jsonData;
}

方案2：半固定POJO兼容动态扩展 #

如果需要保留部分固定字段的强类型优势，可以在POJO上添加Jackson注解实现兼容：

• 给POJO加@JsonIgnoreProperties(ignoreUnknown = true)注解，JSON新增字段不会触发序列化报错，已有固定字段可以正常映射
• 搭配@JsonAnySetter、@JsonAnyGetter注解可以自动把所有未匹配的扩展字段存入Map，序列化时自动展开到JSON根节点，不需要调整POJO结构就能兼容新增字段
• 示例代码：

@JsonIgnoreProperties(ignoreUnknown = true)
public class UserData {
    // 固定字段保留强类型
    private String name;
    private String surname;

    // 存储所有扩展字段
    @JsonAnySetter
    private Map<String, Object> extraFields = new HashMap<>();

    @JsonAnyGetter
    public Map<String, Object> getExtraFields() {
        return extraFields;
    }
    // 固定字段的getter、setter省略
}

注意事项 #

• 如果需要对动态字段做校验，自行编写逻辑判断对应键是否存在、值类型是否符合要求即可，不需要依赖POJO校验注解
• 持久化存储时如果需要兼容动态结构，可以直接把JSON序列化为字符串存入关系型数据库的text类型字段，或者直接使用MongoDB这类文档型数据库，不需要修改表结构就能适配JSON结构变更

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