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

大家好，我是团队的培训负责人，过去五年带过上百名应届生。每当看到新人面对“微服务”、“Spring Cloud”这些词一脸茫然时，我就想起自己当初学的时候——文档晦涩、概念抽象、环境配置就卡住半天。所以今天，我想用最朴素的语言、最真实的项目案例，带完全零基础的你，一步步走进Spring Cloud的世界。

本文目标：用一个极简但完整的例子，让你亲手跑起两个能互相通信的微服务，理解“注册中心”“服务调用”到底是什么。

---

一、Spring Cloud 是什么？为什么需要它？

简单说：Spring Cloud 是一套帮助 Java 开发者快速构建微服务系统的工具集。

• 如果你写过单体应用（所有功能在一个项目里），当项目变大后，部署、维护、扩展都会变得困难。
• 微服务就是把大系统拆成多个小服务（比如用户服务、订单服务、商品服务），每个服务独立开发、部署、运行。
• 但服务多了，问题也来了：服务之间怎么发现彼此？怎么调用？出错了怎么办？
• Spring Cloud 就是来解决这些问题的，它封装了 Netflix、Alibaba 等开源组件，让我们用 Java 写微服务更轻松。

我当初学的时候，以为微服务很高级，其实核心思想就是“分而治之”。别怕！

---

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

我们需要以下工具（都是免费的）：

工具	版本建议	用途
JDK	17 或 21	Java 运行环境
Maven	3.8+	项目依赖管理
IntelliJ IDEA	Community 版即可	代码编辑器
Git	最新版	版本控制（可选）

步骤 1：安装 JDK

去 Oracle 官网 或 OpenJDK 下载并安装。安装后在终端输入：

java -version

能看到版本号就算成功。

步骤 2：创建 Maven 项目

打开 IDEA，选择 New Project → Maven → 不勾选模板 → Next
填写 GroupId（如 com.example），ArtifactId（如 spring-cloud-demo），Finish。

---

三、核心概念：用生活例子理解微服务

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

1. 服务注册与发现（Service Registry）

• 类比：就像公司前台。新员工（服务）入职要先到前台登记（注册），别人想找他，就问前台他在哪（发现）。
• 技术实现：我们用 Eureka（Spring Cloud 内置组件）做注册中心。

2. 服务调用（Service Call）

• 类比：你打电话给同事：“帮我查下用户信息”，同事处理完告诉你结果。
• 技术实现：用 OpenFeign，像写本地方法一样调用远程服务。

3. 微服务 = 独立进程 + HTTP 接口

每个服务都是一个独立的 Java 程序，通过 HTTP（比如 http://localhost:8081/user/1）提供数据。

新手常问：为什么不用直接 new 对象？
答：因为服务可能部署在不同服务器上，只能通过网络通信！

---

四、实战项目：构建两个微服务

我们将创建：

• user-service：提供用户信息
• order-service：查询订单时，需要调用 user-service 获取用户姓名

第一步：创建 Eureka 注册中心

1. 新建模块：eureka-server
2. pom.xml 添加依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2023.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3. 主启动类加注解：

@SpringBootApplication
@EnableEurekaServer // 启用 Eureka 服务端
public class EurekaServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaServerApplication.class, args);
    }
}

4. application.yml 配置：

server:
  port: 8761

eureka:
  client:
    register-with-eureka: false  # 自己是注册中心，不注册自己
    fetch-registry: false       # 不需要拉取服务列表

5. 启动项目，浏览器访问 http://localhost:8761，看到 Eureka 首页即成功！

---

第二步：创建 user-service

1. 新建模块：user-service
2. pom.xml 添加：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

3. 主启动类：

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

4. application.yml：

server:
  port: 8081

spring:
  application:
    name: user-service  # 服务名，其他服务靠这个名字找你

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

5. 创建 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", "张三");
        return user;
    }
}

6. 启动后，刷新 Eureka 页面，你会看到 USER-SERVICE 出现在 Instances 列表中！

---

第三步：创建 order-service 并调用 user-service

1. 新建模块：order-service
2. pom.xml 添加：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

3. 主启动类启用 Feign：

@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients // 启用 Feign 客户端
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

4. application.yml（端口 8082，服务名 order-service）

5. 定义 Feign 接口（关键！）：

@FeignClient(name = "user-service") // 指定调用的服务名
public interface UserClient {
    @GetMapping("/user/{id}")
    Map<String, Object> getUser(@PathVariable("id") Long id);
}

6. 在 OrderController 中使用：

@RestController
public class OrderController {

    @Autowired
    private UserClient userClient;

    @GetMapping("/order/{userId}")
    public String getOrder(@PathVariable Long userId) {
        Map<String, Object> user = userClient.getUser(userId);
        String userName = (String) user.get("name");
        return "订单属于用户：" + userName;
    }
}

7. 启动 order-service，访问 http://localhost:8082/order/1，你会看到：
   订单属于用户：张三

成功了！这就是微服务调用的核心流程。

---

五、新手常见问题 & 解决方案

问题	原因	解决办法
Eureka 页面看不到服务	服务未正确注册	检查 eureka.client.service-url.defaultZone 是否指向 8761
Feign 调用报错 404	URL 路径不对	确保 @GetMapping 路径和被调用方一致
启动报错 ClassNotFoundException	Spring Boot 和 Spring Cloud 版本不兼容	使用官方推荐的版本组合（如 Boot 3.2 + Cloud 2023.0.0）
服务调用超时	默认超时时间短	在 FeignClient 上加 @FeignClient(name = "...", configuration = FeignConfig.class) 自定义超时

避坑指南：我带过的应届生，90% 的问题都出在 YAML 缩进或端口冲突上！务必检查缩进是否用空格（不是 Tab），端口是否被占用。

---

六、学习建议：下一步怎么走？

1. 巩固基础：
   先确保你能独立写出上面三个模块。不要复制粘贴，手敲一遍！

2. 推荐书籍：

   • 《Spring Microservices in Action》（英文，但代码清晰）
   • 《Spring Cloud 微服务实战》（翟永超著，中文入门首选）

3. 进阶方向：

   • 加入 配置中心（Spring Cloud Config）统一管理配置
   • 引入 熔断器（Resilience4j）防止雪崩
   • 用 Gateway 做 API 网关
   • 学习 Docker 容器化部署

4. 开发心得：
   微服务不是银弹！小项目用单体更高效。只有当团队大、业务复杂、需要独立迭代时，才考虑微服务。先学会拆，更要学会合。

---

结语

这篇文章是我带新人时最常讲的第一课。如果你能跑通这个例子，恭喜你，已经跨过了微服务最大的门槛——从“听说”到“亲手做过”。

记住：所有复杂的系统，都是由简单的模块组成的。保持动手，保持好奇，你一定能成为优秀的后端工程师。

下次教程，我会带大家用 Nacos 替代 Eureka，并加入配置中心。欢迎留言告诉我你想学什么！

—— 一位带过上百应届生的后端讲师