Spring Boot序列化POJO时JSONObject字段解析异常排查

核心问题 #

你遇到的序列化异常，本质是你用的JSONObject类型（大概率是org.json.JSONObject）和Spring Boot默认的Jackson序列化框架不兼容。

Jackson对非原生类型的序列化逻辑是调用对象的getter方法，而org.json.JSONObject的isEmpty()方法会被Jackson识别为属性empty，所以序列化后errors变成了{"empty": false}；如果validationErrors是空的JSONObject，它的isEmpty()返回true，再加上Jackson默认的空值处理规则，就导致这个字段直接消失了。

解决办法 #

给你三个可行的方案，按推荐程度排序：

1. 改用Jackson原生的ObjectNode替换JSONObject
   Spring Boot默认用Jackson处理JSON，ObjectNode是Jackson提供的原生JSON节点类型，能被正确序列化和反序列化。
   示例代码：

   import com.fasterxml.jackson.databind.node.ObjectNode;
   import com.fasterxml.jackson.databind.ObjectMapper;
   
   // 在POJO中定义属性
   private ObjectNode errors;
   private ObjectNode validationErrors;
   
   // 初始化并赋值
   ObjectMapper objectMapper = new ObjectMapper();
   errors = objectMapper.createObjectNode();
   errors.put("user_id", "用户ID不能为空");
   

2. 用Map<String, Object>替代JSONObject
   Map是Java原生集合类型，Jackson对它的序列化逻辑非常成熟，完全不会有兼容性问题，操作逻辑也和JSONObject类似。
   示例代码：

   private Map<String, Object> errors = new HashMap<>();
   private Map<String, Object> validationErrors = new HashMap<>();
   
   // 添加错误信息
   errors.put("password", "密码长度不能少于6位");
   

3. 给org.json.JSONObject添加自定义序列化器
   如果一定要保留org.json.JSONObject类型，可以自定义Jackson序列化器，明确告诉Jackson如何处理它：

   import com.fasterxml.jackson.core.JsonGenerator;
   import com.fasterxml.jackson.databind.JsonSerializer;
   import com.fasterxml.jackson.databind.SerializerProvider;
   import org.json.JSONObject;
   import java.io.IOException;
   
   public class JSONObjectSerializer extends JsonSerializer<JSONObject> {
       @Override
       public void serialize(JSONObject value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
           gen.writeRawValue(value.toString());
       }
   }
   

   然后在POJO的对应属性上添加注解：

   @JsonSerialize(using = JSONObjectSerializer.class)
   private JSONObject errors;
   
   @JsonSerialize(using = JSONObjectSerializer.class)
   private JSONObject validationErrors;
   

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