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

线上救火队

2025-06-22 04:37

阅读 347

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

你可能听说过“微服务”这个词，如果你是刚接触后端开发的新手，可能会觉得这听起来很复杂。别担心，我们可以一步一步来。

什么是 Spring Cloud？

Spring Cloud 是一组用于构建分布式系统的工具包。它基于 Spring Boot（一个快速构建 Java 应用的框架）之上，提供了一系列组件，帮助开发者更容易地开发、部署和管理多个相互协作的服务。

你可以把它想象成一套厨房工具箱：里面有锅碗瓢盆、刀具、调料等等，而你要做的只是学会如何使用这些工具去做一顿饭，而不是自己造一套餐具。

为什么要学习 Spring Cloud？

在传统项目中，所有功能都写在一个应用里，比如用户登录、下单、支付都在一起。这种架构叫做“单体应用”，适合小项目。但随着业务变大，单体应用就变得越来越难维护：

修改一个小地方，整个系统都要重新部署
出问题的时候，很难定位是哪一块出错了
扩展性差，性能瓶颈难以突破

微服务架构就是为了解决这些问题。简单来说，就是把一个大系统拆分成多个小系统，每个小系统负责一部分功能。它们可以独立开发、测试、部署，还能分别扩展。

Spring Cloud 能帮你做什么？

服务注册与发现：让各个小服务能够自动找到彼此
负载均衡：请求太多怎么办？分摊到多个服务器上处理
配置中心：统一管理所有服务的配置文件
断路器：一个服务出问题不会影响其他服务
网关路由：给外部访问提供统一入口
链路追踪：方便排查问题

接下来，我们将一步步教你搭建环境，并完成一个简单的实战项目！

环境准备：搭建你的开发环境

新手友好提示：本教程以 Java + Maven + IntelliJ IDEA 为基础，如果你还没装好，请按以下步骤操作。

第一步：安装 JDK（Java 开发工具包）

前往 Oracle 官网或 OpenJDK 下载 JDK 17
安装完成后，在终端输入：
```
java -version
```
如果看到类似下面的输出，说明安装成功：
```
openjdk version "17.0.x"
```

第二步：安装 Maven

Maven 是用来管理依赖和打包项目的工具。

下载并解压 Maven：Maven 官网
配置环境变量：
- MAVEN_HOME：指向你解压的目录
- PATH 添加 %MAVEN_HOME%\bin
检查是否安装成功：
```
mvn -v
```
你应该能看到 Maven 的版本号。

第三步：安装 IntelliJ IDEA（推荐使用社区版）

前往 JetBrains官网下载 IntelliJ IDEA 社区版
安装完成后打开，设置你的 JDK 和 Maven：
- 进入 Settings → Build, Execution, Deployment → Build Tools → Maven
- 设置 Maven 主目录为你安装的路径
- 设置 settings.xml 和本地仓库路径（默认即可）

第四步：创建第一个 Spring Boot 项目（使用 Spring Initializr）

我们使用 Spring Initializr 网站快速生成项目模板：

访问网站
填写如下信息：
- Project: Maven
- Language: Java
- Spring Boot Version: 选择最新稳定版（如 3.1）
- Group: com.example
- Artifact: demo
- Name: demo
- Packaging: Jar
- Java: 17
在 Dependencies 中搜索添加：
- Spring Web
点击 Generate 生成项目
解压后导入 IntelliJ IDEA：
- File → New → Project from Existing Sources → 选择解压后的文件夹
- 选择 Maven 项目，点击 Finish

现在你已经准备好进入 Spring Cloud 的世界了！

核心概念：通俗理解 Spring Cloud 的关键概念

在正式实战前，我们先来了解几个核心概念。我会尽量用日常生活中的比喻，帮助你更轻松理解。

1. 微服务是什么？

就像一家餐厅，有厨师、服务员、洗碗工等不同角色。微服务也是这样，每个服务各司其职，配合完成整体工作。

✅ 举个例子：电商系统中可以把用户服务、订单服务、商品服务各自作为一个微服务。

2. 服务注册与发现（Eureka）

想象你在一个大型公司上班，每天要找不同的同事合作。你能挨个问别人在哪儿吗？当然不行！所以你会去查看通讯录或者员工列表。

在微服务中也是一样：服务启动后要向 Eureka 注册自己的位置（IP、端口），其他服务需要调用它时就通过 Eureka 查找。

3. 负载均衡（Ribbon / LoadBalancer）

当一个服务有很多实例运行的时候，调用方不能只选其中一个，否则压力会集中在某个节点上。负载均衡就像安排任务的人，每次随机或轮询分配请求到不同的服务器上。

4. 远程调用（OpenFeign）

你跟同事沟通不可能直接冲进人家办公室，而是打电话、发邮件。远程调用就是通过网络调用另一个服务的方法。Spring Cloud 提供了一个简化工具叫 OpenFeign。

5. 网关（Gateway）

就像火车站检票口，不管你是哪个车次，都必须从这里进站。网关是所有请求的统一入口，它可以做权限控制、URL重定向、限流等操作。

6. 分布式配置中心（Config）

你家有多个房间，每个房间都要开灯。如果有一天你想改成节能灯，难道要一间间去换？太麻烦了。

同样的道理，所有服务的配置文件统一放在 Config Server 中，修改一次就能同步到所有服务。

7. 断路器（Resilience4j / Hystrix）

Hystrix 虽然已经停更，但我们仍然可以用 Resilience4j 实现类似的断路机制。它的作用就像是电路里的保险丝：某个服务崩溃时，不让整个系统瘫痪。

实战项目：动手做一个简单的微服务系统

我们来做个小项目：一个“图书借阅系统”，包含两个服务：

用户服务（user-service）：记录用户信息
图书服务（book-service）：提供图书信息

我们会实现：

搭建 Eureka 注册中心
启动两个服务并注册到 Eureka
用户服务调用图书服务获取数据
用 Gateway 统一入口访问服务

让我们开始吧！

第一步：创建 Eureka 注册中心

创建新项目：

使用 Spring Initializr 创建一个新项目：

Group: com.example
Artifact: eureka-server
Dependencies:
- Spring Web
- Eureka Server

修改 `pom.xml`（确保包含以下依赖）：

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

修改 `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/

启用 Eureka Server：

在主类加上注解：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

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

✅ 启动项目，访问 http://localhost:8761 查看 Eureka 控制台。

第二步：创建图书服务（book-service）

新项目配置：

Group: com.example
Artifact: book-service
Dependencies:
- Spring Web
- Eureka Client
- Spring Data JPA
- H2 Database

添加依赖 `pom.xml`：

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

修改 `application.yml`：

server:
  port: 8081

spring:
  application:
    name: book-service
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password:

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

创建 Book 实体类：

package com.example.bookservise.entity;

import jakarta.persistence.*;

@Entity
public class Book {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String title;
    private String author;

    // Getter & Setter
}

创建 Repository 接口：

package com.example.bookservise.repository;

import com.example.bookservise.entity.Book;
import org.springframework.data.jpa.repository.JpaRepository;

public interface BookRepository extends JpaRepository<Book, Long> {
}

创建 Controller：

package com.example.bookservise.controller;

import com.example.bookservise.entity.Book;
import com.example.bookservise.repository.BookRepository;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/books")
public class BookController {

    private final BookRepository repository;

    public BookController(BookRepository repository) {
        this.repository = repository;
    }

    @GetMapping
    public List<Book> getAllBooks() {
        return repository.findAll();
    }

    @PostMapping
    public Book createBook(@RequestBody Book book) {
        return repository.save(book);
    }
}

✅ 启动项目后，在 Eureka 页面能看到 book-service 已注册。

第三步：创建用户服务（user-service）

这个服务会调用图书服务接口，获取图书信息。

创建新项目：

Group: com.example
Artifact: user-service
Dependencies:
- Spring Web
- Eureka Client
- Feign Client
- Spring Data JPA
- H2 Database

修改 `application.yml`：

server:
  port: 8080

spring:
  application:
    name: user-service
  datasource:
    url: jdbc:h2:mem:userdb
    driver-class-name: org.h2.Driver
    username: sa
    password:

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

创建 User 实体类和 Repository（略过）

创建 Feign Client：

新建 package client，创建如下接口：

package com.example.userservice.client;

import com.example.userservice.dto.BookDto;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

import java.util.List;

@FeignClient(name = "book-service")
public interface BookClient {

    @GetMapping("/books")
    List<BookDto> getBooks();
}

📝注意：这里的 BookDto 是对图书服务返回结构的一个简化封装类。

创建 UserController：

package com.example.userservice.controller;

import com.example.userservice.client.BookClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

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

    @Autowired
    private BookClient bookClient;

    @GetMapping("/books")
    public String getBooksFromBookService() {
        return bookClient.getBooks().toString();
    }
}

✅ 启动 user-service，访问 /users/books 就可以看到图书服务返回的数据了！

第四步：配置 API 网关（Spring Cloud Gateway）

为了方便外部访问，我们添加一个网关服务。

创建新项目：

Group: com.example
Artifact: gateway-service
Dependencies:
- Spring Cloud Gateway
- Eureka Client

修改 `application.yml`：

server:
  port: 8088

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

        - id: book-service
          uri: lb://book-service
          predicates:
            - Path=/books/**
          filters:
            - StripPrefix=1

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

🔍 解释：

lb 表示使用负载均衡方式转发请求

predicates 定义匹配的 URL

filters 表示过滤器规则（StripPrefix=1 表示去掉第一级路径）

✅ 启动网关服务后，你可以通过网关访问：

获取用户书籍：http://localhost:8088/users/books
获取所有图书：http://localhost:8088/books

是不是看起来统一又优雅？

常见问题解答（FAQ）

数据库设计模型-1

Q1：我启动服务时报错 “UnknownHostException”

原因：可能是 Eureka 地址写错了或者没有正确连接。

解决办法：

检查 application.yml 中 Eureka 的地址是否为 http://localhost:8761/eureka/
确保 Eureka Server 已经运行，并可以通过浏览器访问

Q2：为什么访问不了 Feign 接口？

原因：

可能没加注解 @EnableFeignClients
可能 URI 错误，比如拼写错误或没有注册服务

解决办法：

在主类添加：
```
@EnableFeignClients
```
查看 FeignClient 的 name 是否正确指向已注册服务名

Q3：Spring Cloud Gateway 路由配置不生效？

原因：

YAML 文件缩进格式错误
路由配置写错了字段名或值类型

解决办法：

使用在线 YAML 格式校验工具检查语法
查看 Spring Cloud Gateway 文档确认关键字是否正确

学习建议：下一步学什么？

恭喜你完成了你的第一个 Spring Cloud 微服务项目！继续深入学习，你可以考虑以下几个方向：

1. 学习 Spring Cloud Alibaba

包含更多实用组件，如 Nacos（替代 Eureka）、Sentinel（流量控制）、Seata（分布式事务）等

2. 掌握分布式日志和监控

引入 Sleuth 和 Zipkin 实现链路追踪
使用 Spring Boot Admin 监控服务状态

3. 学习服务熔断与降级

更深入了解 Resilience4j 的使用
实践超时、重试策略

4. 部署与运维

将项目部署到 Docker
学习 Kubernetes 编排容器

结语

Spring Cloud 虽然是个“高阶技术”，但它并不神秘，只要一步步来，任何人都能掌握。

这篇教程从最基础的概念讲起，带大家亲手搭建了一个完整的微服务系统。如果你跟着做完，你就已经具备了独立搭建简单微服务项目的能力！

记住一句话：

“编程不是靠记代码，而是靠练代码。”

希望你在 Spring Cloud 的学习路上越走越远，写出真正高性能、可扩展的分布式系统！

📌 如果你喜欢这种风格的教学文章，欢迎继续关注后续系列文章，比如《Spring Cloud Alibaba实战》《微服务架构设计模式详解》等！

祝你学习愉快 😊

标签:GitHubJava面试题挑战技术分享

最热最新

暂无评论

为你推荐

暂无相关推荐

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

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

什么是 Spring Cloud？

为什么要学习 Spring Cloud？

Spring Cloud 能帮你做什么？

环境准备：搭建你的开发环境

第一步：安装 JDK（Java 开发工具包）

第二步：安装 Maven

第三步：安装 IntelliJ IDEA（推荐使用社区版）

第四步：创建第一个 Spring Boot 项目（使用 Spring Initializr）

核心概念：通俗理解 Spring Cloud 的关键概念

1. 微服务是什么？

2. 服务注册与发现（Eureka）

3. 负载均衡（Ribbon / LoadBalancer）

4. 远程调用（OpenFeign）

5. 网关（Gateway）

6. 分布式配置中心（Config）

7. 断路器（Resilience4j / Hystrix）

实战项目：动手做一个简单的微服务系统

第一步：创建 Eureka 注册中心

创建新项目：

修改 pom.xml（确保包含以下依赖）：

修改 application.yml：

启用 Eureka Server：

第二步：创建图书服务（book-service）

新项目配置：

添加依赖 pom.xml：

修改 application.yml：

创建 Book 实体类：

创建 Repository 接口：

创建 Controller：

第三步：创建用户服务（user-service）

创建新项目：

修改 application.yml：

创建 User 实体类和 Repository（略过）

创建 Feign Client：

创建 UserController：

第四步：配置 API 网关（Spring Cloud Gateway）

创建新项目：

修改 application.yml：

常见问题解答（FAQ）

Q1：我启动服务时报错 “UnknownHostException”

Q2：为什么访问不了 Feign 接口？

Q3：Spring Cloud Gateway 路由配置不生效？

学习建议：下一步学什么？

1. 学习 Spring Cloud Alibaba

2. 掌握分布式日志和监控

3. 学习服务熔断与降级

4. 部署与运维

结语

评论 0

为你推荐

相关推荐

精选内容

修改 `pom.xml`（确保包含以下依赖）：

修改 `application.yml`：

添加依赖 `pom.xml`：

修改 `application.yml`：

修改 `application.yml`：

修改 `application.yml`：