Spring Boot中Thymeleaf模板抛出的异常无法被全局异常处理器捕获的解决方案咨询

嗨，我完全懂你现在的困惑——明明写了@ControllerAdvice全局异常处理器，却死活抓不到Thymeleaf抛出的TemplateInputException（比如模板找不到的报错），甚至还怀疑是不是文件路径的问题。别担心，我来帮你拆解问题根源，再给你可行的解决办法。

为什么@ControllerAdvice抓不到这类异常？ #

你猜测的路径问题其实不是核心原因——只要你的ExceptionController被Spring的组件扫描机制覆盖到（比如包路径在@SpringBootApplication的扫描范围内），它的存放位置根本不会影响生效。真正的问题出在异常发生的阶段：

Thymeleaf的TemplateInputException是在视图渲染阶段抛出的，也就是控制器方法已经成功返回视图名称之后，Spring MVC调用视图解析器渲染模板时才触发的异常。而@ControllerAdvice的@ExceptionHandler默认只捕获控制器方法执行过程中抛出的异常，这类后续渲染阶段的异常不在它的处理范围内。

解决办法：捕获整个请求链路的异常 #

要处理视图渲染阶段的异常，你有两种常用且靠谱的方案：

方案1：自定义ErrorController（Spring Boot推荐方式）

Spring Boot默认提供了/error端点来统一处理错误请求，你可以通过实现ErrorController来接管这个逻辑，从而捕获到模板渲染的异常：

@Controller
public class CustomErrorController implements ErrorController {

    private static final String ERROR_ENDPOINT = "/error";

    @RequestMapping(ERROR_ENDPOINT)
    public String handleError(HttpServletRequest request, Model model) {
        // 从请求中获取异常对象
        Object exceptionObj = request.getAttribute(RequestDispatcher.ERROR_EXCEPTION);
        
        if (exceptionObj instanceof TemplateInputException) {
            TemplateInputException templateEx = (TemplateInputException) exceptionObj;
            // 添加自定义错误信息到Model
            model.addAttribute("errorMsg", "模板加载失败：" + templateEx.getMessage());
            // 返回自定义的模板错误页面
            return "custom_error/template_error";
        }
        
        // 处理其他类型的异常
        model.addAttribute("errorMsg", "服务器内部错误");
        return "custom_error/internal_error";
    }

    @Override
    public String getErrorPath() {
        return ERROR_ENDPOINT;
    }
}

方案2：实现HandlerExceptionResolver

通过实现Spring MVC的HandlerExceptionResolver接口，可以捕获整个请求处理流程中（包括视图渲染环节）的异常：

@Component
public class ThymeleafExceptionResolver implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request, 
                                        HttpServletResponse response, 
                                        Object handler, 
                                        Exception ex) {
        ModelAndView mav = new ModelAndView();
        
        if (ex instanceof TemplateInputException) {
            mav.addObject("errorDetail", "模板不存在或无法访问，请检查路径配置");
            mav.setViewName("custom_error/template_error");
            return mav;
        }
        
        // 返回null表示交给其他异常处理器处理
        return null;
    }
}

额外小提示 #

如果你想更细致地拆分异常处理逻辑，可以结合两种方案：用@ControllerAdvice处理控制器方法抛出的业务异常，用ErrorController或HandlerExceptionResolver处理视图渲染等后续阶段的异常，这样就能覆盖整个请求链路的所有异常场景啦。

备注：内容来源于stack exchange，提问作者Alejandro Moreno