HTML文件移入子目录后@ControllerAdvice与Thymeleaf异常处理失效

• 视图路径未更新：异常处理方法返回的视图名还是旧的（比如error），但现在HTML已经移到子文件夹（比如error/404.html），直接返回原名称会找不到对应页面，得改成带子目录的路径（比如error/404）。
• @ControllerAdvice未被正确扫描：如果这个类的包不在Spring的扫描范围内，或者@ControllerAdvice指定了basePackages但没包含抛出异常的控制器所在包，处理器就不会生效。检查类上的注解配置，确保Spring能扫描到它。
• 视图解析器匹配规则问题：如果Thymeleaf的view-names配置没包含子目录下的视图，会导致错误页面不被Thymeleaf处理。可以加配置spring.thymeleaf.view-names=error/**,**，确保子目录视图被Thymeleaf解析。
• 异常类型匹配错误：@ExceptionHandler指定的异常类型和实际抛出的不匹配，比如处理器只处理自定义异常，但实际抛出的是系统异常，自然不会触发。检查注解里的异常类型，必要时用Exception.class做兜底测试。
• 模板本身存在错误：之前的无限循环可能没彻底解决——如果错误视图的Thymeleaf模板有语法错误，或者渲染时绑定数据出错，会再次抛出异常，导致处理器反复触发，最终看起来像是失效。检查模板代码，确保语法正确、参数传递没问题。
• 静态资源配置冲突：如果templates下的子文件夹和static目录下的文件夹重名，Spring可能误把子文件夹当成静态资源目录，导致Thymeleaf无法解析视图。确认子文件夹命名和static目录下的不重复，且spring.mvc.static-path-pattern没覆盖templates路径。

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