Spring循环依赖问题：配置类Bean循环异常排查与解决

一、循环依赖异常的原因 #

1. 配置类标记错误：ClassA同时标注@Configuration和@Component是冗余且错误的——ClassA只是一个依赖Config的业务Bean，不需要作为配置类（@Configuration用于定义Bean的配置逻辑，而非普通业务Bean）。当ClassA被标记为@Configuration时，Spring会将其纳入配置类的初始化流程，而它的构造注入依赖Config Bean，Config Bean又由ClassB的@Bean方法提供；同时ClassB也是@Configuration类，Spring在处理这两个配置类的依赖关系时，形成了循环依赖。
2. 注解冗余干扰逻辑：ClassB上同时标注@Configuration和@Component属于冗余操作（@Configuration本身已包含@Component的语义），可能干扰Spring对Bean的处理逻辑。

二、循环依赖的解决方法 #

方案1：修正ClassA的注解 #

去掉ClassA上的@Configuration，仅保留@Component，因为它只是一个消费Config的普通Bean：

@Component
public class ClassA {   // consumes config
    Config config;

    public ClassA(Config config) {
        if (config == null) {
            throw new NullPointerException();
        }
        this.config = config;
    }
}

方案2：优化配置绑定逻辑（更规范） #

直接让Config类绑定配置，去掉冗余的ClassB中间层：

1. 修改Config.java，添加配置绑定注解和完整的getter/setter：

@ConfigurationProperties(prefix = "config")
public class Config {
    int a;
    String b;
    float c;
    long d;

    // 必须添加getter和setter，Spring依赖这些方法完成属性绑定
    public int getA() { return a; }
    public void setA(int a) { this.a = a; }
    public String getB() { return b; }
    public void setB(String b) { this.b = b; }
    public float getC() { return c; }
    public void setC(float c) { this.c = c; }
    public long getD() { return d; }
    public void setD(long d) { this.d = d; }
}

2. 在项目的配置类（如启动类）上添加@EnableConfigurationProperties(Config.class)，Spring会自动注册Config Bean并完成配置绑定：

@SpringBootApplication
@EnableConfigurationProperties(Config.class)
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

此时ClassB可以完全删除，ClassA保留@Component即可正常注入Config。

三、修改配置文件后异常消失但读取不到值的原因及解决 #

原因分析 #

1. 异常消失的本质：当把配置改成根级别的a=1等后，ClassB上的@ConfigurationProperties未指定前缀，Spring无法将根级别属性绑定到ClassB的嵌套config字段上，导致配置绑定逻辑未触发复杂的Bean依赖流程，循环依赖异常只是“假消失”，而非真正解决。
2. 读取不到值的原因：
   • 配置前缀不匹配：原逻辑中Config是ClassB的嵌套字段，需要配置前缀为config才能绑定到Config的属性；改成根级别属性后，Spring无法识别这些值属于Config对象。
   • Config缺少getter/setter：Spring的@ConfigurationProperties绑定依赖getter/setter方法注入属性值，即使前缀正确，没有这些方法也无法完成绑定。

解决方法 #

如果坚持使用ClassB作为中间层：

1. 给ClassB的@ConfigurationProperties指定前缀：

@ConfigurationProperties(prefix = "config")
@Configuration
public class ClassB { 
    @NestedConfigurationProperty
    Config config = new Config();

    @Bean
    public Config getConfig() {
        return config;
    }

    public void setConfig(Config config) {
        this.config = config;
    }    
}

2. 给Config类添加完整的getter和setter方法。

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