SpringBoot中requestMappingHandlerMapping创建失败，请求映射冲突求助

Hey there! Let's fix your current error first, then build the new API you need.

一、为什么会出现映射歧义错误？ #

你现在的控制器里有两个@GetMapping("{id}")注解的方法：

• getSummary(@PathVariable String id)：返回该ID对应的所有分数列表
• get(@PathVariable String id)：返回单个ID对应的记录

Spring MVC在启动时会扫描所有请求映射，当两个方法的HTTP方法（GET）和路径（/api/v1/scrcrds/{id}）完全一致时，它无法判断应该把请求转发给哪个方法，所以抛出了IllegalStateException: 映射歧义的错误。

二、修复现有映射冲突的方案 #

最简单的方式是给这两个方法设置不同的请求路径，让Spring能明确区分它们。推荐方案如下：

给getSummary添加专属路径前缀，把它的映射改成@GetMapping("summary/{id}")，这样它的完整路径就是/api/v1/scrcrds/summary/{id}，和单个记录查询的/api/v1/scrcrds/{id}完全区分开，不会再出现冲突。

三、实现支持单个/两个ID组合查询的新API #

接下来我们开发支持单个ID或两个ID组合查询的API，这里提供两种常用的设计思路，你可以根据需求选择：

思路1：路径参数实现（RESTful风格） #

添加一个新的GET方法，路径支持单个ID或两个ID（第二个ID可选）：

// 获取单个ID或两个ID组合对应的所有分数
@GetMapping(value = {"scores/{id}", "scores/{id1}/{id2}"})
public List<Scrcrd> getScoresByIds(
        @PathVariable(required = false) String id,
        @PathVariable(required = false) String id1,
        @PathVariable(required = false) String id2) {
    Set<String> ids = new HashSet<>();
    if (id != null) {
        ids.add(id);
    }
    if (id1 != null) {
        ids.add(id1);
    }
    if (id2 != null) {
        ids.add(id2);
    }
    return scrcrdRepository.findAllById(ids);
}

这个方法会匹配两种请求路径：

• /api/v1/scrcrds/scores/123（单个ID查询）
• /api/v1/scrcrds/scores/123/456（两个ID组合查询）

思路2：请求参数实现（灵活扩展） #

如果未来可能需要支持更多ID的查询，用请求参数传递会更灵活：

// 获取多个ID对应的所有分数（支持1个或多个）
@GetMapping("scores")
public List<Scrcrd> getScoresByIds(@RequestParam List<String> ids) {
    return scrcrdRepository.findAllById(ids);
}

请求示例：

• 单个ID：/api/v1/scrcrds/scores?ids=123
• 两个ID：/api/v1/scrcrds/scores?ids=123&ids=456

四、修改后的完整控制器代码 #

这里采用路径前缀修复冲突，加上思路1的双ID路径实现：

@RestController
@RequestMapping("/api/v1/scrcrds")
public class ScrcrdsController {
    @Autowired
    private ScrcrdRepository scrcrdRepository;

    // list all scrcrd records
    @GetMapping
    public List<Scrcrd> list() {
        return scrcrdRepository.findAll();
    }

    // 修复：给getSummary设置专属路径，避免映射冲突
    // get summary of an employee
    @GetMapping(value = "summary/{id}")
    public List<Scrcrd> getSummary(@PathVariable String id) {
        return scrcrdRepository.findAllById(Collections.singleton(id));
    }

    // get scrcrd record by id
    @GetMapping(value = "{id}")
    public Scrcrd get(@PathVariable String id) {
        // 建议替换成findById避免懒加载问题：return scrcrdRepository.findById(id).orElseThrow(() -> new RuntimeException("Record not found"));
        return scrcrdRepository.getOne(id);
    }

    // 新增：支持单个/两个ID组合查询所有分数
    @GetMapping(value = {"scores/{id}", "scores/{id1}/{id2}"})
    public List<Scrcrd> getScoresByIds(
            @PathVariable(required = false) String id,
            @PathVariable(required = false) String id1,
            @PathVariable(required = false) String id2) {
        Set<String> ids = new HashSet<>();
        if (id != null) {
            ids.add(id);
        }
        if (id1 != null) {
            ids.add(id1);
        }
        if (id2 != null) {
            ids.add(id2);
        }
        return scrcrdRepository.findAllById(ids);
    }

    // create a new scrcrd record
    @PostMapping
    @ResponseStatus(HttpStatus.CREATED) // to get 201 response instead of 200
    public Scrcrd create(@RequestBody final Scrcrd scrcrd) {
        return scrcrdRepository.saveAndFlush(scrcrd);
    }

    // delete a scrcrd record
    @RequestMapping(value = "{id}", method = RequestMethod.DELETE)
    public void delete(@PathVariable String id) {
        // 建议先检查关联子记录再删除，避免外键约束异常
        scrcrdRepository.deleteById(id);
    }

    // update a scrcrd record
    @RequestMapping(value = "{id}", method = RequestMethod.PUT)
    public Scrcrd update (@PathVariable String id, @RequestBody Scrcrd scrcrd) {
        // because this is a PUT, we expect all attributes to be passed in. A PATCH would only need what attribute is being modified
        // TODO: Add validation that all attributes are passed in, otherwise return a 400 bad payload
        Scrcrd existingScrcrd = scrcrdRepository.getOne(id);
        // attributes of emp are copied to existingScrcrd, emp__id, mgr_id, mgr_scr_dt and type_nam is not to be changed
        BeanUtils.copyProperties(scrcrd, existingScrcrd , "emp__id", "mgr_id", "mgr_scr_dt", "type_nam");
        return scrcrdRepository.saveAndFlush(existingScrcrd);
    }
}

额外小提示 #

• getOne()方法返回的是JPA代理对象，若需要立即加载数据，建议替换成findById(id).orElseThrow(...)，避免后续可能出现的懒加载异常。
• 删除操作前记得检查关联的子记录，直接删除可能会触发数据库外键约束错误。

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