项目版本与基础工程搭建

2.1 推荐版本

本笔记使用 2025 版本体系：

Spring Boot: 3.5.0
Spring Cloud: 2025.0.0
Spring Cloud Alibaba: 2025.0.0.0
JDK: 17+
Maven: 3.9+

注意：

Spring Boot、Spring Cloud、Spring Cloud Alibaba 三者版本必须匹配。
不要随意混用版本。

---

2.2 父工程 pom.xml

建议创建一个 Maven 聚合工程：

cloud-demo-2025
  ├── pom.xml
  ├── gateway-service
  ├── order-service
  └── stock-service

父工程 pom.xml：

<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>

    <groupId>com.demo</groupId>
    <artifactId>cloud-demo-2025</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <modules>
        <module>gateway-service</module>
        <module>order-service</module>
        <module>stock-service</module>
    </modules>

    <properties>
        <java.version>17</java.version>
        <spring.boot.version>3.5.0</spring.boot.version>
        <spring.cloud.version>2025.0.0</spring.cloud.version>
        <spring.cloud.alibaba.version>2025.0.0.0</spring.cloud.alibaba.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencyManagement>
        <dependencies>

            <!-- Spring Boot 依赖版本管理 -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <!-- Spring Cloud 依赖版本管理 -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring.cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <!-- Spring Cloud Alibaba 依赖版本管理 -->
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring.cloud.alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

        </dependencies>
    </dependencyManagement>

    <build>
        <pluginManagement>
            <plugins>

                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <configuration>
                        <source>${java.version}</source>
                        <target>${java.version}</target>
                        <encoding>UTF-8</encoding>
                    </configuration>
                </plugin>

                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                    <version>${spring.boot.version}</version>
                </plugin>

            </plugins>
        </pluginManagement>
    </build>

</project>

---

2.3 本地启动 Nacos

下载 Nacos Server 后，进入 Nacos 目录。

单机模式启动：

startup.cmd -m standalone

Linux / macOS：

sh startup.sh -m standalone

默认访问地址：

http://localhost:8848/nacos

常见默认账号密码：

nacos / nacos

---

2.4 本地启动 Sentinel Dashboard

下载 sentinel-dashboard.jar 后启动：

java -jar sentinel-dashboard.jar

默认访问地址：

http://localhost:8080

默认账号密码通常是：

sentinel / sentinel

如果 8080 端口冲突：

java -Dserver.port=8858 -jar sentinel-dashboard.jar

访问地址变成：

http://localhost:8858