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

大家好，我是正在读研的后端开发者。最近在带几个本科生做毕业设计时发现，很多人对“微服务”这个词既好奇又害怕——好奇是因为它听起来很高级，害怕是因为不知道从哪下手。我自己当初学的时候也是一头雾水，翻了好多文档、踩了无数坑才理清楚思路。

所以今天，我想用最通俗的方式，带你从零搭建一个真正的 Spring Cloud 微服务项目。不讲空理论，全程动手写代码，哪怕你只写过“Hello World”，也能跟着做完！

小提示：本文虽然讲 Java 生态的 Spring Cloud，但也会提到 Go 和 JavaScript 在微服务中的角色，帮助你建立更综合的技术视野。

---

什么是微服务？为什么需要 Spring Cloud？

想象一下，你开发了一个电商网站。如果所有功能（用户登录、商品展示、订单处理、支付）都写在一个项目里，这叫单体应用。初期很简单，但随着功能变多，代码越来越臃肿，改一处可能崩全局。

而微服务就是把大项目拆成多个小服务：

• 用户服务（负责注册/登录）
• 商品服务（管理商品信息）
• 订单服务（处理下单）

每个服务独立开发、部署、运行，通过网络互相调用。好处是：模块清晰、便于团队协作、某个服务挂了不影响整体。

但问题来了：这么多服务怎么互相找到对方？怎么保证高可用？怎么统一配置？

这就是 Spring Cloud 的用武之地！它是一套基于 Spring Boot 的微服务工具集，帮你解决服务注册、配置管理、负载均衡等难题。

---

环境准备：5 分钟搭好开发环境

你需要安装：

工具	版本建议	用途
JDK	17 或 21	Java 运行环境
Maven	3.8+	项目依赖管理
IntelliJ IDEA	社区版即可	开发 IDE
Git	最新版	代码管理

我当初第一次装 JDK 时搞错了版本，结果 Spring Boot 启动报错，折腾半天才发现是 JDK 8 不兼容新版本 Spring。强烈建议用 JDK 17 或 21！

验证环境

打开终端，输入：

java -version
mvn -v

看到版本号就说明 OK。

---

核心概念：用生活例子理解微服务组件

别被术语吓到，我用“快递站”打个比方：

Spring Cloud 组件	快递站类比	作用
Eureka / Nacos	快递柜登记处	服务注册与发现
RestTemplate / OpenFeign	快递员	服务之间互相调用
Spring Cloud Config	总部下发通知	统一配置管理
Gateway	小区门卫	统一路由和过滤

我们这次教程用 Nacos（更现代、支持配置中心），替代老式的 Eureka。

---

实战：手把手搭建两个微服务

我们将创建两个服务：

1. user-service：提供用户信息查询接口
2. order-service：调用 user-service 获取用户数据并返回订单

第一步：启动 Nacos 服务注册中心

1. 去 Nacos GitHub Releases 下载最新版（比如 nacos-server-2.3.0.zip）
2. 解压后进入 bin 目录
3. Windows 执行 startup.cmd -m standalone
   Mac/Linux 执行 sh startup.sh -m standalone
4. 浏览器访问 http://localhost:8848/nacos，账号密码都是 nacos

注意：-m standalone 表示单机模式，适合本地开发。生产环境要用集群模式。

第二步：创建 user-service（提供者）

1. 用 Spring Initializr 创建项目：

   • Project: Maven
   • Language: Java
   • Spring Boot: 3.2+
   • Dependencies: Spring Web, Nacos Discovery

2. pom.xml 会自动加入：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

3. 配置 application.yml：

server:
  port: 8081
spring:
  application:
    name: user-service
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

4. 写一个 Controller：

@RestController
public class UserController {
    @GetMapping("/user/{id}")
    public Map<String, Object> getUser(@PathVariable Long id) {
        Map<String, Object> user = new HashMap<>();
        user.put("id", id);
        user.put("name", "张三");
        user.put("email", "zhangsan@example.com");
        return user;
    }
}

5. 启动 UserApplication.java

✅ 此时刷新 Nacos 控制台，你会看到 user-service 已注册！

---

第三步：创建 order-service（消费者）

同样用 Spring Initializr 创建，依赖一样。

application.yml：

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

关键来了：如何调用 user-service？

方式一：RestTemplate（简单直接）

1. 在启动类加 @LoadBalanced 注解：

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

    @Bean
    @LoadBalanced // 开启负载均衡
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

2. 写 OrderController：

@RestController
public class OrderController {

    @Autowired
    private RestTemplate restTemplate;

    @GetMapping("/order/{userId}")
    public Map<String, Object> createOrder(@PathVariable Long userId) {
        // 通过服务名调用，不是 IP+端口！
        String url = "http://user-service/user/" + userId;
        Map user = restTemplate.getForObject(url, Map.class);

        Map<String, Object> order = new HashMap<>();
        order.put("orderId", "ORD1001");
        order.put("user", user);
        order.put("product", "Spring Cloud 入门教程");
        return order;
    }
}

3. 启动 order-service

4. 访问 http://localhost:8082/order/123，你会看到整合后的订单信息！

我当初的坑：一开始写了 http://localhost:8081/user/...，结果一换端口就崩。记住：永远用服务名调用，Spring Cloud 会自动解析 IP！

---

常见问题解答（新手必看）

Q1：启动时报 “No qualifying bean of type ‘RestTemplate’”

A：忘记在启动类加 @Bean 方法了！必须手动定义 RestTemplate 并加上 @LoadBalanced。

Q2：Nacos 启动失败，提示“Cannot determine embedded database driver class”

A：这是 Spring Boot 自动配置 H2 数据库的问题。Nacos 单机模式默认用内嵌数据库，确保你下载的是 完整版（含 conf 和 target 目录），不要自己建 Spring Boot 项目当注册中心！

Q3：能不能用 Go 或 JavaScript 写微服务？

当然可以！微服务的核心是协议互通，不是语言绑定。

• Go：可以用 Gin + go-micro 搭建高性能服务，注册到 Nacos（有 Go 客户端）
• JavaScript/Node.js：用 NestJS 或 Express，配合 nacos-nodejs-sdk 同样能接入

Spring Cloud 只是 Java 生态的解决方案。实际工作中，很多公司是 Java + Go + Node.js 混合架构，只要大家都连同一个注册中心（如 Nacos、Consul），就能互相调用。

这也是为什么我强调要建立综合技术视野——别把自己局限在一种语言里！

---

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

你已经完成了微服务最核心的部分：服务注册与发现 + 服务调用。接下来可以深入：

1. 服务容错：学习 Sentinel 或 Hystrix，防止一个服务慢导致整个系统雪崩
2. 配置中心：用 Nacos 管理所有服务的配置，不用重启就能改参数
3. API 网关：用 Spring Cloud Gateway 统一入口，做鉴权、限流
4. 链路追踪：集成 SkyWalking，看清请求在多个服务间的流转路径

避坑指南：别一上来就学 Kubernetes！先掌握 Spring Cloud 基础，再过渡到容器化部署会更稳。

---

结语

微服务不是银弹，但它确实是现代后端开发的主流架构。通过今天的实践，你已经跨过了最难的第一步——从“听说”到“亲手跑起来”。

记住：所有复杂的技术，拆解后都是简单的组合。就像搭积木，Spring Cloud 提供了各种标准接口，你只需要按需拼接。

如果你觉得这篇教程有帮助，欢迎转发给还在迷茫的同学。技术分享的意义，就是让后来者少走弯路。

下次见！