@RestController 返回页面

### 使用 `@RestController` 注解返回页面

在 Spring Boot 应用程序中，`@RestController` 主要用于创建 RESTful API 接口，其设计初衷是为了简化 JSON 或 XML 数据的响应处理[^1]。然而，在某些场景下可能需要通过 `@RestController` 来实现页面跳转或渲染 HTML 页面。

实际上，`@RestController` 并不适合直接返回视图页面，因为它的默认行为是将方法返回的结果作为 HTTP 响应体的一部分来发送给客户端，而不是交给视图解析器去查找并渲染相应的 JSP、Thymeleaf 等模板文件[^2]。

如果确实有需求让控制器既能提供数据接口又能展示页面，则可以考虑混合使用 `@Controller` 和 `@RestControllerAdvice` 或者在同一项目内分别定义不同类型的 Controller 类型：

#### 方法一：分离职责
对于页面请求采用标准的 `@Controller` 处理方式；而对于 AJAX 请求或其他形式的数据交互则继续沿用 `@RestController` 。这样做的好处是可以保持代码逻辑清晰明了，易于维护。

// 专门负责处理页面请求
@Controller
public class PageController {
    
    @GetMapping("/viewPage")
    public String showPage(Model model){
        // 添加模型属性...
        return "your-view-name"; // 对应回项目的资源路径下的html/ftl/jsp等文件名
    }
}

#### 方法二：自定义 ViewResolver 配置
虽然不推荐这样做，但如果非要使 `@RestController` 支持返回页面的话，可以通过配置特定条件下的视图解析策略来达到目的。不过这种方式会增加系统的复杂度，并且容易引起混淆。

综上所述，最佳实践建议遵循各自的设计模式，即 `@RestController` 只专注于 RESTful API 开发，而涉及页面呈现的任务交由传统的 `@Controller` 完成更为合适。