Spring Boot+Thymeleaf：如何阻止302重定向时渲染页面？

环境依赖 #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

问题现象 #

• 访问/时页面渲染正常
• 访问/redirect时，虽会302重定向到/（浏览器后续收到200响应），但302响应中也包含了/对应的渲染页面，浏览器实际收到两次相同页面
  

相关代码 #

控制器（IndexController.java） #

@Controller
public class IndexController {
    
    @GetMapping("/")
    public String index(Model model){
        return "index";
    }

    @GetMapping("/redirect")
    public String redirect(Model model){
        return "redirect:/"; //302响应中包含了渲染后的index.html
    }

}

Thymeleaf模板（/resources/templates/index.html） #

<h1>hai</h1>

问题解答 #

1. 如何让302重定向本身不渲染页面？ #

有两种靠谱的解决方法：

• 方法一：用RedirectView替代字符串返回值
  直接修改redirect方法返回RedirectView对象，明确告诉框架这是重定向，从根源上避免Thymeleaf提前渲染：

@GetMapping("/redirect")
public RedirectView redirect() {
    return new RedirectView("/");
}

• 方法二：清空Model（应急方案）
  如果不想改返回值类型，可以在重定向方法里清空Model，防止Thymeleaf因为存在Model对象而触发渲染：

@GetMapping("/redirect")
public String redirect(Model model){
    model.asMap().clear();
    return "redirect:/";
}

优先选第一种，逻辑更清晰，也不会有潜在的其他问题。

2. 为何这是默认行为？ #

这是Spring MVC和Thymeleaf协同处理时的副作用，并非设计意图：
当你返回带redirect:前缀的字符串时，Spring MVC会先处理这个重定向指令，但此时如果Model里有数据（哪怕是框架默认创建的空Model），Thymeleaf的视图解析器会提前尝试渲染模板。虽然最终框架会发送302状态码，但已经渲染好的页面内容已经写入了响应缓冲区，所以会跟着302响应一起发给浏览器。

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