Thymeleaf Layout Dialect模板加载失败报404错误求助

看起来你遇到的问题主要是配置位置错误和模板引擎未正确注册方言导致的，咱们一步步来修复：

1. 修复web.xml的错误配置 #

你在web.xml里直接写了<bean>标签，这是不对的！web.xml是Servlet容器的配置文件，不能直接定义Spring Bean，这段LayoutDialect的配置应该移到Spring的配置文件中。

先删掉web.xml里的这段错误代码：

<bean class="nz.net.ultraq.thymeleaf.LayoutDialect">
  <constructor-arg ref="groupingStrategy"/>
</bean>

另外，你的DispatcherServlet没有指定正确的MVC配置文件路径，默认会去加载/WEB-INF/dispatcher-servlet.xml，但你的MVC配置是config-mvc.xml，所以需要修改DispatcherServlet的init-param：

<servlet>
  <servlet-name>dispatcher</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <init-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>/WEB-INF/config-mvc.xml</param-value> <!-- 指向你的MVC配置文件 -->
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>

2. 在TemplateEngine中注册Layout Dialect #

你的config-mvc.xml里的SpringTemplateEngine没有添加LayoutDialect，这就是“移除bean配置后页面能加载但无模板效果”的原因——模板引擎根本不知道有这个方言存在。

修改templateEngine的配置，添加additionalDialects属性：

<bean id="templateEngine" class="org.thymeleaf.spring4.SpringTemplateEngine">
  <property name="templateResolver" ref="templateResolver" />
  <!-- 注册Layout Dialect -->
  <property name="additionalDialects">
    <set>
      <bean class="nz.net.ultraq.thymeleaf.LayoutDialect" />
    </set>
  </property>
</bean>

（注：你之前写的groupingStrategy如果没有自定义实现的话，可以不用加构造参数，默认的分组策略就够用）

3. 验证页面模板的语法正确性 #

确保你的home.html里正确使用了Layout Dialect的语法，比如用layout:decorate引用模板：

<!DOCTYPE html>
<html xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout">
<head>
  <title>Home</title>
</head>
<body layout:decorate="~{${template}}">
  <!-- 页面内容 -->
</body>
</html>

这里的~{${template}}是正确的语法，用来动态加载Model中的template变量对应的模板文件（比如template.html或admintemplate.html，要确保这些文件确实在/WEB-INF/views/目录下）。

4. 版本兼容性确认 #

你用的Thymeleaf 3.0.9 + thymeleaf-layout-dialect 2.3.0是兼容的（Thymeleaf 3.x对应Layout Dialect 2.x系列），Spring版本如果是最新版，建议把org.thymeleaf.spring4相关的类换成org.thymeleaf.spring5（比如SpringTemplateEngine和ThymeleafViewResolver），这样能更好地适配最新Spring框架。

最后验证 #

做完以上修改后，重启服务器：

• 404错误应该会消失，因为DispatcherServlet能正确加载MVC配置和视图解析器
• Model中的template变量会被正确解析，页面会应用对应的模板布局

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