访问/register、/user页面报500错误 循环视图路径异常排查

你碰到的Circular view path是Spring MVC框架的典型视图解析异常，触发逻辑非常明确：
当处理/register、/user路径的GET请求时，框架没有拿到有效的视图资源路径，按照默认规则会把当前请求的路径名当做视图名称，再次转发到同路径的请求处理器，形成无限递归转发，最终抛出500错误。

常见触发场景共3类：

• 处理页面请求的控制器方法未返回明确的视图标识，方法返回值为空、或返回值和请求路径完全同名，同时未配置视图解析器的资源前缀与后缀
• 项目未正确配置模板引擎（Thymeleaf/JSP等）的路径规则，框架无法定位到实际的HTML/JSP页面文件
• 控制器方法内错误编写了同路径转发逻辑，比如在/register的处理方法中直接写forward:/register的返回逻辑

按以下顺序排查修改即可：

1. 校验视图解析配置
   如果你使用Thymeleaf作为模板引擎，在application配置文件（yml/properties）中补充正确的路径配置，示例（yml格式）：

   spring:
     thymeleaf:
       prefix: classpath:/templates/
       suffix: .html
       cache: false
   

   确认register.html、user.html页面文件确实存放在resources/templates目录下，和配置的前缀路径匹配。
2. 修正控制器方法逻辑
   处理页面GET请求的方法，需要返回和页面文件名匹配的视图字符串，示例写法：

   @GetMapping("/register")
   public String registerPage() {
       // 返回值和templates下的register.html对应，框架会自动拼接前缀后缀找到页面
       return "register";
   }
   
   @GetMapping("/user/{id}")
   public String userDetailPage(@PathVariable Long id, Model model) {
       // 业务逻辑：查询对应用户信息放入model
       return "user";
   }
   

   注意：如果对应方法是写数据的接口、不需要返回页面，需要在方法上添加@ResponseBody注解，或者将控制器类标注为@RestController，告诉框架该方法直接返回响应体，不进入视图解析流程。
3. 排查错误转发逻辑
   检查控制器方法内是否存在同路径转发的代码，比如在/register的处理方法中返回"forward:/register"，这类代码会直接触发循环转发，删除后改为返回正确的视图名即可。

修改完成后重启服务，直接访问对应路径即可正常加载页面，不会再抛出循环视图异常。

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