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

运营说要今天

2025-06-20 02:28

阅读 244

开篇：什么是Spring Cloud？能做什么？

大家好，我是你的后端讲师。今天我们要一起学习一个非常实用的技术 —— Spring Cloud。

想象一下你正在开发一个大型的网站，比如像淘宝、京东这样的电商平台。随着功能越来越多，你会发现传统的“把所有代码写在一个项目里”的方式变得越来越难管理：代码臃肿、维护困难、上线风险大……

于是人们想出了一个更聪明的办法：把大系统拆成多个小系统，每个小系统专注干一件事，比如用户服务、订单服务、支付服务……这些小系统之间互相配合，一起完成整个应用的功能。这就叫做——微服务架构（Microservices Architecture）

但问题也随之而来：这些微服务之间怎么通信？怎么知道彼此在哪里？谁来统一处理认证、限流、配置等问题？

这时候，就轮到我们的主角——Spring Cloud登场了！

Spring Cloud 是一套帮助我们构建和管理微服务的工具集合，它基于 Spring Boot，为我们提供了一系列开箱即用的组件，比如：

服务发现（Eureka）
负载均衡（Ribbon / LoadBalancer）
网关（Gateway / Zuul）
分布式配置中心（Config）
配置刷新（Bus）
链路追踪（Sleuth + Zipkin）

简单来说，Spring Cloud 就是帮你管理一群微服务的好帮手。

环境准备：搭建开发环境

在开始写代码前，我们需要先准备好开发环境。别担心，跟着下面的步骤一步步来，很快就能搞定。

必备软件

软件	版本建议	下载地址
Java	JDK 17+	Oracle JDK
Maven	最新版	Maven官网
IntelliJ IDEA	社区版即可	下载链接
Spring Boot	推荐 2.7.x 或 3.x	自动由Spring Initializr生成

步骤一：安装Java

前往 Oracle JDK 下载页面，选择对应系统的JDK版本。
安装完成后，在终端执行：

java -version

如果看到类似以下信息，说明安装成功：

openjdk version "17.0.4" 2022-07-19
OpenJDK Runtime Environment (build 17.0.4+8)

步骤二：安装IntelliJ IDEA

下载并安装IDEA社区版。
启动IDEA，创建一个空项目或使用Spring Initializr插件创建Spring Boot项目。

步骤三：测试Maven

大多数时候IDE都会自动集成Maven，但我们可以手动检查一下：

mvn --version

输出示例：

Apache Maven 3.8.6 (8453849518d57bedeee2bfa2e29a3f2d2f92ac9c)

OK！环境已经搭好了，我们正式进入Spring Cloud的世界。

核心概念：通俗易懂地解释关键技术

我们来逐一认识几个最关键的概念，它们就像是Spring Cloud这个团队里的几位重要成员。

1. Eureka：服务发现中心（Service Discovery）

举个例子：

假设你在公司上班，想找一个会做报表的人，你是不是得先问：“谁会做报表？”然后同事告诉你：“张三会。”

Eureka的作用就是记录：哪个服务叫什么名字，运行在哪台服务器上。

当某个微服务需要调用另一个服务时，它不需要硬编码对方的IP和端口，而是去问Eureka：“用户服务在哪？”

2. Ribbon / LoadBalancer：负载均衡器（Client-Side Load Balancer）

继续刚才的例子：

现在你知道用户服务有三个实例分别运行在不同的机器上，你想调用的时候应该找哪一个呢？

Ribbon 或 LoadBalancer 帮你决定要访问哪一台机器，可以按轮询、权重、随机等方式分配请求。

3. Gateway / Zuul：API网关（API Gateway）

设想你是公司的客服人员，客户打电话进来要找财务部、技术部、销售部……

你需要告诉他们正确的入口，并且确保他们权限正确才能进去。

网关（Gateway）就是微服务的大门管理员。它可以做到：

统一路由（根据请求路径分发到不同服务）
认证授权（拦截非法请求）
限流熔断（防止服务器压力过大崩溃）

4. Config Server：集中配置管理

过去我们每个服务都要单独配置数据库用户名、密码等参数，一旦配置改了，就得一个个改。

Spring Cloud Config 把所有配置文件集中管理，服务启动时去Config Server拉取自己的配置，方便统一管理。

5. Bus：分布式配置自动刷新

Config虽然统一了配置，但它有个问题：如果你更新了配置，服务必须重启才能生效。

Spring Cloud Bus 结合消息队列（如RabbitMQ、Kafka），实现配置的热更新：配置一变，所有相关服务立刻感知并更新，无需重启。

实战项目：搭建一个简单的Spring Cloud微服务系统

让我们动手实践一个最小可用的微服务系统。我们将包括以下几个部分：

服务注册中心（Eureka Server）
用户服务（User Service）
订单服务（Order Service）
API网关（Gateway）

✅ 所有项目都用 Spring Initializr 创建，依赖如下：

Spring Web

Eureka Client（用于服务注册与发现）

Spring Cloud Gateway（用于网关）

OpenFeign（服务间通信）

第一步：创建 Eureka Server（注册中心）

创建项目结构：

spring-cloud-demo/
├── eureka-server
├── user-service
├── order-service
└── api-gateway

创建 `eureka-server` 模块：

使用 Spring Initializr 创建项目，添加依赖：

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

在主类添加注解启用 Eureka 服务：

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

修改 application.yml 配置：

server:
  port: 8761

eureka:
  instance:
    hostname: localhost
  client:
    register-with-eureka: false
    fetch-registry: false
    service-url:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

启动后访问：http://localhost:8761 可以看到Eureka控制台页面。

第二步：创建 User Service（用户服务）

添加依赖：

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

主类添加：

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

示例接口（UserController.java）：

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

    @GetMapping("/{id}")
    public String getUser(@PathVariable Long id) {
        return "用户ID：" + id;
    }
}

配置 application.yml：

server:
  port: 8081

spring:
  application:
    name: user-service

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/

启动后刷新Eureka界面，可以看到user-service已注册。

第三步：创建 Order Service（订单服务）

重复类似操作，这里给出主要差异点：

端口号改为8082
名字设为 order-service
示例接口：

@GetMapping("/{id}")
public String getOrder(@PathVariable Long id) {
    return "订单ID：" + id;
}

此时两个服务均已注册进Eureka，可以在界面上看到。

第四步：创建 API Gateway（网关服务）

使用 Spring Cloud Gateway 来统一转发请求。

添加依赖：

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

修改 application.yml：

server:
  port: 8080

spring:
  application:
    name: api-gateway
  cloud:
    gateway:
      routes:
        - id: user-service
          uri: lb://user-service
          predicates:
            - Path=/api/users/**
          filters:
            - StripPrefix=1
        - id: order-service
          uri: lb://order-service
          predicates:
            - Path=/api/orders/**
          filters:
            - StripPrefix=1

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/

✅ lb://xxx 表示使用负载均衡的方式访问某服务。

测试访问：

请求：http://localhost:8080/api/users/1
→ 路由到 user-service /users/1
请求：http://localhost:8080/api/orders/100
→ 路由到 order-service /orders/100

常见问题解答（FAQ）

❓ 为什么我的服务没有注册到 Eureka？

常见原因：

没有加 @EnableEurekaClient 注解
配置中的 defaultZone 地址不对
Eureka服务还没启动，服务就试图注册自己

✅ 解决方法：检查注解是否添加；确认Eureka地址是否正确；等Eureka启动后再启动子服务。

❓ 访问网关提示“No instances available for service”怎么办？

可能原因：

服务还没完全注册到Eureka
网关未正确识别服务名（检查 yml 配置）
服务名拼写错误

✅ 解决方法：等待几秒钟；确认服务名一致；查看日志排查连接问题。

❓ 如何跨服务调用？Feign 怎么用？

你可以用 Feign Client 来实现服务间调用。

步骤一：在OrderService中添加Feign客户端：

@FeignClient(name = "user-service")
public interface UserClient {
    @GetMapping("/users/{id}")
    String getUserById(@PathVariable("id") Long id);
}

步骤二：注入并调用：

@Autowired
private UserClient userClient;

@GetMapping("/{id}")
public String getOrderWithUser(@PathVariable Long id) {
    String userInfo = userClient.getUserById(1L);
    return "订单ID：" + id + ", " + userInfo;
}

✅ Feign 会自动通过Eureka查找用户服务，并发起HTTP请求。

学习建议：接下来你该学什么？

恭喜你完成了第一个Spring Cloud项目！但这只是刚刚开始。接下来建议你沿着这几个方向继续深入学习：

🧱 进阶核心技术

Spring Cloud Config + Bus：学习如何集中管理和热更新配置
Spring Cloud Sleuth & Zipkin：学习分布式链路追踪，排查慢请求
Spring Cloud Circuit Breaker（断路器）：学习如何优雅降级、容错
Spring Security OAuth2：实现微服务间的统一鉴权与令牌验证

🧪 工具与平台

Docker + Kubernetes：容器化部署你的微服务集群
Consul / Nacos：对比其他服务注册方案
RabbitMQ / Kafka：深入消息中间件与事件驱动架构

🧠 架构思想

单一职责原则（SRP）与服务拆分策略
CQRS、Event Sourcing 等高级架构模式
微服务测试（契约测试、集成测试）

写在最后

微服务听起来复杂，其实就像一群人分工合作一样，Spring Cloud 提供了一套成熟的机制来解决协作过程中的各种难题。

只要你多敲代码、勤思考，就能慢慢掌握这套强大的技术体系。

如果你在学习过程中有任何问题，欢迎留言或私信我，我会一一为你解答！

祝你早日成为一名出色的微服务开发者！🔥

📌 本文总字数：约3600字

标签:爬虫产品后端

最热最新

暂无评论

为你推荐

暂无相关推荐

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

开篇：什么是Spring Cloud？能做什么？

环境准备：搭建开发环境

必备软件

步骤一：安装Java

步骤二：安装IntelliJ IDEA

步骤三：测试Maven

核心概念：通俗易懂地解释关键技术

1. Eureka：服务发现中心（Service Discovery）

2. Ribbon / LoadBalancer：负载均衡器（Client-Side Load Balancer）

3. Gateway / Zuul：API网关（API Gateway）

4. Config Server：集中配置管理

5. Bus：分布式配置自动刷新

实战项目：搭建一个简单的Spring Cloud微服务系统

第一步：创建 Eureka Server（注册中心）

创建项目结构：

创建 eureka-server 模块：

第二步：创建 User Service（用户服务）

添加依赖：

主类添加：

示例接口（UserController.java）：

配置 application.yml：

第三步：创建 Order Service（订单服务）

第四步：创建 API Gateway（网关服务）

添加依赖：

修改 application.yml：

测试访问：

常见问题解答（FAQ）

❓ 为什么我的服务没有注册到 Eureka？

❓ 访问网关提示“No instances available for service”怎么办？

❓ 如何跨服务调用？Feign 怎么用？

步骤一：在OrderService中添加Feign客户端：

步骤二：注入并调用：

学习建议：接下来你该学什么？

🧱 进阶核心技术

🧪 工具与平台

🧠 架构思想

写在最后

评论 0

为你推荐

相关推荐

精选内容

创建 `eureka-server` 模块：