首页 > 文章 > java教程

SpringBoot构造器循环依赖解析指南

时间：2025-07-10 12:36:25 319浏览收藏

从现在开始，努力学习吧！本文《避免Spring Boot构造器循环依赖深度解析》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

避免Java Spring Boot构造器循环依赖：一个深度解析

本文旨在解决Java Spring Boot项目中由于构造器之间的循环依赖导致的问题。通过分析示例代码，我们将深入探讨循环依赖产生的原因，并提供有效的解决方案，避免java.lang.StackOverflowError等异常的发生，确保应用程序的稳定运行。

在Java Spring Boot项目中，构造器注入是一种常见的依赖注入方式。然而，不当的使用可能导致循环依赖，进而引发运行时错误。循环依赖指的是两个或多个类相互依赖，形成一个闭环，导致对象无法正确创建。

考虑以下示例：

class A {
    private final M m;

    public A(int x, int y, int z, M m) {
        this.m = m;
        // 初始化操作
    }

    public A(int x, int y, int z) {
        this(x, y, z, new M(new A(x, y, z))); // 潜在的循环依赖
    }

    public void doSomething() {
        System.out.println("A.doSomething() called");
    }
}

class M {
    private final A a;

    public M(A a) {
        this.a = a;
    }

    public void func() {
        a.doSomething();
    }
}

在这个例子中，A 类有两个构造器。第二个构造器接受三个参数，并在内部调用第一个构造器，同时创建一个新的 M 实例，并将一个新的 A 实例传递给 M 的构造器。 M的构造函数又依赖于A的实例。这种设计会导致一个循环依赖：创建 A 的实例需要 M 的实例，而创建 M 的实例又需要 A 的实例，如此循环往复。

问题分析

当调用 A(x, y, z) 构造器时，它会尝试创建一个新的 M 实例。创建 M 实例时，又需要一个 A 实例，这会再次调用 A(x, y, z) 构造器。这个过程会无限循环下去，直到栈溢出，抛出 java.lang.StackOverflowError 异常。

解决方案

避免这种循环依赖的关键在于打破循环。以下是一些常见的解决方案：

移除冗余构造器： 在上面的例子中，A(x, y, z) 构造器是造成循环依赖的根源。可以直接移除该构造器，只保留 A(x, y, z, M m) 构造器，并在外部提供 M 的实例。

class A {
    private final M m;

    public A(int x, int y, int z, M m) {
        this.m = m;
        // 初始化操作
    }

    public void doSomething() {
        System.out.println("A.doSomething() called");
    }
}

class M {
    private final A a;

    public M(A a) {
        this.a = a;
    }

    public void func() {
        a.doSomething();
    }
}

// 外部创建实例
A a = new A(1, 2, 3, new M(new A(1, 2, 3, null))); //需要手动传入一个M对象，避免循环，但是这里的null依然有问题，所以这种方式并不推荐。

注意： 上述代码虽然移除了循环，但是 new A(1, 2, 3, null) 传递了 null 值，会导致空指针异常，因此不推荐使用。

使用Setter注入： 将 M 的实例通过 Setter 方法注入到 A 中，而不是在构造器中注入。

class A {
    private M m;

    public A(int x, int y, int z) {
        // 初始化操作
    }

    public void setM(M m) {
        this.m = m;
    }

    public void doSomething() {
        System.out.println("A.doSomething() called");
    }
}

class M {
    private A a;

    public M() {
    }

    public void setA(A a) {
        this.a = a;
    }

    public void func() {
        a.doSomething();
    }
}

// 外部创建实例并注入
A a = new A(1, 2, 3);
M m = new M();
a.setM(m);
m.setA(a);

注意： 使用Setter注入需要手动设置依赖关系，较为繁琐。

重新设计依赖关系： 这是最根本的解决方案。重新审视 A 和 M 之间的关系，看是否可以将它们解耦，或者将依赖关系调整为单向依赖。例如，可以将 M 的功能合并到 A 中，或者将 A 的部分功能提取到一个新的类中，让 A 和 M 都依赖于这个新的类。

使用Spring的@Lazy注解: 如果在Spring Boot环境中使用依赖注入，可以使用@Lazy注解延迟初始化Bean，从而打破循环依赖。

@Component
class A {
    private final M m;

    public A(M m) {
        this.m = m;
    }

    public void doSomething() {
        System.out.println("A.doSomething() called");
    }
}

@Component
class M {
    private final A a;

    public M(@Lazy A a) { // 使用 @Lazy 注解
        this.a = a;
    }

    public void func() {
        a.doSomething();
    }
}

注意： 使用@Lazy注解会延迟A的初始化，可能会影响性能。
注意： 确保类被Spring容器管理，即使用@Component, @Service, @Repository, @Controller等注解。

总结

构造器循环依赖是Java Spring Boot开发中常见的问题，会导致程序崩溃。解决循环依赖的关键在于打破循环，可以通过移除冗余构造器、使用Setter注入、重新设计依赖关系或使用@Lazy注解等方式来解决。在实际开发中，应尽量避免循环依赖的产生，保持代码的清晰和可维护性。在Spring Boot项目中，优先考虑使用Spring提供的依赖注入机制，并结合@Lazy注解等特性，可以更优雅地解决循环依赖问题。

到这里，我们也就讲完了《SpringBoot构造器循环依赖解析指南》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！