Java 后端 / 知识点

Spring Cloud 微服务速查手册

手册条目

确认 Spring Boot、Spring Cloud 与 Java 版本之间的兼容关系。

选择 Spring Cloud 版本组合

用于新建项目或升级前确认 Spring Boot、Spring Cloud 与 Java 是否处于同一兼容区间。先按 Spring Boot 主版本选择 Cloud Release Train,再选择该列车最新的补丁版本,最后用实际启动验证,避免只看依赖能否下载。

快速选择

截至 2026-08-05,官方兼容表显示:Spring Cloud 2025.1.x 支持 Spring Boot 4.0.x,从 Cloud 2025.1.2 起同时支持 Boot 4.1.x;Boot 4.1.0 最低要求 Java 17。新项目可采用 Java 21/25 + Spring Boot 4.1.0 + Spring Cloud 2025.1.2,生产环境仍应以组织已认证的 JDK 发行版为准。:contentReference[oaicite:0]{index=0}

约束 选择方法
Java 已固定 先确认目标 Boot 是否支持该 JDK
Boot 已固定 查官方 Release Train 映射后选择 Cloud
Cloud 已固定 反向确认支持的 Boot 代际,不跨代试配
新建项目 用 Spring Initializr 生成一次基准工程并对照版本

检查当前版本

以下命令适用于使用 Spring Boot Parent 和 spring-cloud.version 属性的 Maven 项目:

bash
java -version
./mvnw -q help:evaluate -Dexpression=project.parent.version -DforceStdout
./mvnw -q help:evaluate -Dexpression=spring-cloud.version -DforceStdout

预期输出:

text
openjdk version "21.0.<PATCH>" <DATE>
4.1.0
2025.1.2

<PATCH> 与 <DATE> 会随 JDK 补丁变化。若项目没有继承 spring-boot-starter-parent,第二条可能返回其他父 POM 版本;此时改查 mvn help:effective-pom 中的 Boot 插件或 spring-boot-dependencies BOM。

启动验证

版本号看起来匹配后,仍要启动一次应用,让 Spring Cloud 的兼容性检查和自动配置真正执行。先准备好项目依赖的配置中心、注册中心,或在本地配置中关闭不需要的外部连接。

bash
./mvnw -Dspring-boot.run.arguments=--spring.main.web-application-type=none spring-boot:run

预期输出:

text
... Started <APPLICATION_NAME> in <SECONDS> seconds

看到 Started 且日志中没有 Spring Boot ... is not compatible with this Spring Cloud release train,表示组合通过基础启动验证。端口、耗时和应用名属于动态值。

风险与边界

不要在版本不匹配时直接设置 spring.cloud.compatibility-verifier.enabled=false。触发条件是 Boot 与 Cloud 跨越官方支持区间;关闭检查后可能在启动或流量运行阶段出现 NoSuchMethodError、类缺失或自动配置失效。安全替代方案是调整 Boot 或 Cloud 到官方映射区间,并在同一分支完成编译、测试和启动验证。

版本表会随补丁发布变化。升级当天重新核对 Spring Cloud 官方兼容表,并优先选择同一 Release Train 的最新 GA 补丁,不使用 SNAPSHOT、M 或 RC 构建进入生产。

目录与阅读设置

记录一个想法

Spring Cloud 微服务速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通