Spring Cloud从零开始：微服务入门指南

独立开发小站

2025-06-16 11:08

阅读 654

🚀 一、开篇：Spring Cloud 是什么？它能做什么？

如果你第一次听说 Spring Cloud，可能一头雾水。别担心，我们一步步来。

1.1 微服务是什么？

在讲解 Spring Cloud 前，先搞清楚一个概念：微服务（Microservice）。

传统的应用结构是“单体应用”（Monolithic Application），就像一栋大楼，所有房间都建在一起，装修升级时可能整栋楼都要停工。

而微服务是一种架构风格，就像把一座大楼拆成多个独立的小屋，每间小屋各自独立运行和维护。

每个功能模块是一个独立的服务
各个服务之间可以通过网络通信协作完成任务
可以各自部署、扩展和更新

这就像现代的城市建筑群：银行、便利店、咖啡馆……它们是独立运营的，但又能彼此配合。

1.2 Spring Cloud 是什么？

Spring Cloud 就是用来搭建这种微服务架构的一套工具集。

你可以把它理解为：

🧰 Spring Cloud = 构建微服务系统的零件包
它包括服务注册发现、配置管理、网关、负载均衡、熔断机制等核心功能。

这些功能听起来有点高深，不用担心，我们后面会逐个展开。

⚙️ 二、环境准备：开发环境搭建

要玩转 Spring Cloud，你需要以下几个基本工具：

2.1 Java 环境安装（JDK）

Spring 生态是基于 Java 的，所以我们需要先装好 JDK。

下载地址：https://www.oracle.com/java/technologies/downloads/
推荐使用 JDK 8 或 JDK 17（长期支持版本）
配置环境变量 JAVA_HOME

java -version

确保输出类似如下内容即可：

openjdk version "17.0.3" 2022-04-19
OpenJDK Runtime Environment (build 17.0.3+7-Ubuntu-0ubuntu120.04)
OpenJDK 64-Bit Server VM (build 17.0.3+7-Ubuntu-0ubuntu120.04, mixed mode, sharing)

2.2 IDE 工具推荐

IntelliJ IDEA（强烈推荐）
Eclipse + Spring Tools 插件（可选）

💡 Tip：下载 IntelliJ 社区版免费使用即可。

2.3 Maven 安装与配置

Maven 是 Java 项目依赖管理工具。

下载地址：https://maven.apache.org/download.cgi
解压并配置环境变量
验证：

mvn -v

正常输出类似这样就成功了：

Apache Maven 3.8.5 (...)
Java version: 17.0.3, vendor: Ubuntu, runtime: /usr/lib/jvm/java-17-openjdk-amd64
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "5.15.0-46-generic", arch: "amd64", family: "unix"

2.4 Spring Boot 与 Spring Cloud 版本兼容性

Spring Cloud 是建立在 Spring Boot 上面的，所以你需要知道两者的版本匹配关系。

推荐组合如下：

Spring Boot	Spring Cloud
2.6.x	2021.0.x（即代号为 Jubilee）
2.7.x	2021.0.x
3.0.x	2022.0.x

初学建议选择 Spring Boot 2.7.x + Spring Cloud 2021.0.x 搭配。

🔑 三、核心概念通俗讲

下面这几个词听起来很高大上，其实都很简单。我们用生活中的例子类比说明。

3.1 Eureka（服务注册中心）

想象你在一个大型商场里开店，顾客怎么找到你？

你需要把你的店名、位置、营业时间告诉商场管理处——这就是“服务注册”。

Eureka 就是这个商场管理处，它记录所有微服务的位置信息，其他服务就可以通过它找人。

提供服务注册和发现能力
所有服务启动后都需要向 Eureka 注册自己
其他服务想调用时去 Eureka 查看地址

3.2 Ribbon（负载均衡器）

还是上面的例子，你开了三家分店，客户该去哪家？

Ribbon 就像商场给你做的分流系统，它帮助你在多个相同服务之间做请求分配。

实现客户端负载均衡
避免某一台服务器过热

3.3 Feign（远程调用）

你想点隔壁便利店的餐怎么办？打个电话过去下单。

Feign 就像是给每个服务配备了一个“电话接口”，让服务之间可以方便地互相打电话。

支持声明式 REST 调用
不用写 HTTP 请求代码也能完成远程调用

3.4 Config Server（配置中心）

你家电视、空调、路由器都有密码或设置项，如果每一台设备都要手动改密码，岂不是很麻烦？

Config Server 相当于集中管理你所有的配置文件，统一修改、同步生效，省时又安全。

集中管理多环境配置（dev/test/prod）
支持 Git、本地等多种存储方式

3.5 Zuul（API 网关）

你是进入小区的大门，外面的人不能随意进出，必须经过你的登记和引导。

Zuul 就是这个大门管理员，它对外暴露统一入口，内部路由不同的服务。

路由请求到正确的服务实例
提供认证、限流等功能

🧪 四、实战项目：动手搭建第一个微服务系统

现在我们来实践一下，搭建一个简单的 Spring Cloud 微服务系统。

我们将创建三个服务：

Eureka Server（服务注册中心）
User Service（用户服务）
Product Service（商品服务）

然后实现一个 API：GET /user/product/1，表示获取 ID 为 1 的产品属于哪个用户。

4.1 创建 Eureka Server（服务注册中心）

步骤 1：新建 Spring Boot 项目

用 start.spring.io 创建项目：

Group: com.example
Artifact: eureka-server
Spring Boot: 2.7.x
Dependencies: Spring Web、Eureka Server

步骤 2：添加 Eureka Server 依赖（pom.xml）

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

步骤 3：配置 application.yml

server:
  port: 8761

eureka:
  instance:
    hostname: localhost
  client:
    registerWithEureka: false
    fetchRegistry: false
    serviceUrl:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

步骤 4：启用 Eureka Server

@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaServerApplication.class, args);
    }
}

启动后访问：http://localhost:8761，看到 Eureka 控制台页面就成功啦！

4.2 创建 User Service（用户服务）

步骤 1：新建 Spring Boot 项目

Group: com.example
Artifact: user-service
Spring Boot: 2.7.x
Dependencies: Spring Web、Eureka Client、Rest Repositories（可选）

步骤 2：添加 Eureka Client 依赖

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

步骤 3：配置 application.yml

server:
  port: 8080

spring:
  application:
    name: user-service

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

步骤 4：编写 Controller 示例代码

@RestController
@RequestMapping("/user")
public class UserController {

    @GetMapping("/{id}")
    public String getUserById(@PathVariable Long id) {
        return "User with ID: " + id;
    }
}

启动后，在 Eureka 页面能看到 USER-SERVICE 注册成功。

4.3 创建 Product Service（商品服务）

和上面步骤基本一样，只是端口改为 8081，name 变成 product-service。

server:
  port: 8081

spring:
  application:
    name: product-service

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

示例 Controller：

@RestController
@RequestMapping("/product")
public class ProductController {

    @GetMapping("/{id}")
    public String getProductById(@PathVariable Long id) {
        return "Product with ID: " + id;
    }
}

4.4 实现跨服务调用（Feign）

现在我们要让用户服务调用产品服务。

步骤 1：添加 Feign 依赖

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

步骤 2：启用 FeignClient

@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients
public class UserServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }
}

步骤 3：定义 Feign Client 接口

@FeignClient(name = "product-service")
public interface ProductClient {

    @GetMapping("/product/{id}")
    String getProductById(@PathVariable Long id);
}

步骤 4：调用服务接口

@GetMapping("/product/{productId}")
public String getUserAndProduct(@PathVariable Long productId) {
    String productInfo = productClient.getProductById(productId);
    return "Calling product info: " + productInfo;
}

打开浏览器输入：

http://localhost:8080/user/product/1

你将看到调用结果：

Calling product info: Product with ID: 1

🎉 恭喜！你完成了第一个 Spring Cloud 微服务项目的构建！

❓五、常见问题解答（FAQ）

Q1：为什么服务没注册到 Eureka？

检查 application.yml 中的 eureka.client.serviceUrl.defaultZone 是否正确
检查是否加上了 @EnableEurekaClient 注解
重启 Eureka 后再试一次

Q2：Feign 调用失败怎么办？

确保两个服务都注册成功
检查 Feign 接口是否加了 @FeignClient 和 @EnableFeignClients
添加 Ribbon 依赖试试（某些版本需要）

Q3：启动报错 “Port already in use”

换个端口号吧！比如改成 8082、8083……

server:
  port: 8082

Q4：如何查看所有已注册的服务？

打开 Eureka 地址 http://localhost:8761，你会看到当前注册的所有服务列表。

📚 六、下一步学习建议

恭喜你走完了入门的第一步！接下来你可以继续学习以下方向：

✅ 进阶主题推荐

技术点	学习内容
Hystrix	熔断机制，服务失败时优雅降级
Gateway/Zuul	统一路由、权限控制、限流
Config Server	集中式配置管理，适合生产环境
Sleuth & Zipkin	分布式日志追踪，用于排查复杂请求链的问题
RabbitMQ/Kafka	异步消息队列，实现服务之间的异步通信
Security	用户登录认证、OAuth2、JWT 等安全性处理

📖 推荐阅读资料

👨‍💻 Spring 官方文档：https://docs.spring.io/spring-cloud/docs/current/reference/html/
📘 书籍《Spring Cloud微服务实战》
🎓 B站视频教程搜索关键词：“Spring Cloud 教程入门”、“微服务实战教程”
👩‍🏫 Udemy/Bilibili 上都有很多新手友好课程

🌟 结语

Spring Cloud 是构建微服务系统的核心工具集，虽然一开始看起来有些复杂，但只要你跟着步骤一步步动手操作，很快就能上手！

记住一句话：

技术没有那么难，关键是敢动手。

希望这篇教程能为你打开微服务世界的大门，祝你早日成为 Spring Cloud 大神！

如需完整项目源码或其他进阶帮助，欢迎留言提问 😊

标签:Python工具产品Javascript

最热最新

暂无评论

为你推荐

暂无相关推荐

Spring Cloud从零开始：微服务入门指南

🚀 一、开篇：Spring Cloud 是什么？它能做什么？

1.1 微服务是什么？

1.2 Spring Cloud 是什么？

⚙️ 二、环境准备：开发环境搭建

2.1 Java 环境安装（JDK）

2.2 IDE 工具推荐

2.3 Maven 安装与配置

2.4 Spring Boot 与 Spring Cloud 版本兼容性

🔑 三、核心概念通俗讲

3.1 Eureka（服务注册中心）

3.2 Ribbon（负载均衡器）

3.3 Feign（远程调用）

3.4 Config Server（配置中心）

3.5 Zuul（API 网关）

🧪 四、实战项目：动手搭建第一个微服务系统

4.1 创建 Eureka Server（服务注册中心）

步骤 1：新建 Spring Boot 项目

步骤 2：添加 Eureka Server 依赖（pom.xml）

步骤 3：配置 application.yml

步骤 4：启用 Eureka Server

4.2 创建 User Service（用户服务）

步骤 1：新建 Spring Boot 项目

步骤 2：添加 Eureka Client 依赖

步骤 3：配置 application.yml

步骤 4：编写 Controller 示例代码

4.3 创建 Product Service（商品服务）

4.4 实现跨服务调用（Feign）

步骤 1：添加 Feign 依赖

步骤 2：启用 FeignClient

步骤 3：定义 Feign Client 接口

步骤 4：调用服务接口

❓五、常见问题解答（FAQ）

Q1：为什么服务没注册到 Eureka？

Q2：Feign 调用失败怎么办？

Q3：启动报错 “Port already in use”

Q4：如何查看所有已注册的服务？

📚 六、下一步学习建议

✅ 进阶主题推荐

📖 推荐阅读资料

🌟 结语

评论 0

为你推荐

相关推荐

精选内容