Spring MVC启动失败：Filter mapping指定未知过滤器名[sitemesh]

针对你遇到的java.lang.IllegalArgumentException: Filter mapping specifies an unknown filter name [sitemesh]错误，按以下步骤排查解决：

• 确认Sitemesh依赖是否正确引入
  检查项目的依赖管理文件（比如Maven的pom.xml），确保添加了兼容的Sitemesh依赖。Spring 3.2适配Sitemesh 2.x系列，推荐版本2.4.2：

  <dependency>
      <groupId>org.sitemesh</groupId>
      <artifactId>sitemesh</artifactId>
      <version>2.4.2</version>
  </dependency>
  

  同时确认依赖已成功下载，本地仓库中无缺失文件。

• 检查web.xml的过滤器配置顺序
  必须先在web.xml中定义Sitemesh过滤器，再配置过滤器映射，顺序颠倒会导致容器无法识别。正确配置示例：

  <!-- 定义Sitemesh过滤器 -->
  <filter>
      <filter-name>sitemesh</filter-name>
      <filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>
  </filter>
  <!-- 配置过滤器映射 -->
  <filter-mapping>
      <filter-name>sitemesh</filter-name>
      <url-pattern>/*</url-pattern>
  </filter-mapping>
  

  注意filter-name在定义和映射中必须完全一致，大小写敏感。

• 验证Sitemesh装饰器配置文件
  确认WEB-INF目录下存在sitemesh.xml或sitemesh-decorators.xml，并正确指定装饰器路径：

  <sitemesh>
      <mapping path="/*" decorator="/layouts/user.jsp"/>
  </sitemesh>
  

  确保装饰器路径与你实际的文件结构匹配。

• 清理缓存并重新构建
  执行mvn clean install（Maven）清理旧编译文件，删除Tomcat的work目录以及项目的target目录，避免缓存文件干扰。重新部署项目后再启动Tomcat。

• 检查版本兼容性
  Spring 3.2属于旧版本，不要使用Sitemesh 3.x及以上版本，两者存在兼容性问题，坚持使用Sitemesh 2.x系列即可。

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