如何实现/project路由根据id请求参数返回列表或单个Project对象？

你只需要调整Controller里的请求映射，用**请求参数（Request Param）**替代原来的路径变量（Path Variable）即可，下面给你两种常用实现方式：

方式一：拆分两个独立的处理方法（推荐，单一职责） #

这种方式把列表查询和单个查询拆成两个方法，Spring Boot会根据请求参数的存在情况自动匹配对应的方法：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;

@RestController
public class ProjectController {

    // 处理无id参数的请求：/project 或 /project/
    @GetMapping("/project")
    public List<Project> getProjectList() {
        // 这里写查询Project列表的逻辑
        return projectService.listAllProjects();
    }

    // 处理带id参数的请求：/project?id=1
    @GetMapping("/project")
    public Project getProjectById(@RequestParam("id") Long id) {
        // 这里写根据id查询单个Project的逻辑
        return projectService.getProjectById(id);
    }
}

Spring Boot会自动识别请求中是否携带id参数，从而调用对应的方法。这里的@RequestParam默认required=true，只有当请求里有id参数时才会匹配第二个方法，无参数时匹配第一个。

方式二：单个方法内判断参数存在性 #

如果想把逻辑放在同一个方法里，可以把id参数设为非必填，然后根据是否存在来分支处理：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;

@RestController
public class ProjectController {

    @GetMapping("/project")
    public Object getProject(@RequestParam(value = "id", required = false) Long id) {
        if (id == null) {
            // 返回列表
            return projectService.listAllProjects();
        } else {
            // 返回单个对象
            return projectService.getProjectById(id);
        }
    }
}

这种方式的好处是路由统一，但返回类型需要用Object或者通用的响应包装类，如果你需要严格的类型约束，推荐用第一种方式。

补充说明 #

• Spring Boot默认会忽略请求路径末尾的斜杠，所以/project和/project/都会匹配到上面的映射，无需额外处理。
• 如果需要处理id参数的合法性（比如非数字），可以在方法里添加参数校验逻辑，或者用@Validated配合注解做参数校验。

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