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

大家好，我是一名工作5年的后端开发工程师。在带新人的过程中，我发现很多刚接触微服务的同学面对Spring Cloud时一脸懵——概念太多、组件太杂、文档太专业。我当初学的时候也是一头雾水，踩过不少坑。所以今天我决定写一篇真正“从零开始”的实战教程，用最简单的话、最少的代码，带你跑通第一个微服务项目。

为什么这篇教程提到了 Go 和 GitHub？
虽然本文主讲 Java 的 Spring Cloud，但我会在对比中提到 Go（帮助你理解微服务不是 Java 专属），而 GitHub 是我们托管和协作代码的必备平台。技术无边界，工具要会用！

---

一、Spring Cloud 是什么？能干什么？

简单说：Spring Cloud 是一套帮助你快速搭建微服务系统的工具箱。

• 单体应用：所有功能（用户、订单、支付）都写在一个项目里，像一栋大房子。
• 微服务架构：把大房子拆成多个小房间（服务），每个房间独立运行、独立开发、独立部署。

Spring Cloud 提供了这些“装修工具”：

• 服务注册与发现（谁住哪间房？）
• 配置中心（统一管理房间规则）
• 负载均衡（流量怎么分配？）
• 熔断限流（某个房间坏了怎么办？）

💡 新手注意：微服务不是银弹！小项目用单体更省事。只有当团队大、功能复杂、需要快速迭代时，才考虑微服务。

---

二、环境准备（5分钟搞定）

我们需要以下工具，请按顺序安装：

工具	版本建议	作用
JDK	17（推荐）	Java 运行环境
Maven	3.8+	项目依赖管理
IntelliJ IDEA	最新版	开发 IDE（社区版免费）
Git	最新版	代码版本控制
GitHub 账号	-	代码托管平台

步骤详解：

1. 安装 JDK 17

   • 访问 Oracle JDK 或使用 OpenJDK
   • 安装后终端执行 java -version，看到 17.x 即成功

2. 安装 Maven

   • 下载解压后配置环境变量 MAVEN_HOME
   • 终端执行 mvn -v 验证

3. 创建 GitHub 仓库

   • 登录 GitHub，点击 + → New repository
   • 命名为 spring-cloud-demo，勾选 Initialize with a README
   • 克隆到本地：git clone https://github.com/你的用户名/spring-cloud-demo.git

✅ 避坑提示：不要用 JDK 8！Spring Boot 3.x 起已要求 JDK 17+。

---

三、核心概念（用生活例子讲清楚）

1. 服务注册与发现（Eureka）

想象一个酒店前台：

• 每个服务（房间）启动时，先去前台（Eureka Server）登记：“我是用户服务，住在301”
• 其他服务要找用户服务，就问前台：“用户服务在哪？” → 前台回答“301”

2. 服务调用（OpenFeign）

就像打电话订餐：

• 订单服务想调用用户服务，不用知道 IP 地址
• 只需写 @FeignClient(name = "user-service")，框架自动找到并调用

3. 配置中心（可选，本篇暂不涉及）

相当于酒店的“总控室”，统一修改所有房间的空调温度，无需逐个敲门。

🌟 对比 Go 微服务：
Go 生态有 Go Micro 或 Kratos，同样需要服务注册（如 Consul）、RPC 调用。微服务思想是通用的，只是语言不同。

---

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

我们将创建两个服务：

• user-service：提供用户信息
• order-service：调用 user-service 获取用户数据

第一步：创建父工程（Maven 聚合）

在 spring-cloud-demo 目录下，创建 pom.xml：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>spring-cloud-demo</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.0</version>
        <relativePath/>
    </parent>

    <properties>
        <java.version>17</java.version>
        <spring-cloud.version>2023.0.0</spring-cloud.version>
    </properties>

    <modules>
        <module>eureka-server</module>
        <module>user-service</module>
        <module>order-service</module>
    </modules>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

第二步：搭建 Eureka 注册中心

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

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

3. 主启动类 EurekaServerApplication.java：

@SpringBootApplication
@EnableEurekaServer // 开启注册中心
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       # 不拉取注册表
  server:
    wait-time-in-ms-when-sync-empty: 0

🔧 启动后访问 http://localhost:8761，看到 Eureka 仪表盘即成功！

第三步：编写 user-service

1. 创建模块 user-service
2. pom.xml：

<dependencies>
    <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>
</dependencies>

3. 主启动类：

@SpringBootApplication
@EnableDiscoveryClient // 开启服务发现
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. 控制器 UserController.java：

@RestController
public class UserController {

    @GetMapping("/user/{id}")
    public Map<String, Object> getUser(@PathVariable Long id) {
        return Map.of("id", id, "name", "张三", "email", "zhangsan@example.com");
    }
}

✅ 启动后刷新 Eureka 页面，应看到 USER-SERVICE 出现在 Instances 列表中。

第四步：编写 order-service（调用 user-service）

1. 创建模块 order-service
2. pom.xml（比 user-service 多一个 Feign 依赖）：

<dependencies>
    <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>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

3. 主启动类（关键：加 @EnableFeignClients）：

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients // 开启 Feign 调用
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

4. application.yml：

server:
  port: 8082

spring:
  application:
    name: order-service

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

5. 定义 Feign 接口 UserClient.java：

@FeignClient(name = "user-service") // 对应 user-service 的 spring.application.name
public interface UserClient {

    @GetMapping("/user/{id}")
    Map<String, Object> getUser(@PathVariable("id") Long id);
}

6. 控制器 OrderController.java：

@RestController
public class OrderController {

    @Autowired
    private UserClient userClient;

    @GetMapping("/order/{userId}")
    public String createOrder(@PathVariable Long userId) {
        Map<String, Object> user = userClient.getUser(userId);
        return "为用户 " + user.get("name") + " 创建订单成功！";
    }
}

第五步：测试整个流程

1. 启动顺序：eureka-server → user-service → order-service
2. 浏览器访问：http://localhost:8082/order/123
3. 你将看到：为用户 张三 创建订单成功！

🎉 恭喜！你已经完成了第一个 Spring Cloud 微服务调用！

---

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

问题现象	可能原因	解决方法
Eureka 页面看不到服务	服务未正确注册	检查 application.yml 中 eureka.client.service-url.defaultZone 是否指向 8761
Feign 调用报 404	URL 路径错误	确保 @FeignClient 中的 @GetMapping 路径与 user-service 控制器一致
启动报错 No qualifying bean of type 'UserClient'	忘记加 @EnableFeignClients	在主启动类加上该注解
服务启动很慢	系统 hosts 配置问题	在 /etc/hosts (Mac/Linux) 或 C:\Windows\System32\drivers\etc\hosts 中添加 127.0.0.1 localhost

💡 我当初学的时候，经常因为端口冲突（比如 8080 被占用）导致启动失败。建议每个服务用不同端口，并写在 README 里。

---

六、下一步学习建议

你现在掌握了微服务最基础的“服务注册 + 远程调用”。接下来可以：

1. 加入配置中心：学习 Spring Cloud Config 或 Nacos，统一管理配置
2. 增加容错机制：用 Resilience4j 实现熔断、降级
3. API 网关：用 Spring Cloud Gateway 统一入口
4. 链路追踪：集成 Zipkin 查看请求全链路
5. 容器化部署：用 Docker 打包服务，用 Kubernetes 编排

🚀 GitHub 实践建议：
把你的代码推送到 GitHub 仓库，写好 README（包含启动步骤、架构图文字描述）。这是你技术成长的重要记录！

---

结语

微服务听起来高大上，但拆解开来就是“服务怎么找到彼此”、“怎么安全调用”这些具体问题。Spring Cloud 帮你封装了复杂性，你只需要关注业务逻辑。

记住：不要为了微服务而微服务。先写好单体，等业务复杂到需要拆分时，再用微服务解耦。

如果你跟着这篇教程跑通了代码，恭喜你已经超过了 50% 的初学者！接下来，多动手、多调试、多看官方文档，你会越来越熟练。

最后提醒：技术日新月异，但解决问题的能力才是核心。无论是 Java 的 Spring Cloud，还是 Go 的微服务框架，背后的分布式思想是相通的。

Happy Coding！