Spring项目移除web.xml后Sitemesh失效问题求助

嘿，我明白你遇到的问题了——之前用web.xml配置Sitemesh好好的，换成纯Java自定义MySiteMeshFilter后就失效了对吧？这其实是因为你只定义了Filter类，但没把它注册到Spring的请求处理过滤器链中。原来的web.xml会被Servlet容器自动解析，把Filter加入到链里，但纯Java配置下得手动告诉Spring要加载它。

下面给你两种可行的解决方案：

方案一：用@Component注解让Spring自动管理Filter #

直接给你的MySiteMeshFilter添加@Component注解，让Spring扫描并将它纳入容器管理，自动加入过滤器链：

package adil.java.schoolmaven.config;
import org.sitemesh.builder.SiteMeshFilterBuilder;
import org.sitemesh.config.ConfigurableSiteMeshFilter;
import org.springframework.stereotype.Component;

@Component // 新增这个注解，标记为Spring组件
public class MySiteMeshFilter extends ConfigurableSiteMeshFilter {
    @Override
    protected void applyCustomConfiguration(SiteMeshFilterBuilder builder) {
        builder.addDecoratorPath("/*", "/WEB-INF/decorators/homeDecorator.jsp")
               .addDecoratorPath("/allStudents", "/WEB-INF/decorators/homeDecorator.jsp")
               .addDecoratorPath("/addStudents.jsp", "/WEB-INF/decorators/addStudentDecorator.jsp");
    }
}

注意：要确保你的config包在Spring的扫描范围内（比如主启动类所在包的子包，或者手动配置了扫描路径）。

方案二：用FilterRegistrationBean手动注册（更灵活） #

如果你想更精准控制Filter的映射规则、执行顺序等，可以用FilterRegistrationBean来手动配置，这种方式适合需要自定义更多参数的场景：

package adil.java.schoolmaven.config;

import org.sitemesh.config.ConfigurableSiteMeshFilter;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration // 标记为配置类
public class FilterConfig {

    @Bean
    public FilterRegistrationBean<ConfigurableSiteMeshFilter> sitemeshFilterRegistration() {
        FilterRegistrationBean<ConfigurableSiteMeshFilter> registrationBean = new FilterRegistrationBean<>();
        registrationBean.setFilter(new MySiteMeshFilter()); // 指定你的自定义Filter
        registrationBean.addUrlPatterns("/*"); // 对应原来web.xml中的url-pattern
        registrationBean.setOrder(1); // 设置过滤器执行顺序，数值越小越先执行（可选，按需调整）
        return registrationBean;
    }
}

额外检查点 #

最后别忘了确认你的装饰器JSP路径/WEB-INF/decorators/xxx.jsp是否正确：

• 如果是Spring Boot项目，确保JSP相关依赖已经引入，并且视图解析器配置正确
• 如果是传统Spring MVC项目，检查视图解析器的前缀/后缀是否和你的路径匹配

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