初学小结Spring Cloud 依赖那些事儿

最新推荐文章于 2025-07-19 21:00:41 发布

原创最新推荐文章于 2025-07-19 21:00:41 发布 · 1.3k 阅读

12 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#spring cloud #spring #后端

Spring Cloud 专栏收录该内容

1 篇文章

订阅专栏

Spring Cloud的依赖那些事

最近正在学微服务，写到这时刚学完 Eureka 和 Spring Cloud LoadBalancer，正在推进Nacos，但是在引入依赖的时候脑子突然一想：怎么又要搞这么多依赖，好麻烦。想到这突然意识到之前学习的组件的依赖好像还是似懂非懂，又往前推，之前父子工程的各种pom文件似乎也不明白，于是，我与AI展开了一轮一轮的交流，最终对这些东西有了些许了解。为了方便记忆也为了请教大家帮忙找错，因此简单整理了如下内容：

父工程的pom文件：

<?xml version="1.0" encoding="UTF-8"?>
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>spring-cloud-eureka</artifactId>
    <version>1.0-SNAPSHOT</version>

    <modules>
        <module>order-service</module>
        <module>product-service</module>
        <module>eureka-server</module>
    </modules>

    <packaging>pom</packaging>


    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.6</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <java.version>17</java.version>
        <mybatis.version>3.0.3</mybatis.version>
        <mysql.version>8.0.33</mysql.version>
        <spring-cloud.version>2022.0.3</spring-cloud.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
            <dependency>
                <groupId>com.mysql</groupId>
                <artifactId>mysql-connector-j</artifactId>
                <version>${mysql.version}</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter-test</artifactId>
                <version>${mybatis.version}</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

<modules>：声明包含的子模块，子模块目录需与这里的配置一致
<packaging>：指定项目打包方式。这里的值pom表示当前项目是 父项目（聚合项目），不执行实际代码编译和打包，仅用于管理子模块和依赖版本。
<parent> ：继承配置。
<properties>：定义可复用的变量，这些变量可以在 POM 文件的其他地方通过${变量名}引用，方便统一管理版本。像这里配置了很多的依赖版本号。
<dependencies>：声明当前项目（父项目）直接依赖的构件。如果是父项目，这些依赖会传递给子项目，但是这里配置了：optional=true 切断了依赖传递，表示该依赖不会传递给子模块（子模块需显式声明才会引入）。
<dependencyManagement>：集中管理依赖的版本号、作用域等属性，但不实际引入依赖，其作用：
1. 统一依赖版本：所有子项目使用相同的依赖版本，避免版本冲突
2. 可选依赖声明：子项目可以选择是否引入这些依赖
3. 简化子项目配置：子项目只需声明依赖而无需指定版本
4. 可覆盖：子项目可以覆盖依赖版本

除此之外，父项目中还包含：

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- 其他项此处省略 -->
        </dependencies>
    </dependencyManagement>

spring-cloud-dependencies 是 Spring Cloud 提供的一个 BOM（Bill of Materials，物料清单），作用是统一管理 Spring Cloud 所有组件的版本。BOM 本身不引入任何依赖，只是定义了一组相互兼容的依赖版本，确保项目中各个 Spring Cloud 组件（如 Eureka、Nacos、Gateway 等）能够正确协作。它帮我们解决了（他暖我哭）：

版本冲突：不同组件依赖同一个库的不同版本，导致运行时错误。
兼容性问题：某些组件版本之间不兼容，导致功能异常。

在 Spring Cloud 项目中，引入 spring-cloud-dependencies BOM 是必须的。

某一子项目的POM文件：

<?xml version="1.0" encoding="UTF-8"?>
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>spring-cloud-eureka</artifactId>
        <groupId>org.example</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>order-service</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
    </dependencies>
    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <profile.name>dev</profile.name>
            </properties>
        </profile>
        <profile>
            <id>prod</id>
            <properties>
                <profile.name>prod</profile.name>
            </properties>
        </profile>
    </profiles>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
                <includes>
                    <include>**/**</include>
                </includes>
            </resource>
        </resources>
    </build>

</project>

<parent>：指定了父项目spring-cloud-eureka，与父项目的配置对应
不难发现，像数据库和MyBatis的依赖还是需要显示声明，但是不需要版本号了，因为父项目的<dependencyManagement>已经帮我们管理了。

注意这个依赖：

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>

这是一个聚合依赖，它不仅与Eureka有关，还与负载均衡有关，即：它既是 Eureka 组件的依赖，也是 Spring Cloud LoadBalancer 的依赖。这种设计体现了 Spring Cloud 的 “组件协同” 理念，通过一个依赖项解决一组相关问题，大大简化了微服务架构的开发难度。

在这里插入图片描述

因此，按照Eureka -> Spring Cloud LoadBalancer的顺序学习到Spring Cloud LoadBalancer时，无需为其手动再添加任何依赖。

学习Nacos时的一个POM文件（子项目）：

<?xml version="1.0" encoding="UTF-8"?>
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>spring-cloud-nacos</artifactId>
        <groupId>org.example</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>order-service</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
        </dependency>


        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-loadbalancer</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
                <includes>
                    <include>**/**</include>
                </includes>
            </resource>
        </resources>
    </build>

</project>

这里想要使用Spring Cloud LoadBalancer作为负载均衡组件，但需要手动引入，与之前Eureka的依赖不同的是：
spring-cloud-starter-alibaba-nacos-discovery 是 Alibaba 提供的 Starter，仅负责服务注册与发现功能，不包含负载均衡逻辑。它更聚焦于自身组件（Nacos），不会主动引入 Spring Cloud 生态的其他通用组件（如 LoadBalancer）。