从Nutz迁移至Spring Boot：使用JSON作为请求参数而非实体类的问题

刚好我之前也经历过从Nutz切换到Spring Boot的微服务迁移，这个JSON参数适配的问题当时也卡了我一小会儿，给你分享几个不用实体类直接接收JSON的可行方案，同时也给你做个Nutz与Spring Boot的注解等效对比：

首先，你Nutz里的@POST @At（如果带路径的话比如@At("/api/your-endpoint")），在Spring Boot里对应的就是@PostMapping("/api/your-endpoint")——这个注解已经整合了POST请求方法和路径映射的功能，一步到位。

方案1：用Map<String, Object>直接接收 #

这是最直接的方式，和Nutz里直接拿JSON转Map的用法几乎一致：

@RestController
public class DemoController {
    @PostMapping("/api/test") // 等效于Nutz的@POST @At("/api/test")
    public ResponseEntity<?> handleJsonRequest(@RequestBody Map<String, Object> requestJson) {
        // 直接操作Map里的字段，比如获取name和age
        String name = (String) requestJson.get("name");
        Integer age = (Integer) requestJson.get("age");
        
        // 这里写你的业务逻辑...
        
        return ResponseEntity.ok("处理结果：name=" + name + ", age=" + age);
    }
}

优点是零额外依赖，写起来快；缺点是需要自己做类型转换，遇到嵌套JSON的话处理起来会比较麻烦，而且容易出现ClassCastException。

方案2：用Jackson的JsonNode接收（推荐） #

Spring Boot默认集成了Jackson，用JsonNode可以灵活处理任意结构的JSON，还自带类型转换，比Map更靠谱：

import com.fasterxml.jackson.databind.JsonNode;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.http.ResponseEntity;

@RestController
public class JsonDemoController {
    @PostMapping("/api/json-handler")
    public ResponseEntity<?> handleComplexJson(@RequestBody JsonNode jsonNode) {
        // 支持嵌套JSON的获取，比如取user下的username
        String username = jsonNode.get("user").get("username").asText();
        // 可以指定默认值，避免空指针
        int level = jsonNode.get("level").asInt(1);
        
        // 业务逻辑处理...
        
        return ResponseEntity.ok("用户：" + username + "，等级：" + level);
    }
}

这个方案既不用写实体类，又能优雅处理复杂JSON结构，还能通过asText()、asInt()等方法安全转换类型，推荐优先用这个。

方案3：接收原始JSON字符串自行解析 #

如果需要对原始JSON字符串做一些特殊处理（比如加密、校验），可以先把请求体接收成String，再用Jackson或者Gson解析：

import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.http.ResponseEntity;
import com.fasterxml.jackson.core.JsonProcessingException;

@RestController
public class RawJsonController {
    private final ObjectMapper objectMapper = new ObjectMapper();
    
    @PostMapping("/api/raw-json")
    public ResponseEntity<?> handleRawJson(@RequestBody String rawJson) {
        try {
            // 把字符串转成Map或者JsonNode
            Map<String, Object> jsonMap = objectMapper.readValue(rawJson, Map.class);
            // 或者转成JsonNode：JsonNode jsonNode = objectMapper.readTree(rawJson);
            
            // 业务逻辑...
            
            return ResponseEntity.ok("原始JSON处理完成");
        } catch (JsonProcessingException e) {
            // 处理JSON格式错误的情况
            return ResponseEntity.badRequest().body("无效的JSON格式");
        }
    }
}

这个方案适合需要对原始JSON做前置处理的场景，就是多了一步解析的操作。

最后要划重点：不管用哪种方案，@RequestBody注解是核心——它会告诉Spring Boot把请求体里的JSON数据绑定到对应的参数上，这也是实现无实体类接收JSON的关键。

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