Spring Cloud Alibaba 生产实践教程（面向零基础初学者）

CD还没发

2025-06-15 23:03

阅读 219

📌 开篇：什么是 Spring Cloud Alibaba？

你可能听说过“Spring Cloud”，它是一个帮助开发者构建微服务架构的工具集。简单来说，就是帮助我们把一个大系统拆分成多个小系统，让它们各自独立运行、协作完成任务。

而 Spring Cloud Alibaba 是在这个基础上的一个扩展工具集，由阿里巴巴开发并开源，它提供了更适合中国互联网环境的解决方案，比如：

服务注册与发现
分布式配置管理
限流降级
消息通信等

这些功能可以帮助你在开发企业级微服务应用时，更加稳定、高效地应对流量高峰和故障处理。

本篇文章将从最基础开始，手把手带你用 Spring Cloud Alibaba 来搭建一个简单的微服务项目。

🧰 环境准备

在开始之前，请确保你的电脑上已经安装了以下工具：

✅ 1. Java JDK 1.8 或以上版本

你可以通过命令行输入以下命令查看是否安装成功：

java -version

如果没有安装，请前往官网下载安装。

✅ 2. Maven 构建工具

Maven 可以帮我们下载依赖包和管理项目结构。

检查是否安装成功：

mvn -v

没有的话可以从官网下载安装：Maven 官网

✅ 3. IntelliJ IDEA（推荐使用）

IntelliJ IDEA 是一款非常流行的 Java 开发 IDE，社区版免费。下载链接

🧠 核心概念讲解（通俗易懂）

在学习 Spring Cloud Alibaba 前，先理解几个关键术语：

🔹 微服务是什么？

想象一下你要做一顿饭，一个人做所有步骤会很累。那不如请几个人分别负责洗菜、切菜、炒菜……这就是“微服务”的思想：把整个系统拆成多个小服务，各自独立工作。

🔹 Nacos 是什么？

Nacos 是 Spring Cloud Alibaba 中的服务注册中心 + 配置中心。

就像公司内部的电话簿一样，每个部门都能查到其他部门怎么联系。Nacos 就是用来管理这些微服务地址的。

🔹 Sentinel 是做什么的？

当某个服务请求太多，快崩溃的时候，Sentinel 会限制访问量，防止整个系统崩溃。类似于“排队入场”。

🔹 OpenFeign 是什么？

它让我们在调用远程服务时，可以像本地方法一样写代码，不需要自己处理 HTTP 请求细节。

💻 实战项目：从头开始搭建两个微服务

我们将搭建两个服务：

商品服务（product-service）
订单服务（order-service）

并通过 Spring Cloud Alibaba 实现服务注册、配置管理和服务调用。

第一步：创建父工程（方便统一管理子项目）

使用 IntelliJ IDEA 创建一个 Maven 项目，命名为 spring-cloud-alibaba-demo，作为父工程。

修改 pom.xml：

<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>spring-cloud-alibaba-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>product-service</module>
        <module>order-service</module>
    </modules>
    <packaging>pom</packaging>

    <properties>
        <spring.boot.version>2.7.6</spring.boot.version>
        <spring.cloud.version>2021.0.5</spring.cloud.version>
        <spring.cloud.alibaba.version>2021.0.5.0</spring.cloud.alibaba.version>
    </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>
</project>

系统架构设计图-1

第二步：创建 product-service 商品服务

1. 新建 Module —— product-service

添加如下依赖（pom.xml）：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 注册中心 Nacos -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
</dependencies>

2. 启动类

新建 ProductApplication.java：

package com.example.product;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient // 启用 Nacos 注册
public class ProductApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProductApplication.class, args);
    }
}

3. 配置文件 application.yml

server:
  port: 8081

spring:
  application:
    name: product-service
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 # 指定 Nacos 地址

management:
  endpoints:
    web:
      exposure:
        include: "*"

第三步：创建 order-service 订单服务

操作方式和 product-service 类似：

1. 添加依赖（`pom.xml`）：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    <!-- 使用 Feign 调用远程服务 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>
</dependencies>

2. 启动类 OrderApplication.java

package com.example.order;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients // 启用 Feign 客户端
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}

3. 配置文件 application.yml

server:
  port: 8082

spring:
  application:
    name: order-service
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

management:
  endpoints:
    web:
      exposure:
        include: "*"

第四步：建立服务间调用（Order → Product）

1. 创建 Feign 接口

新建 ProductServiceClient.java：

package com.example.order.client;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient(name = "product-service")
public interface ProductServiceClient {
    @GetMapping("/products")
    String getProducts();
}

2. 创建 Controller 调用接口

新建 OrderController.java：

package com.example.order.controller;

import com.example.order.client.ProductServiceClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class OrderController {

    private final ProductServiceClient productServiceClient;

    @Autowired
    public OrderController(ProductServiceClient productServiceClient) {
        this.productServiceClient = productServiceClient;
    }

    @GetMapping("/orders")
    public String getOrders() {
        String products = productServiceClient.getProducts();
        return "订单信息已获取，相关商品为：" + products;
    }
}

3. 在 Product Service 添加接口

在 ProductApplication.java 所在模块中添加一个 ProductController.java：

package com.example.product.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ProductController {

    @GetMapping("/products")
    public String getProducts() {
        return "iPhone 15 Pro, Macbook Air M2";
    }
}

第五步：启动 Nacos Server

你需要先启动 Nacos 服务（它是 Spring Cloud Alibaba 的注册中心），以下是快速启动方式：

下载 Nacos：
👉 GitHub 下载地址
解压后进入目录，运行：

# Windows 用户
startup.cmd -m standalone

# Linux/Mac 用户
sh startup.sh -m standalone

Nacos 默认端口是 8848，访问 http://localhost:8848/nacos 查看控制台（用户名密码都是 nacos）。

第六步：启动服务并测试

依次启动：

product-service
order-service

然后访问：

👉 http://localhost:8082/orders

你会看到结果：

订单信息已获取，相关商品为：iPhone 15 Pro, Macbook Air M2

说明我们的两个服务已经能互相通信！

❓常见问题解答

Q1：启动时报错 No instances available for service: xxx

可能是 Nacos 没有正常启动或服务未正确注册。请检查：

Nacos 是否正在运行？
application.yml 中的 server-addr 是否正确？
服务名是否拼写一致？

Q2：Feign调用失败怎么办？

可能是：

没有启用 Feign，检查启动类是否有 @EnableFeignClients
服务名不正确
接口路径错误或返回类型不匹配

Q3：为什么不能直接用 REST 调用而是要用 Feign？

虽然可以直接用 RestTemplate 调用，但 Feign 提供了更优雅的方式，并支持负载均衡和服务容错，适合生产级开发。

🚀 学习建议

恭喜你完成了第一个 Spring Cloud Alibaba 项目！接下来你可以继续深入学习下面这些内容：

📝 总结

本文从零开始，一步步教你使用 Spring Cloud Alibaba 构建两个微服务之间的通信机制。希望你通过这个教程能够建立起对微服务架构的基础认知，并具备动手实践的能力。

记住：不要怕出错，每一个报错都是一次成长的机会。加油！

如果你喜欢这种从基础讲起的教学风格，欢迎关注我后续的文章更新，我会持续为你提供实用又接地气的 Java 开发内容。

标签:实战经验前端Python算法

最热最新

暂无评论

为你推荐

暂无相关推荐

Spring Cloud Alibaba 生产实践教程（面向零基础初学者）

📌 开篇：什么是 Spring Cloud Alibaba？

🧰 环境准备

✅ 1. Java JDK 1.8 或以上版本

✅ 2. Maven 构建工具

✅ 3. IntelliJ IDEA（推荐使用）

🧠 核心概念讲解（通俗易懂）

🔹 微服务是什么？

🔹 Nacos 是什么？

🔹 Sentinel 是做什么的？

🔹 OpenFeign 是什么？

💻 实战项目：从头开始搭建两个微服务

第一步：创建父工程（方便统一管理子项目）

第二步：创建 product-service 商品服务

1. 新建 Module —— product-service

2. 启动类

3. 配置文件 application.yml

第三步：创建 order-service 订单服务

1. 添加依赖（`pom.xml`）：

2. 启动类 OrderApplication.java

3. 配置文件 application.yml

第四步：建立服务间调用（Order → Product）

1. 创建 Feign 接口

2. 创建 Controller 调用接口

3. 在 Product Service 添加接口

第五步：启动 Nacos Server

第六步：启动服务并测试

❓常见问题解答

Q1：启动时报错 No instances available for service: xxx

Q2：Feign调用失败怎么办？

Q3：为什么不能直接用 REST 调用而是要用 Feign？

🚀 学习建议

推荐路线图：

📝 总结

评论 0

为你推荐

精选内容

Spring Cloud Alibaba 生产实践 教程（面向零基础初学者）

📌 开篇：什么是 Spring Cloud Alibaba？

🧰 环境准备

✅ 1. Java JDK 1.8 或以上版本

✅ 2. Maven 构建工具

✅ 3. IntelliJ IDEA（推荐使用）

🧠 核心概念讲解（通俗易懂）

🔹 微服务是什么？

🔹 Nacos 是什么？

🔹 Sentinel 是做什么的？

🔹 OpenFeign 是什么？

💻 实战项目：从头开始搭建两个微服务

第一步：创建父工程（方便统一管理子项目）

第二步：创建 product-service 商品服务

1. 新建 Module —— product-service

2. 启动类

3. 配置文件 application.yml

第三步：创建 order-service 订单服务

1. 添加依赖（pom.xml）：

2. 启动类 OrderApplication.java

3. 配置文件 application.yml

第四步：建立服务间调用（Order → Product）

1. 创建 Feign 接口

2. 创建 Controller 调用接口

3. 在 Product Service 添加接口

第五步：启动 Nacos Server

第六步：启动服务并测试

❓常见问题解答

Q1：启动时报错 No instances available for service: xxx

Q2：Feign调用失败怎么办？

Q3：为什么不能直接用 REST 调用而是要用 Feign？

🚀 学习建议

推荐路线图：

📝 总结

评论 0

为你推荐

相关推荐

精选内容

Spring Cloud Alibaba 生产实践教程（面向零基础初学者）

1. 添加依赖（`pom.xml`）：