多模块SpringBoot应用同名Request Response Filter异常问题求助

原因分析 #

1. @WebFilter注解的名称冲突 #

如果你的过滤器是用@WebFilter标记，且三个模块里的过滤器都指定了相同的name属性，按照Servlet规范，name是Servlet容器内过滤器的唯一标识。Spring Boot通过@ServletComponentScan扫描时，后扫描到的过滤器会覆盖先扫描到的。而多模块的扫描顺序受模块依赖、类加载顺序影响没有固定规则，导致每次启动后生效的过滤器是随机的那一个。

2. 未指定过滤器执行顺序 #

如果过滤器是通过@Component或自定义配置类注册为Spring Bean，三个模块的过滤器都会被容器加载。默认情况下Spring不会给过滤器指定执行顺序，会按照Bean的注册顺序来执行。多模块中Bean的注册顺序不确定（依赖模块加载顺序、包扫描顺序），如果多个过滤器匹配同一请求路径，执行顺序的随机性会让最后执行的过滤器修改响应，看起来就像是“随机被一个处理”。

3. 包扫描范围重叠 #

Spring Boot默认扫描启动类所在包及其子包，如果三个模块的过滤器所在包都在这个范围内，所有过滤器都会被加载，进一步放大了顺序或覆盖的问题。

解决办法 #

1. 避免过滤器名称冲突 #

• 使用@WebFilter时，给每个模块的过滤器指定唯一name，比如加模块前缀：@WebFilter(name = "main-module-filter", urlPatterns = "/*")、@WebFilter(name = "sub1-module-filter", urlPatterns = "/*")。
• 保证过滤器全类名唯一（不同包名），避免Spring容器中Bean id重复（默认Bean id是类名首字母小写，类名相同会导致id重复，Spring可能会覆盖或报错，取决于版本）。

2. 明确指定过滤器执行顺序 #

• 用@Order注解（适用于@Component注册的过滤器）：给每个过滤器加@Order，指定不同优先级，数值越小优先级越高，比如@Order(1)、@Order(2)。
• 用FilterRegistrationBean注册过滤器（更灵活）：在配置类中设置执行顺序，还能指定URL匹配规则，让不同模块的过滤器只处理对应模块的接口：

@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean<MainModuleFilter> mainFilterRegistration() {
        FilterRegistrationBean<MainModuleFilter> registration = new FilterRegistrationBean<>();
        registration.setFilter(new MainModuleFilter());
        registration.addUrlPatterns("/main/*"); // 仅匹配主模块接口
        registration.setOrder(1);
        return registration;
    }

    @Bean
    public FilterRegistrationBean<Sub1ModuleFilter> sub1FilterRegistration() {
        FilterRegistrationBean<Sub1ModuleFilter> registration = new FilterRegistrationBean<>();
        registration.setFilter(new Sub1ModuleFilter());
        registration.addUrlPatterns("/sub1/*"); // 仅匹配子模块1接口
        registration.setOrder(2);
        return registration;
    }
}

3. 限制包扫描范围 #

• 在启动类用@ComponentScan指定仅扫描必要的包，避免无关过滤器被加载，比如：@ComponentScan(basePackages = "com.main.module")，子模块的Bean通过@Import按需引入，而非全量扫描。
• 用@ServletComponentScan指定扫描的包，只加载当前模块的过滤器，避免其他模块的过滤器被扫描到。

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