如何在Spring MVC Controller接收通用JSON字符串（统一POST入口）

嗨Roque，这个需求其实挺常见的——想做一个通用的POST入口接收各种类型的JSON，不用为每个对象单独写接口对吧？我给你分享几个实用的实现方式，你可以根据自己的业务场景选：

这是最直接的方式，把请求体的JSON原样接收成字符串，之后再根据业务逻辑解析成对应对象。Spring会自动帮你完成JSON到String的转换，非常方便。

@RestController
@RequestMapping("/api")
public class UniversalController {

    private final ObjectMapper objectMapper;

    // Spring Boot会自动配置ObjectMapper，直接构造注入即可
    public UniversalController(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @PostMapping("/universal")
    public ResponseEntity<String> receiveUniversalJson(@RequestBody String jsonStr) {
        try {
            // 先把字符串解析成JsonNode，方便读取字段判断类型
            JsonNode rootNode = objectMapper.readTree(jsonStr);
            String objectType = rootNode.get("type").asText();

            // 根据类型转成对应实体类处理
            switch (objectType) {
                case "car":
                    Car car = objectMapper.treeToValue(rootNode, Car.class);
                    // 这里写处理Car对象的业务逻辑
                    return ResponseEntity.ok("处理Car对象成功");
                case "student":
                    Student student = objectMapper.treeToValue(rootNode, Student.class);
                    // 这里写处理Student对象的业务逻辑
                    return ResponseEntity.ok("处理Student对象成功");
                default:
                    return ResponseEntity.badRequest().body("不支持的对象类型");
            }
        } catch (JsonProcessingException e) {
            return ResponseEntity.badRequest().body("JSON格式错误，请检查请求体");
        }
    }
}

如果不想先处理字符串，可以直接用JsonNode接收，它相当于JSON的树形结构，能直接操作各个节点，省去了字符串转JsonNode的步骤。

@PostMapping("/universal")
public ResponseEntity<String> receiveUniversalJson(@RequestBody JsonNode jsonNode) {
    String objectType = jsonNode.get("type").asText();
    try {
        if ("car".equals(objectType)) {
            Car car = objectMapper.treeToValue(jsonNode, Car.class);
            // 处理Car逻辑
        } else if ("student".equals(objectType)) {
            Student student = objectMapper.treeToValue(jsonNode, Student.class);
            // 处理Student逻辑
        } else {
            return ResponseEntity.badRequest().body("不支持的对象类型");
        }
        return ResponseEntity.ok("处理完成");
    } catch (JsonProcessingException e) {
        return ResponseEntity.badRequest().body("JSON解析失败");
    }
}

如果你的场景不需要强类型转换，只是需要读取JSON里的键值对，用Map<String, Object>接收会更简单，直接就能拿到所有字段。

@PostMapping("/universal")
public ResponseEntity<String> receiveUniversalJson(@RequestBody Map<String, Object> jsonMap) {
    String objectType = (String) jsonMap.get("type");
    if ("car".equals(objectType)) {
        String brand = (String) jsonMap.get("brand");
        Integer year = (Integer) jsonMap.get("year");
        // 基于键值对处理业务逻辑
    } else if ("student".equals(objectType)) {
        String name = (String) jsonMap.get("name");
        Integer age = (Integer) jsonMap.get("age");
        // 处理Student逻辑
    }
    return ResponseEntity.ok("处理完成");
}

如果发送方会在JSON里带上明确的类型标识（比如"type"字段），这个方案会非常省心。通过Jackson的注解，可以让Spring自动根据类型标识把JSON转成对应的实体类，不用手动解析。

首先定义一个抽象基类，加上Jackson的类型识别注解：

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "type" // 指定用来识别类型的字段名
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = Car.class, name = "car"), // 类型值"car"对应Car类
    @JsonSubTypes.Type(value = Student.class, name = "student") // 类型值"student"对应Student类
})
public abstract class BaseDto {
    // 可以放一些所有对象都有的公共字段，比如id、createTime等
}

然后让你的实体类继承这个基类：

public class Car extends BaseDto {
    private String brand;
    private Integer year;
    // getter、setter省略
}

public class Student extends BaseDto {
    private String name;
    private Integer age;
    // getter、setter省略
}

最后Controller里直接接收基类即可，Spring会自动完成类型转换：

@PostMapping("/universal")
public ResponseEntity<String> receiveUniversalJson(@RequestBody BaseDto baseDto) {
    if (baseDto instanceof Car) {
        Car car = (Car) baseDto;
        // 处理Car对象逻辑
    } else if (baseDto instanceof Student) {
        Student student = (Student) baseDto;
        // 处理Student对象逻辑
    } else {
        return ResponseEntity.badRequest().body("不支持的对象类型");
    }
    return ResponseEntity.ok("处理完成");
}

几个注意点： #

• 如果发送方的JSON没有明确的类型标识，你可能需要通过字段特征判断（比如有没有"brand"字段识别Car），但这种方式不如明确的type字段可靠；
• 一定要做好异常处理，比如JSON格式错误、类型不匹配的情况，避免接口报错；
• Spring Boot项目中ObjectMapper已经自动配置，直接注入就能用，不用自己实例化。

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