Spring Boot 多个 @RestController 或混合使用 @RestController 与 @Controller 时，若请求路径未正确拼接（如缺少斜杠 /），会导致端点不可访问或视图无法渲染；本文详解路径拼接规则、修复方案及最佳实践。
spring boot 多个 `@restcontroller` 或混合使用 `@restcontroller` 与 `@controller` 时，若请求路径未正确拼接（如缺少斜杠 `/`），会导致端点不可访问或视图无法渲染；本文详解路径拼接规则、修复方案及最佳实践。
在 Spring Boot 中，@RequestMapping 的路径拼接遵循严格的字符串连接规则：类级 @RequestMapping 与方法级 @GetMapping/@PostMapping 的路径会直接拼接，不自动补斜杠。这是导致你 ViewController 不生效的根本原因。
你的当前代码存在路径拼接错误：
@RestController
@RequestMapping("/views") // ❌ 类路径无尾部斜杠
public class ViewController {
@GetMapping("login") // ❌ 方法路径无前导斜杠 → 实际映射为 "/viewslogin"
public ModelAndView login() {
return new ModelAndView("login");
}
}
拼接结果是 /viewslogin（而非预期的 /views/login），因此访问 /views/login 时 404，控制台也无报错——仅 DispatcherServlet 初始化日志，说明请求根本未匹配到任何 handler。
✅ 正确写法有两种等效方式（二者选一，保持统一）：
方式一：类路径以 / 结尾，方法路径不加 /
@Controller // ⚠️ 注意：返回视图必须用 @Controller，非 @RestController
@RequestMapping("/views/") // ✅ 末尾带斜杠
public class ViewController {
@GetMapping("login") // ✅ 方法路径不加斜杠
public ModelAndView login() {
return new ModelAndView("login");
}
}
方式二：类路径不带尾部 /，方法路径以 / 开头
@Controller
@RequestMapping("/views") // ✅ 无尾部斜杠
public class ViewController {
@GetMapping("/login") // ✅ 方法路径带前导斜杠 → 拼接为 "/views/login"
public ModelAndView login() {
return new ModelAndView("login");
}
}
? 关键注意事项：
- @RestController 默认返回 JSON 数据，不支持视图解析（如 Thymeleaf、JSP）。若需返回 HTML 页面，必须使用 @Controller（并确保已配置视图解析器，如 spring-boot-starter-thymeleaf）。
- AuthController 使用 @RestController 正确（处理 API），而 ViewController 应改用 @Controller。
- 路径拼接是纯字符串操作，Spring 不做智能修正。建议统一采用方式二（类路径无尾 / + 方法路径带 /），更符合 RESTful 规范且不易出错。
- 启动后可通过 Actuator 端点 GET /actuator/mappings 验证实际注册的端点路径（需添加 spring-boot-starter-actuator）。
? 总结：
多控制器失效通常源于路径拼接疏忽。牢记——斜杠决定路径层级，/views + login ≠ /views/login，而是 /viewslogin。统一路径风格、区分 @Controller 与 @RestController 的职责，并善用 Actuator 验证映射，可彻底规避此类问题。
