JavaFilter获取SpringBean的正确方式

Java Filter无法直接使用@Autowired注入Spring Bean，根本原因在于Filter由Servlet容器（如Tomcat）而非Spring容器创建和管理，导致其脱离Spring生命周期和依赖注入体系；最可靠、通用且安全的解决方案是在Filter的init()方法中，通过ServletContext获取WebApplicationContext，再手动调用getBean()获取所需Bean——这一方式兼容所有Spring版本（含Spring Boot），规避了@Component自动注册的多实例、时机错乱、上下文未就绪等隐患，也绕过了ApplicationContextAware无效、静态工具类初始化风险等常见误区，真正抓住了“何时获取才安全”这一核心要害。

Filter中无法直接@Autowired的原因

Java Web的Filter由Servlet容器（如Tomcat）管理，不是Spring容器创建的Bean，因此不经过Spring的生命周期管理，@Autowired字段会为null。这不是配置遗漏，而是加载时机和上下文隔离导致的根本限制。

通过WebApplicationContext手动获取Bean

在Filter的init()方法中，利用ServletContext拿到Spring根上下文，再从中获取所需Bean。这是最常用、最稳妥的方式，适用于所有Spring版本（包括Spring Boot）。

• 必须在init()中获取，不能在构造函数或类变量初始化时调用
• 推荐使用WebApplicationContextUtils.getRequiredWebApplicationContext(sc)，避免返回null
• 若项目有多个上下文（如父子容器），确保获取的是根上下文（即ContextLoaderListener加载的那个）

public class MyFilter implements Filter {
    private MyService myService;

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        ServletContext sc = filterConfig.getServletContext();
        WebApplicationContext ctx = WebApplicationContextUtils.getRequiredWebApplicationContext(sc);
        myService = ctx.getBean(MyService.class);
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 此时myService已可用
        myService.doSomething();
        chain.doFilter(request, response);
    }
}

@Component + @Order + Spring Boot自动注册的陷阱

Spring Boot允许将Filter声明为@Component，并用@Order控制顺序，此时它会被Spring托管，@Autowired看似能用——但存在严重隐患：

• 该方式依赖FilterRegistrationBean自动注册，但部分场景（如使用web.xml或嵌入式容器自定义配置）可能失效
• 如果Filter被多个ServletRegistrationBean引用，可能被多次实例化，@Autowired行为不可控
• 某些Spring Boot版本中，@Component Filter的init()早于Spring上下文刷新完成，仍可能报NullPointerException

结论：不推荐仅靠@Component解决依赖注入，应始终以WebApplicationContext手动获取为准。

使用ApplicationContextAware的替代方案（慎用）

有人尝试让Filter实现ApplicationContextAware，但这行不通——因为Filter本身不是Spring Bean，setApplicationContext()根本不会被调用。强行实现只会让代码看起来“支持注入”，实际运行时依旧null。

真正可行的变通是：写一个静态工具类封装WebApplicationContext访问逻辑，在任意地方（包括Filter）调用SpringUtils.getBean(Xxx.class)。但要注意静态持有ApplicationContext需在ContextRefreshedEvent后赋值，否则可能空指针。

复杂点往往不在“怎么拿”，而在于“什么时候拿才安全”——别信构造器、别信静态块、别信第一次doFilter，只信init()里从ServletContext捞出来的上下文。

终于介绍完啦！小伙伴们，这篇关于《JavaFilter获取SpringBean的正确方式》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！