Spring Boot CRUD API：Postman与网页表单POST数据兼容问题

阿华AIGC实验室

2026-5-26

解决Spring Boot API同时支持表单提交与Postman JSON请求的冲突问题

嘿，这个问题我之前也碰到过，本质就是请求内容类型不兼容搞的鬼！让我给你拆解下原因，再给你几个可行的解决方案：

问题根源

当你用Postman发送POST请求时，应该是设置了Content-Type: application/json，这时候@RequestBody能完美解析JSON格式的请求体，所以插入成功；
但网页表单默认提交的是application/x-www-form-urlencoded格式的键值对数据，这种格式下@RequestBody无法识别解析，导致插入失败；
移除@RequestBody后，Spring会自动绑定表单的键值对参数，但Postman再发JSON请求时，因为没有@RequestBody来绑定JSON请求体，自然也无法正常插入了。

解决方案：让API同时支持两种请求类型

方案一：单接口兼容JSON与表单提交

可以通过指定接口支持的consumes类型，同时结合@RequestBody和@ModelAttribute来处理两种请求：

首先定义你的实体/DTO类（比如User）：

public class User {
    private String username;
    private String email;
    // 别忘了添加getter、setter方法
}

然后编写Controller方法：

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private UserService userService; // 假设你有对应的业务层

    @PostMapping(consumes = {MediaType.APPLICATION_JSON_VALUE, MediaType.APPLICATION_FORM_URLENCODED_VALUE})
    public ResponseEntity<String> createUser(
            @RequestBody(required = false) User userFromJson,
            @ModelAttribute User userFromForm) {
        
        // 根据请求类型选择对应的数据源
        User targetUser = userFromJson != null ? userFromJson : userFromForm;
        
        // 执行插入逻辑
        userService.save(targetUser);
        
        return ResponseEntity.ok("数据插入成功！");
    }
}

这样一来：

Postman发送JSON请求（Content-Type设为application/json）时，userFromJson会被正确填充；
网页表单提交时，userFromForm会自动绑定表单的键值对参数（注意表单input的name属性要和DTO字段名一致）。

方案二：拆分接口分别处理

如果不想在一个方法里混合处理，也可以拆成两个独立接口，分别对应JSON和表单请求：

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private UserService userService;

    // 处理Postman的JSON请求
    @PostMapping("/create/json")
    public ResponseEntity<String> createUserFromJson(@RequestBody User user) {
        userService.save(user);
        return ResponseEntity.ok("通过JSON插入数据成功");
    }

    // 处理网页表单提交
    @PostMapping("/create/form")
    public ResponseEntity<String> createUserFromForm(@ModelAttribute User user) {
        userService.save(user);
        return ResponseEntity.ok("通过表单插入数据成功");
    }
}

之后网页表单的action设为/api/users/create/form，Postman请求/api/users/create/json即可。