如何移除或禁用Spring默认Bean？以WebFlux的DefaultErrorWebExceptionHandler为例

我在Spring WebFlux项目中自定义了WebExceptionHandler，代码如下：

@Bean
@Order(-2)
public WebExceptionHandler exceptionHandler() {
    return (exchange, ex) -> {
        // 自定义异常处理逻辑
    };
}

目前通过@Order(-2)让自定义处理器优先级高于Spring自带的DefaultErrorWebExceptionHandler，@Primary注解也能达到类似效果，但我不想依赖排序或优先级注解来保障逻辑——总觉得这种方式不够稳妥，更希望直接把默认的DefaultErrorWebExceptionHandler从Spring容器中排除，让自定义实现成为唯一可用的WebExceptionHandler。以下是几种可行的解决方案：

方案1：排除对应的自动配置类 #

DefaultErrorWebExceptionHandler是由ErrorWebFluxAutoConfiguration这个自动配置类创建的，直接在启动类上排除该配置类即可：

@SpringBootApplication(exclude = ErrorWebFluxAutoConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

这样Spring就不会自动创建DefaultErrorWebExceptionHandler实例，容器中只会存在你自定义的WebExceptionHandler。

方案2：通过BeanDefinitionRegistryPostProcessor精准移除默认Bean #

如果不想完全排除ErrorWebFluxAutoConfiguration（比如需要保留该配置类中的其他Bean），可以自定义一个BeanDefinitionRegistryPostProcessor，在Spring注册Bean定义的阶段移除默认异常处理器的Bean定义：

@Component
public class DefaultErrorHandlerRemover implements BeanDefinitionRegistryPostProcessor {
    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
        // Spring自动装配的DefaultErrorWebExceptionHandler的Bean名称为defaultErrorWebExceptionHandler
        String defaultHandlerBeanName = "defaultErrorWebExceptionHandler";
        if (registry.containsBeanDefinition(defaultHandlerBeanName)) {
            registry.removeBeanDefinition(defaultHandlerBeanName);
        }
    }

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {
        // 无需额外处理
    }
}

这种方式可以精准移除目标Bean，不会影响其他自动配置内容。

总结 #

优先推荐方案1，操作简单直观，能彻底避免默认处理器被加载；如果需要保留ErrorWebFluxAutoConfiguration中的其他组件，再选用方案2进行精准移除。

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