Spring Cloud从零开始：微服务入门指南
开篇：Spring Cloud是做什么的？
想象一下你要开发一个大型电商平台，这个平台不仅要有商品展示、购物车、订单处理，还要有用户管理、支付系统、物流跟踪等多个功能模块。如果把这些模块全都写在一个项目里，最终可能会变成一个又大又复杂的“巨无霸”程序，维护和更新都非常困难。
这个时候，我们就可以使用 Spring Cloud 技术来解决这个问题。简单来说，Spring Cloud 是一套帮助开发者构建分布式系统（也就是多个小系统协同工作的架构）的工具集。它让我们可以把每个功能模块拆分成独立的小程序，这些小程序可以单独运行、测试、部署，并通过网络相互沟通。这种方式就叫做 微服务架构。
在实际开发中，我们可以用 Spring Cloud 来实现以下功能：
- 让各个小程序自动发现彼此（服务注册与发现）
- 实现负载均衡（让访问更顺畅）
- 提供统一网关（所有请求走同一个入口）
- 统一配置管理（不用每个服务都改配置）
- 保障系统稳定性（例如限流、熔断）
本篇文章将带你一步步搭建环境，从零开始实践一个简单的 Spring Cloud 微服务项目，让你真正理解它是如何工作的。
环境准备
为了顺利开始我们的学习之旅，我们需要准备好以下开发环境：
安装JDK
- 下载并安装 JDK 8 或以上版本。推荐使用 Oracle JDK 或 OpenJDK。
- 验证安装是否成功，在终端输入：
如果输出了 Java 版本号，则说明安装成功。java -version
安装Maven
- 下载 Maven 并按照官方文档安装：Maven官网
- 验证安装：
mvn -v
安装IDE
推荐使用 IntelliJ IDEA，下载地址：IntelliJ IDEA 社区版
- 打开 IDE，检查 Maven 是否集成
创建父项目结构
新建一个 Maven 工程，命名为 spring-cloud-demo，作为我们的主工程。
pom.xml 中添加 Spring Boot 和 Spring Cloud 的依赖：
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>spring-cloud-demo</artifactId>
<version>1.0-SNAPSHOT</version>
<modules>
<module>eureka-server</module>
<module>product-service</module>
<module>order-service</module>
</modules>
<packaging>pom</packaging>
<properties>
<java.version>11</java.version>
<spring.boot.version>2.7.5</spring.boot.version>
<spring.cloud.version>2021.0.4</spring.cloud.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring.boot.version}</version>
<scope>import</scope>
<type>pom</type>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring.cloud.version}</version>
<scope>import</scope>
<type>pom</type>
</dependency>
</dependencies>
</dependencyManagement>
</project>
核心概念讲解
理解 Spring Cloud 之前，先了解几个核心概念：
1. 服务注册与发现（Eureka Server）
在微服务中，每个服务都是独立运行的小程序。它们需要知道彼此的网络位置才能通信。服务注册与发现就是用来解决这个问题的。
- Eureka Server 是 Netflix 提供的一个服务注册中心。各个服务启动后都会把自己的信息（比如 IP 地址和端口号）告诉 Eureka，其他服务想调用它时，只需要去 Eureka 查询即可。
2. 服务调用（Ribbon + Feign）
- Ribbon 是一个客户端负载均衡器，它可以决定该访问哪个实例（当有多个相同服务时）。
- Feign 是一种声明式接口调用方式，简化远程调用的过程。
3. API 网关（Zuul / Gateway）
API 网关就像是整个系统的统一入口。所有外部请求都先进入网关，由网关再根据请求路径转发给对应的微服务。这样做的好处是可以集中做权限验证、日志记录等通用操作。
4. 分布式配置中心（Config Server）
有时候我们要修改某个服务的配置，例如数据库连接地址、日志等级等。Config Server 可以统一管理这些配置，并且支持动态刷新，让配置改动无需重启服务即可生效。
接下来我们会逐一实践这些功能。
实战项目：构建两个服务并通过 Eureka 实现注册与调用
我们将创建三个模块：
- eureka-server：用于服务注册与发现
- product-service：产品信息服务
- order-service：订单服务，会调用 product-service 获取产品信息
第一步：创建 Eureka Server 服务
创建项目结构
在主工程 spring-cloud-demo 下新增一个子模块 eureka-server，类型为 spring boot project，选择依赖：Eureka Server。
修改配置文件 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/
启动类添加注解
@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaServerApplication.class, args);
}
}
运行并访问控制台
启动后访问 http://localhost:8761，可以看到空的服务列表。
第二步：创建产品服务（Product Service）
创建项目结构
在主工程下添加模块 product-service，选择依赖：Eureka Discovery Client, Spring Web
修改配置文件 application.yml
server:
port: 8081
spring:
application:
name: product-service
eureka:
client:
service-url:
defaultZone: http://localhost:8761/eureka/
编写控制器代码
@RestController
@RequestMapping("/products")
public class ProductController {
@GetMapping("/{id}")
public String getProductById(@PathVariable Long id) {
return "Product ID: " + id + ", Name: iPhone 14";
}
}
主类启用 Eureka 客户端
@SpringBootApplication
@EnableEurekaClient
public class ProductServiceApplication {
public static void main(String[] args) {
SpringApplication.run(ProductServiceApplication.class, args);
}
}
启动后，查看 Eureka 控制台，你会看到 product-service 已经注册进来了。
第三步：创建订单服务（Order Service）并调用产品服务
创建项目结构
添加模块 order-service，选择依赖：Eureka Discovery Client, OpenFeign, Spring Web
修改配置文件 application.yml
server:
port: 8082
spring:
application:
name: order-service
eureka:
client:
service-url:
defaultZone: http://localhost:8761/eureka/
创建 Feign 客户端接口
@FeignClient(name = "product-service")
public interface ProductServiceClient {
@GetMapping("/products/{id}")
String getProductById(@PathVariable("id") Long id);
}
创建订单控制器
@RestController
@RequestMapping("/orders")
public class OrderController {
@Autowired
private ProductServiceClient productServiceClient;
@GetMapping("/{orderId}/product/{productId}")
public String getOrderProduct(@PathVariable Long orderId, @PathVariable Long productId) {
String productInfo = productServiceClient.getProductById(productId);
return "Order ID: " + orderId + ", Product Info: " + productInfo;
}
}
启动类添加注解
@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients
public class OrderServiceApplication {
public static void main(String[] args) {
SpringApplication.run(OrderServiceApplication.class, args);
}
}
启动服务后，访问：http://localhost:8082/orders/1/product/1001
你应该能看到返回的产品信息。
新手常见问题解答
Q1: 为什么我访问 Eureka 控制台看不到注册的服务？
A: 请检查各服务是否设置了正确的 Eureka 地址，并确认服务启动过程中没有报错。
Q2: Feign 调用失败，提示 UnknownHostException
A: 原因可能是服务名称拼写错误，或者服务没有成功注册到 Eureka。检查服务名称和服务注册状态。
Q3: 服务注册上了，但调用的时候总是连不上
A: 查看服务是否暴露了正确的端口，确保网络通畅。
学习建议
完成今天的实战后，你已经掌握了 Spring Cloud 最基础的组件用法。接下来你可以沿着以下几个方向继续学习：
- 引入 Zuul 网关，实现统一访问入口
- 添加 Config Server，尝试热更新配置
- 了解 Hystrix 熔断机制，提高系统容错能力
- 研究 Sleuth+Zipkin，进行分布式链路追踪
- 结合 Spring Security 实现服务安全认证
Spring Cloud 内容丰富，但只要持续动手练习，逐步扩展知识面，你就能够掌握微服务的核心能力，成为一名合格的后端工程师。
祝你编程愉快，越学越轻松！
评论 0