本文提供 Spring Boot 3.x 核心依赖版本兼容指南。涵盖版本选择策略（推荐 3.2.4）、数据存储（Redis、MySQL、MongoDB、Elasticsearch）、消息队列（RabbitMQ、Kafka、RocketMQ）、安全框架及监控运维的依赖配置。强调通过 dependencyManagement 统一管理版本，显式声明关键组件版本，并使用 Maven 命令排查冲突。旨在帮助开发者避免常见依赖冲突错误，确保项目稳定运行。
如果你有过这样的经历：
那么问题的核心大概率是版本依赖冲突。Spring 生态虽然强大，但其庞大的依赖网络就像一张精密的蜘蛛网，一个版本不匹配就可能导致整个系统崩溃。
本文将为你提供 Spring Boot 3.x 最全的依赖版本兼容指南，涵盖数据存储、消息队列、搜索引擎等核心组件，每个推荐都经过实际项目验证。
| Spring Boot 版本 | 发布日期 | 维护状态 | 推荐使用场景 |
|---|---|---|---|
| 3.2.x | 2023 年 11 月 | 主动维护期 | 新项目首选 |
| 3.1.x | 2023 年 5 月 | 维护期 | 已上线项目 |
| 3.0.x | 2022 年 11 月 | 仅安全更新 | 尽快升级 |
结论：新项目一律使用 Spring Boot 3.2.4（当前最新稳定版）
在 pom.xml 中，必须使用 来统一管理版本：
<!-- 父工程配置 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.2.4</version>
<relativePath/>
</parent>
<!-- 或者使用 BOM 方式 -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>3.2.4</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
常见坑点：Lettuce 客户端版本不兼容导致连接失败、序列化配置错误
<!-- Spring Boot 3.2.x 中 Redis 完整配置 -->
<dependencies>
<!-- 核心 starter -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 连接池（必须添加） -->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
<version>2.12.0</version>
</dependency>
<!-- JSON 序列化（推荐） -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.15.4</version>
</dependency>
</dependencies>
版本兼容性验证表：
| 组件 | 推荐版本 | 兼容性说明 | 不兼容版本 |
|---|---|---|---|
| Spring Data Redis | 3.2.4 | ✅ 官方内置 | 任何 3.0 以下 |
| Lettuce 客户端 | 6.3.1 | ✅ 自动管理 | 6.2 以下有性能问题 |
| Jedis 客户端 | 4.4.6 | ⚠️ 可选备用 | 3.x 系列不兼容 JDK 17+ |
| Commons Pool2 | 2.12.0 | ✅ 必须显式声明 | 2.11.x 存在内存泄漏 |
配置示例：
spring:
data:
redis:
host: localhost
port: 6379
password:
lettuce:
pool:
max-active: 8
max-idle: 8
min-idle: 0
max-wait: 100ms
# 关键配置：避免序列化错误
timeout: 2000ms
connect-timeout: 1000ms
<!-- MySQL 8.x 兼容配置 -->
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>8.2.0</version>
<!-- 注意：8.0.33 有严重 bug -->
<scope>runtime</scope>
</dependency>
<!-- 或者 PostgreSQL -->
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
<version>42.7.1</version>
<scope>runtime</scope>
</dependency>
<!-- Spring Data JPA -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
数据库驱动紧急避坑指南：
| 数据库 | 驱动版本 | 关键问题 | 解决方案 |
|---|---|---|---|
| MySQL 8.x | 8.2.0+ | 8.0.33 时区处理 bug | 必须升级到 8.2.0+ |
| PostgreSQL | 42.7.1 | 42.6.x SSL 连接问题 | 使用 42.7.1 |
| H2 Database | 2.2.224 | 内存泄漏修复 | 测试环境推荐 |
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>
<!-- 如果需要反应式编程 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-mongodb-reactive</artifactId>
</dependency>
MongoDB 驱动兼容性：
重要提示：Elasticsearch 8.x 与 Spring Boot 3.x 有重大变更
<!-- Spring Data Elasticsearch 5.x (兼容 Elasticsearch 8.x) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>
<!-- 如果需要直接使用 RestHighLevelClient（已废弃，建议迁移） -->
<dependency>
<groupId>org.elasticsearch.client</groupId>
<artifactId>elasticsearch-rest-high-level-client</artifactId>
<version>7.17.16</version>
<exclusions>
<exclusion>
<groupId>org.elasticsearch</groupId>
<artifactId>elasticsearch</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- 推荐使用新的 Java API Client (Elasticsearch 8.x) -->
<dependency>
<groupId>co.elastic.clients</groupId>
<artifactId>elasticsearch-java</artifactId>
<version>8.12.2</version>
</dependency>
<!-- 必需的 Jackson 依赖 -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</dependency>
Elasticsearch 版本兼容表：
| Spring Boot | Spring Data Elasticsearch | Elasticsearch | Java Client | 兼容性 |
|---|---|---|---|---|
| 3.2.x | 5.2.x | 8.11.x | 8.12.x | ✅ 完美兼容 |
| 3.2.x | 5.2.x | 8.10.x | 8.11.x | ✅ 推荐 |
| 3.1.x | 5.1.x | 8.9.x | 8.10.x | ⚠️ 部分特性不支持 |
| 3.0.x | 5.0.x | 7.17.x | 7.17.x | 🔴 不推荐新项目 |
配置示例：
spring:
elasticsearch:
uris: https://localhost:9200
username: elastic
password: your_password
# 连接超时设置
connection-timeout: 1s
socket-timeout: 30s
data:
elasticsearch:
# 仓库配置
repositories:
enabled: true
# 模板配置
template:
enabled: true
常见问题解决：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-amqp</artifactId>
</dependency>
<!-- 如果需要更高级功能 -->
<dependency>
<groupId>com.rabbitmq</groupId>
<artifactId>amqp-client</artifactId>
<version>5.20.0</version>
</dependency>
<dependency>
<groupId>org.springframework.kafka</groupId>
<artifactId>spring-kafka</artifactId>
<version>3.1.4</version>
<!-- 与 Spring Boot 3.2 完美兼容 -->
</dependency>
<!-- 如果需要 JSON 序列化 -->
<dependency>
<groupId>org.springframework.kafka</groupId>
<artifactId>spring-kafka</artifactId>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</dependency>
Kafka 兼容性警告：
重要：RocketMQ 在 Spring Boot 3.x 中需要特定版本
<!-- RocketMQ Spring Boot Starter -->
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-spring-boot-starter</artifactId>
<version>2.3.3</version>
</dependency>
<!-- RocketMQ Client 核心依赖 -->
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-client</artifactId>
<version>5.1.4</version>
</dependency>
<!-- 日志桥接（重要！避免日志冲突） -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jcl-over-slf4j</artifactId>
</dependency>
RocketMQ 版本兼容表：
| Spring Boot | rocketmq-spring-boot-starter | rocketmq-client | 兼容性说明 |
|---|---|---|---|
| 3.2.x | 2.3.3 | 5.1.4 | ✅ 最佳兼容 |
| 3.2.x | 2.3.2 | 5.1.3 | ✅ 稳定可用 |
| 3.1.x | 2.2.3 | 4.9.7 | ⚠️ 需要额外配置 |
| 3.0.x | 2.1.1 | 4.9.4 | 🔴 存在已知问题 |
配置示例：
rocketmq:
name-server: 127.0.0.1:9876
producer:
group: your-producer-group
send-message-timeout: 3000
retry-times-when-send-failed: 2
consumer:
group: your-consumer-group
# 消费线程数
thread-num-min: 20
thread-num-max: 64
# 消息模型：CLUSTERING（集群）或 BROADCASTING（广播）
message-model: CLUSTERING
常见问题解决：
问题排查依赖排除：
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-spring-boot-starter</artifactId>
<version>2.3.3</version>
<exclusions>
<!-- 排除冲突的日志框架 -->
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
<exclusion>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
</exclusion>
<!-- 排除旧版 fastjson -->
<exclusion>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
<!-- JWT 支持（需要单独引入） -->
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-api</artifactId>
<version>0.12.5</version>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-impl</artifactId>
<version>0.12.5</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-jackson</artifactId>
<version>0.12.5</version>
<scope>runtime</scope>
</dependency>
重要变更：Spring Security 6.x 默认使用更安全的加密算法，如果从 5.x 升级，需要更新密码编码器配置。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- Micrometer + Prometheus -->
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-registry-prometheus</artifactId>
</dependency>
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>
<dependency>
<groupId>io.zipkin.reporter2</groupId>
<artifactId>zipkin-reporter-brave</artifactId>
<version>2.16.4</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!-- 新版 Mockito 需要单独引入 -->
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<version>5.8.0</version>
<scope>test</scope>
</dependency>
<!-- 测试容器支持 -->
<dependency>
<groupId>org.testcontainers</groupId>
<artifactId>testcontainers</artifactId>
<version>1.19.3</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.testcontainers</groupId>
<artifactId>junit-jupiter</artifactId>
<version>1.19.3</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct</artifactId>
<version>1.5.5.Final</version>
</dependency>
<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct-processor</artifactId>
<version>1.5.5.Final</version>
<scope>provided</scope>
</dependency>
<!-- Spring Boot 3.x 使用 SpringDoc 替代 Swagger2 -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>2.3.0</version>
</dependency>
<dependency>
<groupId>com.github.ben-manes.caffeine</groupId>
<artifactId>caffeine</artifactId>
<version>3.1.8</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
# 查看完整依赖树
mvn dependency:tree
# 查看特定依赖的传递依赖
mvn dependency:tree -Dincludes=com.fasterxml.jackson.core
# 生成依赖报告
mvn dependency:analyze-report
场景 1：Jackson 版本冲突
<!-- 在 dependencyManagement 中强制指定 -->
<dependency>
<groupId>com.fasterxml.jackson</groupId>
<artifactId>jackson-bom</artifactId>
<version>2.15.4</version>
<type>pom</type>
<scope>import</scope>
</dependency>
场景 2：SLF4J 多个绑定
<!-- 排除冲突的日志绑定 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
</exclusion>
</exclusions>
</dependency>
场景 3：Spring Framework 版本不一致
<!-- 强制指定 Spring 版本 -->
<properties>
<spring-framework.version>6.1.5</spring-framework.version>
</properties>
在升级前，务必检查：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.2.4</version>
</parent>
<groupId>com.example</groupId>
<artifactId>demo-service</artifactId>
<version>1.0.0</version>
<properties>
<java.version>17</java.version>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
</properties>
<dependencies>
<!-- Web -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- Redis -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
<version>2.12.0</version>
</dependency>
<!-- MySQL -->
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>8.2.0</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- Elasticsearch -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>
<!-- RocketMQ -->
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-spring-boot-starter</artifactId>
<version>2.3.3</version>
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
<exclusion>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- 工具 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<!-- 测试 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>
</project>
使用依赖检查工具：
# OWASP Dependency Check
mvn org.owasp:dependency-check-maven:check
# 版本升级插件
mvn versions:display-dependency-updates
Spring Boot 依赖管理的核心原则：
记住：依赖版本不是越新越好，而是越稳定、越兼容越好。本文推荐的版本都经过生产环境验证，可以直接用于你的项目。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online