SpringBoot 升级，依赖冲突如何解决

面对几十个甚至上百个依赖，确实很难一眼看出该改哪一个。其实你不需要逐个去猜，按照下面这三个步骤，就能精准定位并解决需要修改的依赖：

1. 优先使用 Spring Boot 官方提供的"迁移神器"

Spring Boot 官方非常贴心地提供了一个专门用于版本升级的辅助工具。你只需要在项目的 pom.xml 中临时加入以下依赖：

xml 复制代码

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

加入后重新启动你的项目，这个工具会在控制台自动分析你的配置和依赖，并直接打印出日志提示，告诉你哪些属性被废弃了、哪些依赖版本不兼容，甚至会给出修改建议。等升级工作全部完成后，记得把这个依赖删掉即可。

2. 借助 IDE 的可视化依赖图（最直观的方法）

如果你使用的是 IntelliJ IDEA，排查依赖冲突会变得非常简单：

打开项目根目录下的 pom.xml 文件。
在文件内容区域点击鼠标右键，选择 Maven -> Show Dependencies （或者直接按快捷键 Ctrl + Alt + Shift + U）。
IDEA 会弹出一个巨大的依赖关系拓扑图。在这个图中，红色的连线 就代表发生了版本冲突。你可以直接在图上搜索报错的类库名称（比如 spring-security），快速找到是哪个第三方库偷偷引入了旧版本。

3. 使用 Maven 命令精准过滤（最快的方法）

如果你不想看复杂的拓扑图，可以直接在终端使用命令，只把报错的依赖树打印出来。比如针对你遇到的 Security 报错，执行：

mvn dependency:tree -Dincludes=org.springframework.security

或者针对你之前遇到的 Jackson 报错：

mvn dependency:tree -Dincludes=com.fasterxml.jackson.core

控制台会清晰地展示出类似这样的层级结构：

text 复制代码

[INFO] +- com.某个第三方库:lib-xxx:1.0
[INFO] |  \- org.springframework.security:spring-security-web:5.8.0  <-- 罪魁祸首在这里！
[INFO] \- org.springframework.boot:spring-boot-starter-security:6.4.5

通过这种过滤，你能立刻发现是 com.某个第三方库 强行带入了旧版的 5.8.0。定位到后，直接在该第三方库的 <dependency> 标签里加上 <exclusions> 排除掉这个旧版本即可。

💡 一个重要的避坑建议

在修改依赖版本时，强烈不建议 直接在 <dependency> 标签里给单个库写死版本号（例如手动把 security 改成 6.4.5）。

因为 Spring Boot 4.0.5 的父工程（spring-boot-starter-parent）内部已经通过 BOM（物料清单）帮你管理好了所有兼容的依赖版本。如果你手动写死版本，很容易破坏这种兼容性，导致出现其他奇怪的 NoClassDefFoundError。

正确的做法是： 先通过上述方法找出是哪个"捣乱"的第三方库引入了旧版本，把它排除（exclusion）掉，剩下的核心依赖放心地交给 Spring Boot 父工程去自动管理。