Spring Boot中如何构建带统一前缀的控制器父子路由层级？

在Spring Boot里实现这种层级化的Controller结构，最简洁也最符合最佳实践的方式就是利用@RequestMapping（或其派生注解@GetMapping、@PostMapping等）的层级路径配置，既能清晰划分职责，又能完美匹配你需要的URL规则。下面是具体的实现方案：

1. 父Controller：处理根路径 /api/parent #

创建一个专门的父Controller，通过类上的@RequestMapping指定基础前缀/api/parent，然后用无路径的@GetMapping来匹配根请求：

@RestController
@RequestMapping("/api/parent")
public class ParentController {

    // 匹配 GET /api/parent
    @GetMapping
    public ResponseEntity<String> handleParentRoot() {
        return ResponseEntity.ok("请求已路由到父Controller，路径：/api/parent");
    }
}

2. 子Controller：处理各自的子路径 #

每个子路径对应一个独立的Controller，同样通过类上的@RequestMapping指定完整的子路径（包含父前缀），这样每个Controller只专注处理自己的路径范围：

ChildOneController（匹配 /api/parent/child-one） #

@RestController
@RequestMapping("/api/parent/child-one")
public class ChildOneController {

    // 匹配 GET /api/parent/child-one
    @GetMapping
    public ResponseEntity<String> handleChildOne() {
        return ResponseEntity.ok("请求已路由到ChildOneController，路径：/api/parent/child-one");
    }

    // 如果需要扩展子子路径，比如 /api/parent/child-one/detail，直接添加注解即可
    @GetMapping("/detail")
    public ResponseEntity<String> handleChildOneDetail() {
        return ResponseEntity.ok("请求已路由到ChildOneController的detail接口");
    }
}

其他子Controller同理 #

比如ChildTwoController只需把@RequestMapping的路径改成/api/parent/child-two，以此类推实现child-three、child-four的Controller。

3. 优化建议：统一管理前缀 #

如果后续需要修改父前缀（比如从/api/parent改成/v2/api/parent），可以把前缀定义成常量，避免逐个修改Controller：

// 定义全局API路径常量
public class ApiPathConstants {
    public static final String PARENT_BASE = "/api/parent";
}

// 父Controller使用常量
@RestController
@RequestMapping(ApiPathConstants.PARENT_BASE)
public class ParentController { ... }

// 子Controller拼接常量
@RestController
@RequestMapping(ApiPathConstants.PARENT_BASE + "/child-one")
public class ChildOneController { ... }

关键注意事项 #

• 路径匹配优先级：Spring会优先匹配更具体的路径，比如/api/parent/child-one会直接命中ChildOneController，不会和父Controller的根路径冲突，这是Spring路径匹配的天然特性，无需额外配置。
• 避免通配符冲突：不要在父Controller中使用@GetMapping("/**")这类通配符，否则会拦截所有子路径的请求，导致子Controller无法生效。
• 职责单一原则：每个Controller只负责自己的路径范围，代码更模块化，后续维护和扩展也更方便。

这种方案是Spring生态中最常用的层级Controller实现方式，既简洁又符合设计原则，完全满足你的需求。

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