依赖冲突和循环依赖

排除依赖冲突的常见步骤和解决方案

检查依赖树

• Maven：执行 mvn dependency:tree 查看所有依赖及其版本，定位冲突点。

• Gradle：执行 ./gradlew dependencies（或 gradle dependencies）查看依赖树。
  目标：找到哪些依赖引入了不同版本的同一库（例如 com.example:lib:1.0 和 com.example:lib:2.0）。

确定冲突原因

• 通常由间接依赖传递导致，例如

<!-- 示例：A依赖B:1.0，B依赖C:1.0 -->
<dependency>
  <groupId>A</groupId>
  <artifactId>A</artifactId>
  <version>1.0</version>
</dependency>
<!-- 另一个依赖D强制要求C:2.0 -->
<dependency>
  <groupId>D</groupId>
  <artifactId>D</artifactId>
  <version>1.0</version>
</dependency>

:::danger
冲突表现为编译或运行时错误（如 NoSuchMethodError）

:::

解决冲突的方法

方法1：排除冲突依赖

     <!-- Maven示例：在D的依赖中排除C:1.0 -->
     <dependency>
         <groupId>D</groupId>
         <artifactId>D</artifactId>
         <version>1.0</version>
         <exclusions>
             <exclusion>
                 <groupId>C</groupId>
                 <artifactId>C</artifactId>
             </exclusion>
         </exclusions>
     </dependency>
     

     // Gradle示例：排除依赖
     implementation('D:D:1.0') {
         exclude group: 'C', module: 'C'
     }
     

方法2：强制指定版本

     <!-- Maven：在dependencyManagement中统一版本 -->
     <dependencyManagement>
         <dependencies>
             <dependency>
                 <groupId>C</groupId>
                 <artifactId>C</artifactId>
                 <version>2.0</version> <!-- 指定目标版本 -->
             </dependency>
         </dependencies>
     </dependencyManagement>

     // Gradle：使用resolutionStrategy
     configurations.all {
         resolutionStrategy {
             force 'C:C:2.0'
         }
     }
     

工具辅助

Maven Enforcer Plugin：自动检查依赖冲突。

     <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-enforcer-plugin</artifactId>
         <executions>
             <execution>
                 <goals>
                     <goal>enforce</goal>
                 </goals>
                 <configuration>
                     <rules>
                         <dependencyConvergence/>
                     </rules>
                 </configuration>
             </execution>
         </executions>
     </plugin>
     

• Gradle Dependency Insights：执行 ./gradlew dependencies --configuration compileClasspath --scan 获取详细冲突分析。

验证修改

重新执行 dependency:tree 或 dependencies 命令，确认冲突已解决。
运行单元测试或关键功能，确保无新问题引入。

排查和解决循环依赖

确认循环依赖的具体表现

常见错误：Spring启动时抛出 BeanCurrentlyInCreationException 或 CircularDependencyException。

日志示例：

     The dependencies of some of the beans have cycled:
     A → B → C → A

分析代码中的依赖关系

• 当前文件 TokenFilter.java：
  • 依赖 com.example.utils.JwtUtils（静态工具类，无Bean注入）。
  • 本身未直接导致循环依赖，需检查其他类。
• 可能的循环依赖场景：
  • 其他Bean（如 JwtUtils 或 TokenFilter 的依赖）存在相互引用。
  • 例如：类A注入类B，而类B又注入类A。

解决方案

方法1：重构代码

将循环依赖的类拆分为独立的接口或类。

示例：

// 原循环：A依赖B，B依赖A
// 解决方案：将B的部分功能提取到C接口
public interface CService {
    void doSomething();
}

@Service
public class AService {
    private final CService cService;
    // 移除对BService的直接依赖
}

@Service
public class BService {
    private final AService aService;
}

方法2：使用 @Lazy 注解

延迟初始化其中一个Bean，打破循环。

     @Service
     public class AService {
         private final BService bService;
         
         // 使用@Lazy延迟注入
         public AService(@Lazy BService bService) {
             this.bService = bService;
         }
     }

方法3：调整作用域（Scope）

将其中一个Bean设置为 prototype 作用域：

     @Service
     @Scope("prototype")
     public class BService {
         // ...
     }
     

方法4：检查组件扫描

确保没有重复或错误的 @ComponentScan 导致意外Bean创建

工具辅助分析

Spring Boot Actuator：

启用 dependencies 端点，访问 /actuator/dependencies 查看依赖树。

IDE工具：

使用 IntelliJ IDEA 的 Analyze > Detect Cycles 功能。