微服务架构设计实战:从单体到分布式
开篇:什么是微服务?为什么需要它?

你有没有遇到过这样的问题:写一个系统的时候,代码越堆越多,维护起来越来越难。改一个小功能,可能要动一整块代码;部署一次还要等好久,风险也越来越大?
这时候,我们就需要用到“微服务(Microservices)”了。
那么,微服务到底是什么?
可以把它想象成一个大蛋糕被切成很多小块:
- 传统的做法是把所有功能都做在同一个项目里,这叫做“单体架构(Monolithic)”,就像是整个蛋糕只有一块。
- 而微服务就是把这个大蛋糕切分成若干个小蛋糕,每个小蛋糕负责一个独立的功能,比如订单服务、用户服务、商品服务等等。
微服务的优点有哪些?
- 易于维护:每一块都是独立的,出问题了只需修改那一块。
- 独立部署:你可以单独上线或更新某一个功能模块。
- 灵活扩展:访问量大的部分可以单独扩容,不需要整体扩。
- 技术多样性:不同的模块可以用不同语言开发,只要能通信就行。
听起来是不是很厉害?那我们就开始一步一步来学习怎么从零开始实现一个简单的微服务项目吧!
环境准备:搭建你的开发环境

为了更好地理解微服务是如何工作的,我们将使用以下工具和技术栈:
- 编程语言:Java
- 框架:Spring Boot + Spring Cloud
- 通信方式:REST API
- 注册中心:Eureka Server
- 构建工具:Maven
- IDE 推荐:IntelliJ IDEA 或 Eclipse
步骤 1:安装 Java 和 Maven
确保你的电脑上已经安装好:
- JDK 1.8 及以上
- Maven
可以通过命令行验证是否安装成功:
java -version
mvn -v
如果出现版本号,就说明安装正确。
步骤 2:安装 Spring Initializr 插件(IDEA)
如果你用的是 IntelliJ IDEA:
- 打开 IDEA
- 进入
File → New → Project - 选择
Spring Initializr,然后点击 Next - 设置项目名称、路径等信息,继续下一步
步骤 3:创建第一个 Spring Boot 项目
这里我们可以先创建一个叫 user-service 的简单服务:
- 在 https://start.spring.io/ 上生成基础项目:
- Project: Maven
- Language: Java
- Spring Boot Version: 最新稳定版即可
- Dependencies: Spring Web, Eureka Discovery Client
下载后解压,导入 IDE 中。
完成之后,就可以进入下一个关键环节了——了解微服务的核心概念。
核心概念:什么是微服务架构中的核心组件?
为了让你能快速理解微服务是怎么协作的,我们来看看几个必须知道的核心概念:
1. 服务注册与发现(Service Registration and Discovery)
👉 理解:微服务之间如何找到对方?
想象一下:你家里有很多设备(电视、空调、冰箱),如果它们彼此不认识,你怎么控制它们?
微服务中有个专门的服务用来帮你记住这些服务在哪,叫做注册中心,常见的是 Eureka、Consul、Nacos 等。
💡 实践示例:启用 Eureka 客户端
在 pom.xml 中加入依赖:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
在主类加注解启用服务注册:
@EnableEurekaClient
@SpringBootApplication
public class UserServiceApplication {
public static void main(String[] args) {
SpringApplication.run(UserServiceApplication.class, args);
}
}
2. 网关(API Gateway)
👉 理解:对外统一入口
假设你想访问系统的多个微服务,难道要记一堆地址吗?网关的作用就是统一路由请求,屏蔽后端复杂性。
例如通过 /user/get 来访问 user-service,通过 /order/list 访问 order-service。
常用网关框架有:Zuul(Netflix)、Spring Cloud Gateway、Gateway for Spring Boot。
3. 服务间通信(Inter-Service Communication)
👉 理解:微服务之间如何“打电话”
有两种常见方式:
- 同步调用(REST / HTTP)
- 异步调用(消息队列)
我们先学最简单的 REST 调用。
💡 示例:使用 Feign Client 实现远程调用
添加依赖:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
开启 Feign 支持:
@EnableFeignClients
@SpringBootApplication
public class OrderServiceApplication {
public static void main(String[] args) {
SpringApplication.run(OrderServiceApplication.class, args);
}
}
定义接口调用:
@FeignClient(name = "user-service")
public interface UserClient {
@GetMapping("/user/{id}")
String getUserById(@PathVariable("id") Long id);
}
4. 配置中心(Config Server)
👉 理解:统一管理配置文件
避免将每个服务的配置硬编码,可以通过配置中心集中管理(比如数据库、git 仓库)。
实战项目:从头搭建两个微服务
我们来实战一下,目标如下:
- 创建一个
user-service,提供用户查询功能 - 创建一个
order-service,可以调用 user-service 查询用户信息 - 使用 Eureka 做服务注册和发现
第一步:启动 Eureka 注册中心
1. 创建 eureka-server 项目
使用 Spring Initializr 创建一个新项目,添加依赖:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>
在主类加上:
@EnableEurekaServer
@SpringBootApplication
public class EurekaServerApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaServerApplication.class, args);
}
}
设置配置文件 application.yml:
server:
port: 8761
eureka:
instance:
hostname: localhost
client:
registerWithEureka: false
fetchRegistry: false
serviceUrl:
defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
运行该项目,在浏览器打开 http://localhost:8761,你应该会看到 Eureka 的界面。
第二步:创建 user-service
1. 添加依赖:
<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>
2. 添加 controller:
@RestController
@RequestMapping("/user")
public class UserController {
@GetMapping("/{id}")
public String getUser(@PathVariable Long id) {
return "用户 ID:" + id;
}
}
3. application.yml 配置:
server:
port: 8081
spring:
application:
name: user-service
eureka:
client:
serviceUrl:
defaultZone: http://localhost:8761/eureka
现在启动 user-service,刷新 Eureka 页面,应该能看到这个服务已注册。
第三步:创建 order-service 调用 user-service
1. 启用 feign client:
@EnableFeignClients
@SpringBootApplication
public class OrderServiceApplication {
public static void main(String[] args) {
SpringApplication.run(OrderServiceApplication.class, args);
}
}
2. 添加 feign 接口:
@FeignClient(name = "user-service")
public interface UserClient {
@GetMapping("/user/{id}")
String getUserById(@PathVariable("id") Long id);
}
3. 添加 controller 调用该接口:
@RestController
@RequestMapping("/order")
public class OrderController {
@Autowired
private UserClient userClient;
@GetMapping("/{userId}")
public String getOrderInfo(@PathVariable Long userId) {
return "订单属于:" + userClient.getUserById(userId);
}
}
4. application.yml 配置:
server:
port: 8082
spring:
application:
name: order-service
eureka:
client:
serviceUrl:
defaultZone: http://localhost:8761/eureka
实际效果测试:
- 启动 eureka-server
- 启动 user-service
- 启动 order-service
- 打开浏览器访问:
http://localhost:8082/order/123
你会看到返回内容为:
订单属于:用户 ID:123
恭喜!你已经完成了第一个微服务架构项目的搭建!
常见问题解答(FAQ)
Q1:为什么我的服务注册不上 Eureka?
原因分析:
- Eureka Server 是否运行正常?
- user-service 的 application.yml 是否配置了正确的 eureka 地址?
解决建议:
- 检查日志中是否有连接异常;
- 确认 Eureka 端口是否开放;
- 查看是否有拼写错误。
Q2:微服务调用时为什么会报错 UnknownHostException?
原因分析: Feign 调用时无法解析服务名(例如 user-service)。
解决办法: 确认你的 order-service 的配置中加入了如下依赖:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>
Spring Boot 2.4 及以后默认使用 LoadBalancer 替代 Ribbon。
Q3:我可不可以不使用 Eureka 做服务发现?
当然可以!还有其他服务发现工具可以选择:
- Consul
- Zookeeper
- Nacos(阿里巴巴出品)
但对新手来说,Eureka 是最容易上手的方式之一。
学习建议:下一步学什么?
掌握了基础微服务架构的设计方法,接下来推荐你沿着以下几个方向继续深入:
🔹 1. 分布式配置中心 Config Server
统一管理多个服务的配置,提高灵活性。
🔹 2. 分布式链路追踪 Sleuth & Zipkin
在微服务调用多了之后,定位问题是难点。Sleuth + Zipkin 可以帮助你追踪每一次请求经过哪些服务。
🔹 3. 限流熔断 Hystrix / Resilience4j
当某个服务崩溃或者响应慢,会不会拖垮整个系统?通过限流和熔断机制保护你的系统。
🔹 4. 消息队列(Kafka / RabbitMQ)
学会使用消息异步通信,进一步提升系统性能与解耦能力。
🔹 5. Docker + Kubernetes 部署微服务
学习如何容器化你的应用,掌握 K8s 部署、运维技巧。
结语
本教程带你一步步从零开始构建了一个简单的微服务系统。虽然它只是一个起点,但它展示了微服务的基本结构、通信方式和服务治理的一些基本思想。
学习微服务的过程就像搭积木——一块一块地往上加,慢慢就会有自己的高楼大厦。坚持实践,勇于探索,你离成为架构师的目标也会越来越近!
祝你学习顺利 🚀!如果有任何问题,欢迎留言交流~

评论 0