Spring Boot @RequestBody接收嵌套org.json.JSONObject字段为空怎么办

架构老林

2026-9-24

问题原因

Spring Boot 默认使用 Jackson 作为 HTTP 请求体的序列化/反序列化工具，Jackson 原生不支持org.json包下的JSONObject、JSONArray类型的映射逻辑，因此只能给对应字段初始化空对象，无法解析请求中对应的嵌套JSON内容。

解决方案

方案1：使用Jackson原生`JsonNode`类型（最推荐，无需额外配置）

直接修改请求实体类的jsonField字段类型为Jackson自带的com.fasterxml.jackson.databind.JsonNode，即可自动完成反序列化：

import com.fasterxml.jackson.databind.JsonNode;

public class Request {
    private String field1;
    private JsonNode jsonField;
}

如果后续业务需要使用org.json.JSONObject，可以通过如下代码转换：

org.json.JSONObject jsonObj = new org.json.JSONObject(jsonField.toString());

方案2：添加Jackson对org.json的适配依赖（保留JSONObject类型）

如果业务逻辑必须使用org.json.JSONObject作为字段类型，可以添加Jackson官方的org.json适配模块：

引入Maven依赖（Gradle可对应调整坐标）

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-json-org</artifactId>
</dependency>

注册适配模块到Jackson容器，添加如下配置类即可：

import com.fasterxml.jackson.datatype.jsonorg.JsonOrgModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import com.fasterxml.jackson.databind.ObjectMapper;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.registerModule(new JsonOrgModule());
        return objectMapper;
    }
}

配置完成后原有的JSONObject类型字段即可正常接收嵌套JSON内容。