Spring Boot中同时使用Controller与RestController的最佳实践探讨

当然合理！这种分离视图渲染和REST服务职责的做法不仅没问题，反而是Spring Boot项目中非常推荐的最佳实践之一，完全匹配你当前的场景——既要返回JSP视图给前端页面，又要提供标准化的REST接口给Android客户端调用。

为什么这种方式是合理的？ #

• 职责单一原则：把返回视图的逻辑和提供REST接口的逻辑拆分到不同控制器，每个类只专注做一件事。负责视图的Controller只处理页面跳转、模板数据填充，RestController只专注于数据序列化（返回JSON/XML）和业务数据交互，代码更清晰，后期维护、扩展都更省心。
• 清晰的路由边界：用/api/*作为RestController的统一前缀，让整个应用的请求规则一目了然——前端页面的请求走常规路径，移动端的API请求走/api路径，开发时不会搞混，排查问题也能快速定位。
• 避免潜在冲突：虽然你已经清楚两者的区别，但分开编写能避免不小心在视图Controller里误用@ResponseBody，或是在RestController里错误返回视图名称，减少不必要的低级bug。

简单示例参考 #

返回JSP视图的Controller

@Controller
@RequestMapping("/web")
public class WebViewController {

    @GetMapping("/dashboard")
    public String showUserDashboard(Model model) {
        // 向视图传递页面所需数据
        model.addAttribute("currentUser", "Ouissal");
        // 返回JSP视图名称（需确保项目已配置JSP视图解析器）
        return "dashboard";
    }
}

供Android调用的RestController

@RestController
@RequestMapping("/api/users")
public class UserApiController {

    @GetMapping("/{userId}")
    public ResponseEntity<UserDto> getUserDetail(@PathVariable Long userId) {
        // 业务逻辑：查询用户详情
        UserDto user = userService.getUserById(userId);
        return ResponseEntity.ok(user);
    }

    @PostMapping
    public ResponseEntity<UserDto> createUser(@RequestBody UserDto userDto) {
        UserDto createdUser = userService.saveUser(userDto);
        return ResponseEntity.status(HttpStatus.CREATED).body(createdUser);
    }
}

额外的最佳实践建议 #

• 统一API响应格式：给所有RestController的返回值定义一个通用响应体（比如包含code、message、data字段），让Android客户端处理数据时更统一。
• API版本控制：如果后续API需要迭代升级，可以在路径中加入版本号，比如/api/v1/users、/api/v2/users，避免影响旧版本客户端的正常使用。
• 统一异常处理：用@RestControllerAdvice统一处理RestController中的异常，返回标准化错误响应；视图Controller的异常则可以用@ControllerAdvice单独处理，返回对应的错误页面。

总结一下，这种分离控制器的方式完全符合Spring Boot的设计理念，能让你的代码结构更健壮、更易维护，放心采用就好！

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