如何为findById、findByEmail这类相似REST端点命名资源路径？

你当前的两个端点路径/{email}和/{id}会直接导致路由冲突——Spring MVC无法区分请求路径里的字符串是邮箱还是数字ID，大概率会把所有请求都匹配到第一个端点，甚至启动时就报错。

完全可以采用@GetMapping("mail/{email}")这类路径形式，这是解决这类冲突最直观也最符合REST设计规范的方案。具体可以这么调整：

• 邮箱查询端点：@GetMapping("/by-email/{email}") 或者 @GetMapping("/mail/{email}")
• ID查询端点：保持@GetMapping("/{id}") 或者改成@GetMapping("/by-id/{id}")

这样调整后，不仅彻底避免了路由冲突，还让接口语义更清晰，前端调用时也能一眼区分不同的查询方式。

另外也可以考虑用请求参数的方式实现，比如两个端点都用@GetMapping("/user")，分别通过@RequestParam String email和@RequestParam long id接收参数，但这种方式的REST语义不如路径前缀清晰，通常更适合多条件组合查询的场景。

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