03、Spring Cloud Alibaba:用 BOM 管理依赖版本

给出已解析的 Boot、Cloud、Alibaba BOM 组合,说明依赖管理与实际依赖的区别。

简明结论

BOM 只管理版本;导入兼容组合后仍须声明实际依赖,并检查最终解析结果。

为什么导入 BOM 后仍然找不到类?

BOM 管理版本约束,不会把其中所有组件加入应用。还要在 dependencies 中声明实际使用的 starter。不要只改一个 Nacos 客户端版本就假定整个组合兼容。

本页固定 Boot 3.2.4、Cloud 2023.0.1、Alibaba 2023.0.1.0;官方对应表列出 Nacos 2.3.2、Sentinel 1.8.6。本次选择用于复现实验,不代表最新版本或仍受支持的生产升级方案。

完整实验 POM

下面包含本轮示例共同使用的依赖;真实应用只保留需要的组件。Java 21 与 Maven 3.9.9 可运行本轮测试。H2 只用于缓存测试。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.2.4</version></parent>
  <groupId>site.cxykk.examples</groupId><artifactId>phase3-spring</artifactId><version>1.0.0</version>
  <properties><java.version>21</java.version><build.dir>${project.basedir}/target</build.dir></properties>
  <dependencyManagement><dependencies>
    <dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>2023.0.1</version><type>pom</type><scope>import</scope></dependency>
    <dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-alibaba-dependencies</artifactId><version>2023.0.1.0</version><type>pom</type><scope>import</scope></dependency>
  </dependencies></dependencyManagement>
  <dependencies>
    <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
    <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-security</artifactId></dependency>
    <dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId></dependency>
    <dependency><groupId>com.alibaba.csp</groupId><artifactId>sentinel-core</artifactId><version>1.8.6</version></dependency>
    <dependency><groupId>com.alibaba.csp</groupId><artifactId>sentinel-spring-webmvc-adapter</artifactId><version>1.8.6</version></dependency>
    <dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.16</version></dependency>
    <dependency><groupId>com.h2database</groupId><artifactId>h2</artifactId><scope>test</scope></dependency>
    <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
    <dependency><groupId>org.springframework.security</groupId><artifactId>spring-security-test</artifactId><scope>test</scope></dependency>
  </dependencies>
  <build><directory>${build.dir}</directory><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId><configuration><systemPropertyVariables><nacos.logging.default.config.enabled>false</nacos.logging.default.config.enabled><nacos.client.logging.logpath>/tmp/phase3-nacos-client</nacos.client.logging.logpath><csp.sentinel.log.dir>/tmp/phase3-sentinel</csp.sentinel.log.dir></systemPropertyVariables></configuration></plugin></plugins></build>
</project>

如何检查实际生效的版本

mvn help:effective-pom -Doutput=effective-pom.xml
mvn dependency:tree

预期:Spring Context 6.1.5、Spring Security Web 6.2.3、Nacos Client 2.3.2;检查输出是否有项目自己覆盖的版本。本次已生成 effective POM 并执行对应测试。dependencyManagement 中写了版本不等于该 jar 一定在运行时类路径上;还要看 dependency tree。

排查顺序与边界

先查父 POM 和所有导入 BOM,再查显式版本、冲突选择及排除项,最后检查实际运行的包。不要靠随意添加排除项压住兼容性错误。生产升级还需重新核对目标版本的 JDK 要求、配置加载方式和组件支持周期。

下一步:验证两个 Nacos 配置的覆盖顺序。

整理范围与出处

本次依据下方版本资料整理说明与示例;历史导入资料的来源状态单独列示,不将技术参考认作原作者信息。原始发布日期与地址保留。