Spring Boot依赖冲突多数源于手动引入非Starter依赖或错误指定版本,正确做法是只用官方Starter、通过properties覆盖版本、优先选用适配Spring Boot的第三方Starter,并从Spring Initializr生成标准pom。

新手装 Spring Boot 最怕的依赖冲突,其实多数不是 Spring Boot 本身的问题,而是“自己加的依赖”和“Spring Boot 自带的依赖”打架了。提前避免的关键,不是等报错再修,而是从引入依赖的第一步就守住规则。
只用 Starter,别手动写版本号
Spring Boot 的 Starter(比如 spring-boot-starter-web、spring-boot-starter-data-jpa)不是“快捷方式”,而是经过严格测试的版本组合包。它们内部已经锁定了 Spring、Tomcat、Jackson、Hibernate 等组件的兼容版本。
- ✅ 正确做法:直接引入 Starter,不写
- ❌ 错误做法:为了“保险”手动加上
—— 这反而可能覆盖 Spring Boot 内置仲裁版本2.7.18 - ⚠️ 特别注意:不要单独引入
spring-web、mybatis、redis.clients:jedis这类底层库,除非你明确知道自己在做什么
加第三方库前,先查它是否“认 Spring Boot”
很多常用库(如 MyBatis-Plus、Lombok、MapStruct、Redisson)都提供了适配 Spring Boot 的 Starter 或官方推荐集成方式。用这些,比自己拼依赖安全得多。
- 查官网或 GitHub README:搜索 “spring boot starter” 或 “autoconfigure”
- 优先选
mybatis-plus-spring-boot-starter,而不是mybatis-plus+ 手动配mybatis-spring - 像 FastJSON、Gson 这类 JSON 库,Spring Boot 默认用 Jackson;如果非要换,建议用
spring-boot-starter-json统一管理,而不是直接引fastjson
自定义版本?用 properties 覆盖,别硬写 dependency
真有升级需求(比如要用 MySQL 8.4 驱动),Spring Boot 允许你“温柔覆盖”,而不是粗暴替换。
- 在
pom.xml的块里声明:8.4.0 - 这样 Spring Boot 会自动把
mysql-connector-java升到 8.4.0,同时保持和其他组件(如 Spring JDBC)的兼容性 - 千万别在 dependency 里直接写
—— 它会绕过仲裁机制,埋下隐患mysql mysql-connector-java 8.4.0
新建项目时,用 Spring Initializr,别手敲 pom
https://start.spring.io 是 Spring 官方生成器,选好依赖后一键下载,它的 pom 已经按当前 Spring Boot 版本做了最优配置。
- 它默认继承
spring-boot-starter-parent,启用完整的依赖仲裁 - 所有 Starter 都没写 version,所有 properties 都留空——这是最干净的起点
- 对比手写 pom:少一个
漏写、多一个test 错位,都可能引发连锁冲突pom











