Spring Boot REST API能否配置多个POST方法？

首先，你遇到的启动报错是因为Spring无法区分两个同路径、同请求方式的POST接口。Spring路由请求时只会依据请求路径和HTTP方法，不会通过请求体的JSON结构做区分，所以两个不带路径的@PostMapping会被判定为重复映射，导致启动失败。

简便解决方案 #

最直接且符合RESTful规范的方式是给两个接口设置不同的请求路径：

@PostMapping("/person")
public void insertPerson(@RequestBody Person person) {
    personService.addPerson(person);
}

@PostMapping("/people")
public void insertPeople(@RequestBody List<Person> people) {
    personService.addPeople(people);
}

调用时单个Person对象请求/person，对象列表请求/people，无需额外判断，逻辑清晰易维护。

如果非要复用同一个路径，也可以通过请求参数区分（但可读性不如路径区分，不推荐）：

@Autowired
private ObjectMapper objectMapper;

@PostMapping
public void insert(@RequestBody Object requestBody, @RequestParam(value = "type", required = true) String type) {
    if ("single".equals(type)) {
        Person person = objectMapper.convertValue(requestBody, Person.class);
        personService.addPerson(person);
    } else if ("list".equals(type)) {
        List<Person> people = objectMapper.convertValue(requestBody, new TypeReference<List<Person>>() {});
        personService.addPeople(people);
    }
}

这种方式需要借助ObjectMapper做类型转换，但会让接口逻辑变得复杂，不如分开路径优雅。

新手学习资源建议 #

• 优先看Spring Boot官方中文文档：从入门指南开始，跟着完成第一个Spring Boot项目，官方文档是最权威的参考资料。
• 动手完成官方Getting Started系列小项目：比如构建REST接口、连接数据库等，每个小项目能快速掌握一个核心知识点。
• 入门书籍推荐《Spring Boot实战》：案例驱动式讲解，内容通俗易懂，适合新手建立完整的知识框架。
• 免费视频教程：国内技术平台的Spring Boot入门系列（比如黑马、尚硅谷的免费教程），跟着敲代码能快速熟悉开发流程。

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