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

后端便利贴

2025-06-12 02:38

阅读 489

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

你有没有想过，一个大型互联网应用，比如淘宝、京东或者微信是怎么构建起来的？

这些系统功能庞大、用户众多，如果全部代码都写在一个项目里，那将是无比复杂且难以维护的“巨无霸”程序。于是，微服务架构应运而生 —— 它把整个系统拆分成一个个小模块（也叫服务），每个模块独立开发、部署和运行。

而 Spring Cloud 正是帮助你实现微服务架构的一整套工具集。你可以把它理解为“搭建微服务的乐高积木包”。

简单来说：

Spring Boot 帮你快速开发一个独立的服务
Spring Cloud 则帮你把这些服务连接在一起，并解决服务之间的通信、容错、负载均衡等问题

本教程将从零开始，带你一步步搭建自己的第一个微服务项目。

环境准备：打好基础才能上路

必备工具清单：

工具名称	版本建议	作用说明
Java JDK	JDK 17+	编程语言环境
Maven	3.6+	项目依赖管理器
IntelliJ IDEA 或 VSCode	最新版	写代码的好帮手
Spring Initializr	在线工具	生成项目框架
Postman	浏览器插件或单独软件	接口测试工具

安装步骤简述：

安装 JDK
- Windows 推荐使用 Adoptium
- 安装完可通过命令 java -version 验证是否成功
安装 IntelliJ IDEA 社区版（免费）
- 下载地址：https://www.jetbrains.com/idea/download/
- 打开后可以新建 Spring Boot 项目
配置 Maven（IDE自带一般已配置）
- 如果手动配置，可去 Maven官网下载并设置好环境变量
Postman
- 安装浏览器扩展或桌面版，用于测试 API 接口

核心概念：搞懂微服务中的几个关键词

1. 微服务（Microservice）

就像拼图一样，每个服务都是一个小块，专注于做一件事。

比如：电商系统的“订单服务”只管订单，“用户服务”只处理用户信息

2. 注册中心（Eureka Server）

每个微服务启动后都要去注册自己，告诉别人“我来了，我在哪”。其他服务想调用你时，就去找注册中心问。

3. 负载均衡（Ribbon / LoadBalancer）

如果有多个相同服务在运行，负载均衡器会决定该请求该分配给哪一个。

4. 熔断机制（Hystrix）

当某个服务出问题，不会影响整体系统。熔断机制可以“跳闸”，避免连锁故障。

5. API网关（Gateway）

所有外部请求先进入网关，网关统一管理和路由请求到不同的微服务。

实战项目：打造一个简单的用户服务 + 订单服务

我们来做一个非常简单的例子：有两个服务

用户服务（User Service）：提供查询用户信息的接口
订单服务（Order Service）：提供下单接口，会调用用户服务验证用户是否存在

我们将逐步完成以下任务：

第一步：创建 User Service

使用 Spring Initializr 创建项目：

访问：https://start.spring.io/

选择如下选项：

Project: Maven
Language: Java
Spring Boot Version: 最新稳定版（如 3.x）
Group: com.example
Artifact: user-service
Dependencies:
- Spring Web
- Eureka Client

点击 Generate 按钮下载压缩包并导入 IntelliJ

修改 application.yml 文件：

server:
  port: 8081

spring:
  application:
    name: user-service

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

添加 Controller 示例：

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

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

启动类添加注解：

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

第二步：创建 Order Service

同样使用 Spring Initializr 生成项目：

Artifact: order-service
Dependencies:
- Spring Web
- OpenFeign
- Eureka Client

修改 application.yml：

server:
  port: 8082

spring:
  application:
    name: order-service

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

创建 Feign Client 连接 User Service：

@FeignClient(name = "user-service")
public interface UserClient {

    @GetMapping("/user/{id}")
    String getUserById(@PathVariable String id);
}

创建 OrderController：

@RestController
@RequestMapping("/order")
public class OrderController {

    @Autowired
    private UserClient userClient;

    @GetMapping("/create/{userId}")
    public String createOrder(@PathVariable String userId) {
        String userInfo = userClient.getUserById(userId);
        return "订单创建成功！" + userInfo;
    }
}

启动类加上注解：

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

第三步：搭建 Eureka 注册中心

再次访问 https://start.spring.io/

Artifact: discovery-server
Dependencies:
- Eureka Server

修改 application.yml：

server:
  port: 8761

spring:
  application:
    name: discovery-server

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

启动类加上注解：

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

最后：跑起来看看！

按照顺序依次启动：

discovery-server（注册中心）
user-service（用户服务）
order-service（订单服务）

然后在浏览器中打开：http://localhost:8761 可以看到两个服务已经注册成功

接着访问：

http://localhost:8082/order/create/123

你将会看到输出：

订单创建成功！User ID: 123

这就完成了你的第一个微服务交互！

常见问题解答：新手必看

Q1：启动报错说找不到 Eureka Server 怎么办？

检查 Eureka 是否真的先启动了。如果没有启动，Order 和 User 服务无法注册。

Q2：Feign Client 调用失败怎么办？

确保两件事：

目标服务已注册成功
Feign Client 的 name 属性与目标服务名一致（application.name）

Q3：端口冲突如何解决？

修改各自的 server.port 即可，确保不同服务之间不冲突。

Q4：为什么不能直接调用接口，而要经过 Eureka？

这是为了将来方便横向扩展。假设未来有多个 User 服务同时运行，通过 Eureka + Ribbon 就能自动选择负载最低的那个。

学习建议：下一步可以怎么学？

恭喜你完成第一个 Spring Cloud 微服务项目！接下来你可以继续学习下面的内容：

1. 加强服务治理能力：

Hystrix：掌握熔断与降级，提高服务健壮性
Zuul 或 Gateway：学习 API 网关的使用
Config Server：统一管理各服务的配置文件

2. 优化服务通信方式：

学习基于消息队列的异步通信（如 RabbitMQ、Kafka）
学习 RESTful API 设计规范

3. 微服务进阶技能：

分布式事务（Seata、TCC）
日志聚合（ELK）
链路追踪（Sleuth + Zipkin）

4. 动手练习建议：

把你的毕业设计/课程项目改造成微服务结构
模仿 B站、豆瓣等平台的部分功能模块
自己尝试搭建一个完整的电商平台雏形（包括注册、登录、商品、订单等）

结语：坚持就是进步的捷径

学习 Spring Cloud 虽然看起来有很多组件和术语，但只要你一步一步实践，就能慢慢掌握。

记住这句话：“不要怕不会，只怕不动手。”

现在你已经迈出了第一步，只要持续努力，相信不久之后，你也能独立开发出属于自己的分布式项目！

如果你喜欢这篇教程，欢迎收藏并分享给你的同学朋友。也可以关注我，后续我会推出更多适合初学者的学习内容 🚀

标签:Java综合

最热最新

暂无评论

为你推荐

暂无相关推荐

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

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

环境准备：打好基础才能上路

必备工具清单：

安装步骤简述：

核心概念：搞懂微服务中的几个关键词

1. 微服务（Microservice）

2. 注册中心（Eureka Server）

3. 负载均衡（Ribbon / LoadBalancer）

4. 熔断机制（Hystrix）

5. API网关（Gateway）

实战项目：打造一个简单的用户服务 + 订单服务

第一步：创建 User Service

使用 Spring Initializr 创建项目：

修改 application.yml 文件：

添加 Controller 示例：

启动类添加注解：

第二步：创建 Order Service

修改 application.yml：

创建 Feign Client 连接 User Service：

创建 OrderController：

启动类加上注解：

第三步：搭建 Eureka 注册中心

修改 application.yml：

启动类加上注解：

最后：跑起来看看！

常见问题解答：新手必看

Q1：启动报错说找不到 Eureka Server 怎么办？

Q2：Feign Client 调用失败怎么办？

Q3：端口冲突如何解决？

Q4：为什么不能直接调用接口，而要经过 Eureka？

学习建议：下一步可以怎么学？

1. 加强服务治理能力：

2. 优化服务通信方式：

3. 微服务进阶技能：

4. 动手练习建议：

结语：坚持就是进步的捷径

评论 0

为你推荐

精选内容