RequestDispatcher forward在Tomcat10正常，Tomcat11下页面无法渲染求助

问题背景 #

应用基于Java 21、Spring 6、Thymeleaf 3搭建，Tomcat 10上运行正常，但切换到Tomcat 11后，登录后通过JSP的RequestDispatcher转发到Thymeleaf页面时，前端显示空白（<body>标签无内容），无任何错误日志。调试确认response已填充正确的HTML内容，但未被渲染。目前仅redirect能解决问题，但业务要求必须使用forward方式。

已排除的问题点：

• ThymeleafViewResolver工作异常（响应内容正确生成）
• javax/jakarta兼容问题（Tomcat 10测试时已修复）
• response提前提交（JSP无其他代码触发提交）
• scriptlet与JSTL差异（替换为JSTL后问题依旧）
• 路径写法问题（绝对/相对路径测试结果一致）

针对性排查与解决方向 #

1. 适配Tomcat 11的RequestDispatcher路径解析规则 #

Tomcat 11（Jakarta EE 10）对请求路径的解析逻辑有细微调整，尝试使用带上下文路径的绝对转发路径：

request.getRequestDispatcher(request.getContextPath() + "/home").forward(request, response);

确保Spring MVC的HandlerMapping能精准匹配到对应的视图映射，避免路径解析偏差。

2. 确认Thymeleaf与Tomcat 11的兼容性 #

建议升级Thymeleaf到3.1.2及以上版本（该版本完善了对Jakarta EE 10的支持），同时检查Spring MVC视图解析器配置：

@Bean
public ThymeleafViewResolver thymeleafViewResolver() {
    ThymeleafViewResolver resolver = new ThymeleafViewResolver();
    resolver.setTemplateEngine(templateEngine());
    resolver.setCharacterEncoding("UTF-8");
    resolver.setContentType("text/html; charset=UTF-8");
    return resolver;
}

@Bean
public SpringTemplateEngine templateEngine() {
    SpringTemplateEngine engine = new SpringTemplateEngine();
    engine.setTemplateResolver(servletContextTemplateResolver());
    return engine;
}

@Bean
public ServletContextTemplateResolver servletContextTemplateResolver() {
    ServletContextTemplateResolver resolver = new ServletContextTemplateResolver();
    resolver.setPrefix("/WEB-INF/templates/"); // 根据实际模板路径调整
    resolver.setSuffix(".html");
    resolver.setTemplateMode(TemplateMode.HTML);
    resolver.setCharacterEncoding("UTF-8");
    return resolver;
}

确保模板路径、编码等配置正确，避免视图解析时的隐性异常。

3. 调整Tomcat响应缓冲区设置 #

Tomcat 11默认响应缓冲区大小可能导致转发内容被截断，可在JSP转发前手动设置缓冲区：

response.setBufferSize(16384); // 根据页面大小调整
request.getRequestDispatcher("home").forward(request, response);

也可在Tomcat的conf/web.xml中修改JSP引擎的全局缓冲区配置：

<servlet>
    <servlet-name>jsp</servlet-name>
    <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
    <init-param>
        <param-name>buffer</param-name>
        <param-value>16384</param-value>
    </init-param>
</servlet>

4. 排查拦截器/过滤器的干扰 #

临时禁用应用中所有自定义拦截器、过滤器，测试是否能正常渲染页面。若恢复正常，再逐一启用排查，确认是否有组件在转发过程中修改了响应对象，导致内容无法输出。

5. 迁移转发逻辑到Spring MVC控制器 #

避免在JSP中直接使用scriptlet处理转发，改为通过Spring MVC控制器实现：

@Controller
public class IndexController {
    @GetMapping("/index")
    public String forwardToHome() {
        return "forward:/home";
    }
}

利用Spring MVC自身的请求处理机制，规避Tomcat对JSP scriptlet的特殊处理逻辑。

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