Spring Boot如何禁用第三方包中通过@Import导入的@RestController

针对第三方自动配置类通过@Import硬导入的@RestController，常规排除手段失效的原因是该类并非通过组件扫描注册，也不属于可被exclude属性排除的自动配置类，可通过以下两种稳定方案实现禁用：

方案1：排除导入该Controller的上游自动配置类（适合需要调整自动配置逻辑的场景） #

• 首先定位到导入graphql.kickstart.spring.webflux.GraphQLController的第三方自动配置类，对应11.0.0版本的starter为graphql.kickstart.spring.webflux.boot.GraphQLWebFluxAutoConfiguration
• 在启动类的@SpringBootApplication注解中排除该自动配置类：

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

• 自定义配置类，复用原自动配置类中除@Import(GraphQLController.class)之外的所有Bean定义，保留GraphQL基础能力的同时避免加载第三方Controller。

方案2：使用BeanDefinitionRegistryPostProcessor直接移除Bean定义（优先推荐，通用无侵入） #

该接口的执行时机在所有Bean定义加载完成后、Bean实例化前，可直接删除第三方注册的Controller Bean定义，无需关心该类的注册逻辑：

• 自定义处理器并注册为Spring Bean：

import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.beans.factory.support.BeanDefinitionRegistryPostProcessor;
import org.springframework.stereotype.Component;
import java.util.Objects;

@Component
public class RemoveGraphQLControllerProcessor implements BeanDefinitionRegistryPostProcessor {
    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
        // 按类全限定名匹配移除，适配不同版本Bean名称不一致的情况
        for (String beanName : registry.getBeanDefinitionNames()) {
            BeanDefinition definition = registry.getBeanDefinition(beanName);
            if (Objects.equals(definition.getBeanClassName(), "graphql.kickstart.spring.webflux.GraphQLController")) {
                registry.removeBeanDefinition(beanName);
                break;
            }
        }
    }

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

• 完成上述配置后，第三方Controller将不会被实例化，你自定义的同路径端点可以正常注册，不会出现路径冲突异常。

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