从单体到微服务：Java新手也能懂的分布式架构实战

大家好，我是小林，一名211高校计算机专业的研二学生。过去一年里，我在实习和开源项目中频繁接触微服务架构，也经常在 GitHub 上看到很多初学者对“微服务”这个词既好奇又畏惧。我自己当初学的时候，光是“服务注册”“负载均衡”这些术语就让我头疼了好久。所以今天，我想用最平实的语言，带完全没有后端经验的朋友，亲手把一个简单的单体应用改造成真正的微服务系统。

这篇文章不需要你懂 Spring Cloud、Docker 或 Kubernetes——只要你会写一点 Java，装过 JDK，就能跟着做。我会手把手教你搭建环境、拆分服务、实现通信，并把完整代码托管在 GitHub 上供你参考。

---

为什么我们需要微服务？

先说人话：微服务就是把一个大应用拆成多个小应用，每个小应用独立运行、独立部署、各司其职。

想象一下，你开发了一个电商网站（比如叫 ShopApp），一开始功能简单：用户登录、浏览商品、下单。所有代码都写在一个项目里，部署时只需要打一个 JAR 包，启动一个进程——这就是 单体架构（Monolith）。

但随着业务增长，团队变大，问题来了：

• 每次改一个小功能（比如加个优惠券），都要重新打包整个应用；
• 一个模块出错（比如支付超时），可能拖垮整个系统；
• 不同团队互相干扰，合并代码冲突不断。

于是，聪明的工程师们想到：不如把“用户管理”、“商品服务”、“订单处理”拆成三个独立的服务！它们各自用 Java 写，各自部署，通过网络互相调用。这就是 微服务架构（Microservices Architecture）。

✅ 微服务的核心优势：

• 独立开发、测试、部署
• 故障隔离（一个服务挂了不影响其他）
• 技术栈灵活（A 服务用 Java，B 服务用 Go 也可以）

当然，微服务也有代价：运维更复杂、调试更困难、网络延迟增加。但对于中大型项目，收益远大于成本。

---

开发环境准备（5 分钟搞定）

我们使用最主流的 Java 微服务技术栈：Spring Boot + Spring Cloud Alibaba。别担心版本问题，我给你整理好了！

必装软件清单

软件	版本	作用
JDK	17	Java 运行环境
Maven	3.8+	项目依赖管理
IDE	IntelliJ IDEA（社区版免费）	代码编辑器
Nacos	2.2.3	服务注册与配置中心
Git	最新版	代码版本控制

第一步：安装 JDK 和 Maven

• 到 Oracle 官网 或 Adoptium 下载 JDK 17，安装后配置 JAVA_HOME。
• 下载 Maven 并配置环境变量（可选，IDEA 内置 Maven）。

第步二：启动 Nacos（服务注册中心）

Nacos 是阿里巴巴开源的服务发现与配置管理工具，轻量又强大。

# 克隆 Nacos 官方仓库
git clone https://github.com/alibaba/nacos.git

# 进入目录并启动（standalone 模式）
cd nacos
sh startup.sh -m standalone  # Linux/Mac
# startup.cmd -m standalone   # Windows

启动成功后，浏览器访问 http://localhost:8848/nacos，默认账号密码都是 nacos。你会看到一个干净的控制台——这就是微服务的“电话簿”，所有服务都要在这里登记自己。

💡 提示：如果不想本地安装，也可直接下载 Nacos 发行版，解压后运行 bin/startup.sh。

第三步：创建 GitHub 仓库（可选但推荐）

在 GitHub 上新建一个仓库，比如叫 microservice-demo，用于保存你的代码。这样既能版本管理，又能随时回溯。

git init
git add .
git commit -m "init project"
git remote add origin https://github.com/yourname/microservice-demo.git
git push -u origin main

---

核心概念通俗讲

在动手前，先搞懂四个关键词：

1. 服务提供者（Provider）

负责提供功能的服务。比如 user-service 提供“根据 ID 查询用户”接口。

2. 服务消费者（Consumer）

需要调用其他服务的功能。比如 order-service 需要知道用户信息，就得调用 user-service。

3. 服务注册中心（Registry）

所有服务启动时都要向它“报到”（注册），调用时先问它“谁提供这个服务？”。Nacos 就是干这个的。

4. 服务间通信（RPC/HTTP）

服务之间怎么调用？最简单的方式是 HTTP + JSON。Spring Cloud 提供了 RestTemplate 和更高级的 OpenFeign。

📌 我当初学的时候总混淆“注册中心”和“API 网关”，记住：

• 注册中心 = 通讯录（谁在哪）
• API 网关 = 大门保安（统一入口、鉴权、限流）

---

实战：把单体应用拆成两个微服务

我们将从一个最简化的单体应用开始，然后拆分成 user-service 和 order-service。

第一阶段：构建单体原型（理解业务）

假设原单体应用有两个接口：

• GET /user/{id} → 返回用户信息
• GET /order/{id} → 返回订单信息（包含用户信息）

代码结构如下（Spring Boot）：

// UserController.java
@RestController
public class UserController {
    @GetMapping("/user/{id}")
    public User getUser(@PathVariable Long id) {
        return new User(id, "张三");
    }
}

// OrderController.java
@RestController
public class OrderController {
    @GetMapping("/order/{id}")
    public Order getOrder(@PathVariable Long id) {
        // 直接硬编码用户信息（实际应查数据库）
        User user = new User(1L, "张三");
        return new Order(id, user);
    }
}

这个应用虽然能跑，但 OrderController 和 UserController 耦合在一起。现在我们要拆！

---

第二阶段：拆分 user-service

1. 新建 Spring Boot 项目（用 start.spring.io）

   • Group: com.example
   • Artifact: user-service
   • Dependencies: Spring Web, Nacos Discovery

2. 添加 Nacos 配置（application.yml）

server:
  port: 8081

spring:
  application:
    name: user-service  # 服务名，必须唯一！
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848  # Nacos 地址

3. 编写 UserController

@RestController
public class UserController {
    @GetMapping("/user/{id}")
    public User getUser(@PathVariable Long id) {
        // 实际应查数据库，这里简化
        return new User(id, "张三");
    }
}

4. 启动服务
   • 运行 UserApplication.main()
   • 刷新 Nacos 控制台，你会看到 user-service 出现在“服务列表”中 ✅

---

第三阶段：构建 order-service（作为消费者）

1. 新建 order-service 项目

   • Dependencies: Spring Web, Nacos Discovery

2. 配置 application.yml

server:
  port: 8082

spring:
  application:
    name: order-service
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

3. 关键：注入 RestTemplate 并启用服务发现

@Configuration
public class RestTemplateConfig {
    @Bean
    @LoadBalanced  // 启用负载均衡
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

4. 在 OrderController 中调用 user-service

@RestController
public class OrderController {

    @Autowired
    private RestTemplate restTemplate;

    @GetMapping("/order/{id}")
    public Order getOrder(@PathVariable Long id) {
        // 重点：这里用服务名 "user-service" 而不是 IP:PORT！
        String url = "http://user-service/user/1";
        User user = restTemplate.getForObject(url, User.class);
        return new Order(id, user);
    }
}

5. 启动 order-service
   • 同样会注册到 Nacos
   • 访问 http://localhost:8082/order/100，如果返回包含用户信息的订单，说明调用成功！

🔍 原理揭秘：
@LoadBalanced 注解让 RestTemplate 自动集成 Ribbon（客户端负载均衡）。当你写 http://user-service/... 时，它会：

1. 询问 Nacos：“user-service 在哪？”
2. Nacos 返回 IP 列表（比如 192.168.1.10:8081）
3. 自动选择一个地址发起 HTTP 请求

---

新手常见问题 & 解决方案

❌ 问题1：启动报错 “No instances available for user-service”

原因：order-service 启动时，user-service 还没注册到 Nacos。

解决：

• 先启动 user-service，等 Nacos 显示在线后再启 order-service
• 或在 order-service 的 RestTemplate 调用处加重试逻辑（生产环境必备）

❌ 问题2：跨服务调用超时

原因：默认 HTTP 超时时间太短（1 秒）。

解决：在 application.yml 中配置：

ribbon:
  ReadTimeout: 5000
  ConnectTimeout: 2000

❌ 问题3：服务名大小写敏感吗？

答案：不敏感，但强烈建议全小写 + 中划线（如 payment-service），避免兼容性问题。

❌ 问题4：如何本地调试两个服务？

• 在 IDEA 中分别运行两个 main 方法
• 使用不同端口（8081、8082）
• 打断点时，两个服务互不影响

---

学习建议与下一步路线图

恭喜你！你已经完成了微服务最核心的一步：服务拆分与远程调用。但这只是起点。接下来你可以：

🚀 进阶方向

领域	推荐学习内容	开源项目参考
服务治理	熔断（Sentinel）、限流、降级	Alibaba Sentinel
配置中心	动态修改配置无需重启	Nacos Config
API 网关	统一入口、路由、鉴权	Spring Cloud Gateway
分布式事务	跨服务数据一致性	Seata
容器化部署	Docker + Kubernetes	——

💡 我的避坑指南

1. 不要过早拆分：如果你的项目只有 3 个接口，别强行微服务！单体更简单。
2. 日志要集中：每个服务打印自己的日志，后期排查困难。建议集成 ELK 或 SkyWalking。
3. 接口契约先行：服务 A 调用 B 前，先约定好 JSON 格式，避免字段对不上。
4. 善用 GitHub：把每个服务单独建 repo，或用 multi-module 结构。我的 demo 代码已开源：github.com/lin-micro/microservice-demo（模拟链接）

---

写在最后

微服务不是银弹，但它确实是现代后端开发的必经之路。我当初第一次看到服务在 Nacos 上自动注册、自动发现时，那种“原来系统可以这样协作”的震撼感，至今难忘。

希望这篇教程能帮你迈出第一步。记住：所有复杂的架构，都始于一行能跑通的代码。别怕犯错，大胆去改、去试、去 GitHub 上提交你的第一个微服务项目！

如果你觉得有帮助，欢迎在评论区留言，或者给我的 GitHub 项目点个 Star。下期我打算写《用 OpenFeign 替代 RestTemplate：更优雅的服务调用》，敬请期待！

作者：小林｜211 CS 研究生｜专注后端与云原生
原创不易，转载请联系授权