SpringBoot自定义代理Bean自动装配：IntelliJ无法识别Bean问题

核心原因 #

IntelliJ的Spring插件依赖静态分析识别Bean定义，而你通过ImportBeanDefinitionRegistrar动态注册Bean的逻辑，IDE无法在编译期解析到，因此会误报找不到Bean。以下是几种可行的修复方案：

方案1：将@CustomBean改为@Component派生注解 #

给@CustomBean添加@Component元注解，让IDE的静态扫描直接识别标记了该注解的类为Spring组件：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Component // 新增这行
public @interface CustomBean {
}

这样IDE会自动把@CustomBean标记的MyServiceCustomBean识别为Spring Bean，同时不影响你运行时的动态代理逻辑。

方案2：调整BeanDefinition注册逻辑，直接注册FactoryBean #

当前你是通过genericBeanDefinition(clazz, () -> factoryBean.getTarget())直接注册代理对象，IDE无法关联到FactoryBean的类型信息。改为注册CustomBeanFactoryBean本身，让IDE通过FactoryBean的getObjectType()识别Bean类型：
修改registerCustomBean方法中的BeanDefinition构建代码：

// 替换原有的BeanDefinitionBuilder逻辑
BeanDefinitionBuilder definition = BeanDefinitionBuilder.genericBeanDefinition(CustomBeanFactoryBean.class);
definition.addPropertyValue("type", clazz);
definition.addPropertyValue("name", name);
definition.setAutowireMode(AbstractBeanDefinition.AUTOWIRE_BY_TYPE);
definition.setLazyInit(true);

AbstractBeanDefinition beanDefinition = definition.getBeanDefinition();
beanDefinition.setPrimary(true);

String[] qualifiers = new String[]{name + "CustomBean"};
BeanDefinitionHolder holder = new BeanDefinitionHolder(beanDefinition, className, qualifiers);
BeanDefinitionReaderUtils.registerBeanDefinition(holder, registry);

这样注册的是FactoryBean实例，IDE会读取它的getObjectType()返回值（即MyServiceCustomBean），从而识别到该类型的Bean存在。

方案3：添加IDE专用的Spring配置文件（临时兼容） #

如果不想修改代码，可以创建一个仅用于IDE识别的Spring XML配置文件，手动声明这些Bean：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 仅用于IntelliJ识别，运行时会被动态注册的Bean覆盖 -->
    <bean id="myServiceCustomBean" class="com.yourpackage.CustomBeanFactoryBean">
        <property name="type" value="com.yourpackage.MyServiceCustomBean"/>
        <property name="name" value="myServiceCustomBean"/>
    </bean>
</beans>

然后在IntelliJ中，通过File > Project Structure > Modules > 你的模块 > Spring，将该文件添加到Spring上下文即可。

方案4：修正@Qualifier的使用（针对原代码） #

原代码中注册Bean时，BeanDefinitionHolder的id是类的全限定名（className），qualifiers是name + "CustomBean"。如果要使用@Autowired + @Qualifier，需要确保Qualifier值与注册的qualifier或Bean id一致：

@Component
@RequiredArgsConstructor
public class SomeService {
    // 使用qualifier名称
    private final @Qualifier("myServiceCustomBean") MyServiceCustomBean myServiceCustomBean;
    // 或者使用Bean的全限定名作为id
    // private final @Qualifier("com.yourpackage.MyServiceCustomBean") MyServiceCustomBean myServiceCustomBean;
}

不过这个方案仅在IDE能识别到qualifiers时有效，优先推荐方案1或2。

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