@Bean注解的WebFilter方法返回Null是否安全？

核心结论 #

• Spring允许@Bean注解的方法返回null，这种情况下Spring不会将该Bean注册到IoC容器中。对应到你的场景，当日志级别不是Debug时，PayloadFilter不会被实例化，自然也不会作为WebFilter生效，完全符合你的需求。
• 这种做法是安全的，但有几个细节需要注意：

注意事项 #

1. 避免硬依赖问题：如果其他Bean通过@Autowired直接注入这个WebFilter，必须添加@Nullable注解或者用Optional<WebFilter>包裹，否则Spring启动时会因为找不到Bean抛出NoSuchBeanDefinitionException。
2. 对比空对象模式：你之前尝试的空对象模式出错，大概率是没正确实现WebFilter的核心方法（比如忘记调用chain.doFilter(request, response)导致请求中断）。而返回null的方式更轻量，直接跳过Bean注册，没有冗余的空对象实例。
3. 更优雅的替代方案：可以用Spring的@Conditional注解实现条件注册，代码可读性更强：

@Bean
@Conditional(DebugLogEnabledCondition.class)
WebFilter payloadFilter() {
    return new PayloadFilter();
}

static class DebugLogEnabledCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        Logger log = LoggerFactory.getLogger(DebugLogEnabledCondition.class);
        return log.isDebugEnabled();
    }
}

总结 #

你的当前写法完全可行且安全，只要确保没有其他Bean强制依赖这个WebFilter。返回null时Spring会跳过该Bean的注册流程，不会产生任何额外开销，完美满足仅在Debug级别启用过滤器的需求。

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