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

浏览器兼容师

2025-06-27 23:35

阅读 237

开篇：什么是Spring Cloud，能用来做什么？

你可能听过“微服务”这个词。它是一种现代的软件开发架构模式，简单来说就是把一个大系统拆分成多个小的服务来协作工作，就像用积木搭房子一样。

那Spring Cloud是什么？它是基于Spring Boot的一套微服务解决方案，帮助我们更容易地构建、管理和协作这些小服务。比如服务注册与发现、配置管理、负载均衡、断路器等等功能，Spring Cloud都提供了开箱即用的组件支持。

你可以把它理解为一套工具包，专门帮你解决微服务开发中的常见问题。而今天的这篇教程，将带你一步步从零开始了解并使用Spring Cloud。

环境准备：搭建你的Spring Cloud学习环境

在动手写代码之前，我们需要准备好基础开发环境。

1. 安装Java JDK（推荐版本11或17）

前往官网：https://www.oracle.com/java/technologies/javase-downloads.html
安装好之后，在终端输入以下命令检查是否安装成功：

java -version

你应看到类似如下输出：

openjdk version "11.0.20" 2023-06-20
OpenJDK Runtime Environment Temurin-11.0.20+8 (build 11.0.20+8)

2. 安装Maven（推荐3.6以上）

下载地址：https://maven.apache.org/download.cgi
配置环境变量后，输入命令检查：

mvn -v

你会看到类似于这样的输出：

Apache Maven 3.8.4 (9b656c72d54e5bacbed989b64718c159fe39b537)

3. 下载IDE（推荐IntelliJ IDEA 社区版）

官网下载：https://www.jetbrains.com/idea/download/

安装完成后打开，创建一个新的Spring Boot项目会自动集成Spring Cloud依赖。

4. 初始化Spring Boot项目结构

访问 https://start.spring.io，按下面信息填写：

Project: Maven
Language: Java
Spring Boot Version: 推荐使用最新稳定版本（如3.1.x）
Dependencies: Spring Web, Spring Cloud Discovery Client

点击“Generate”即可生成一个Spring Boot + Spring Cloud的基础工程，解压到本地就可以导入IDE了！

核心概念：轻松理解Spring Cloud的核心术语

下面几个是Spring Cloud中最常用的概念，我将用最简单的语言解释清楚它们，并附上代码说明。

1. 微服务（Microservices）

每个服务独立运行、独立部署，就像一个个小螺丝钉，但合起来就能组成强大的系统。

✅ 示例：假设我们要做一个电商平台，用户服务、订单服务、支付服务都可以拆成微服务分别部署。

2. 服务注册与发现（Service Registry & Discovery）

想象你在公司里要找同事帮忙，得先知道他在哪个部门吧？

同样地，微服务之间也要知道彼此存在。Eureka Server就是我们的“通讯录”，服务启动时自动注册自己进去，其他服务想要通信就查这个通讯录。

搭建Eureka Server

添加依赖（pom.xml）：

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

启动类加注解启用Eureka服务：

@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:
    register-with-eureka: false
    fetch-registry: false
    service-url:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

运行主类，访问http://localhost:8761，你就有了自己的服务注册中心！

3. 客户端服务如何接入注册中心？

以用户服务为例，让它自动注册到Eureka：

添加依赖：

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

配置文件加入注册信息：

spring:
  application:
    name: user-service

server:
  port: 8081

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

加注解启用服务注册客户端：

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

运行后刷新Eureka页面，应该能看到user-service上线了！

4. 负载均衡（Load Balancer）

多个相同的服务同时运行怎么办？比如两个订单服务实例跑在不同端口，这时候需要一个“调度员”随机分配请求给不同的服务。这就是Ribbon或者更高级的Spring Cloud LoadBalancer的工作。

只需要引入依赖即可启用默认负载均衡器：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>

后续我们在调用远程服务的时候可以直接通过服务名调用（例如 order-service），不需要写死IP和端口。

5. OpenFeign：远程服务调用神器

Feign 是一种声明式 REST 客户端，简化服务之间的远程调用。

使用步骤：

添加依赖：

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

在启动类上加上@EnableFeignClients：

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

定义远程接口：

@FeignClient(name = "user-service")
public interface UserClient {
    @GetMapping("/users/{id}")
    User getUserById(@PathVariable Long id);
}

这样你就可以像调用本地方法一样调用别的服务啦！

实战项目：动手打造一个简易微服务应用

目标：构建一个用户系统 + 订单系统的微服务架构

我们将实现以下目标：

用户服务提供查询用户信息接口；
订单服务通过Feign调用用户服务，获取下单用户的详细信息；
整个系统注册到Eureka中。

第一步：创建Eureka注册中心（前面已经讲过）

略（详见“服务注册与发现”部分）

第二步：创建用户服务User Service

创建项目结构

名称为user-service
引入Eureka Client + Web模块

编写用户Controller

@RestController
@RequestMapping("/users")
public class UserController {
    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return new User(id, "张三");
    }
}

定义User类：

public class User {
    private Long id;
    private String name;

    // 构造函数、Getter/Setter省略
}

添加配置application.yml：

spring:
  application:
    name: user-service

server:
  port: 8081

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

运行后访问 http://localhost:8081/users/1 可看到返回数据。

第三步：创建订单服务Order Service

新建项目`order-service`

引入依赖：Eureka Client、Web、Feign

编写Feign Client接口

@FeignClient(name = "user-service")
public interface UserClient {

    @GetMapping("/users/{id}")
    User getUserById(@PathVariable Long id);

}

创建订单Controller调用用户服务

@RestController
@RequestMapping("/orders")
public class OrderController {

    @Autowired
    private UserClient userClient;

    @GetMapping("/info/{userId}")
    public String getOrderUserInfo(@PathVariable Long userId) {
        User user = userClient.getUserById(userId);
        return "订单由用户 " + user.getName() + " 创建";
    }
}

配置文件：

spring:
  application:
    name: order-service

server:
  port: 8082

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

启动服务，访问 http://localhost:8082/orders/info/1

你将会看到结果："订单由用户张三创建"

✅ 到这里为止，我们完成了两个服务之间的通信！

常见问题解答（FAQ）

下面是很多初学者容易遇到的问题，一一为你解答：

Q1: 启动失败，提示“Connection refused to host”

通常是Eureka还没启动就被其他服务尝试连接。请确保Eureka先启动后再运行其他微服务。

Q2: 访问不到Feign远程服务

检查Feign接口上的name是否和注册中心中的服务名一致（大小写敏感），以及是否开启@EnableFeignClients。

Q3: 报错“No instances available for service: user-service”

可能是服务没有正确注册进Eureka，可以去Eureka后台查看是否显示该服务在线。

Q4: 多个服务监听同一个端口怎么办？

可以在配置文件中手动修改server.port避免冲突，例如设置为8081、8082等。

Q5: 如何查看服务是否正常注册？

访问 http://localhost:8761 查看Eureka界面，服务状态应该是UP且有心跳。

学习建议：接下来你可以学什么？

现在你已经掌握了Spring Cloud的基本使用方式，可以继续深入学习以下几个方向：

🔹 分布式配置中心 —— Config Server

统一管理多个服务的配置文件，无需反复修改每个服务的yml。

🔹 API网关 —— Gateway / Zuul

统一路由入口，统一权限控制、限流降级等功能。

🔹 断路器 Hystrix（已不维护） → Resilience4j

提高系统的容错能力，防止服务雪崩。

🔹 消息队列集成（如RabbitMQ/Kafka）

实现服务之间的异步通信、事件驱动架构。

🔹 安全认证 —— Spring Security / OAuth2 + JWT

保护API安全，防止未授权访问。

结语：你已经迈出了关键一步

微服务架构示意图-1

恭喜你！现在你已经不再是一个只懂Hello World的程序员了。你掌握了一个真正可用的微服务雏形，也对Spring Cloud的核心机制有了基本的理解。

记住一句话：编程不是靠背知识点，而是靠动手实践。你可以试着再加一个商品服务，让订单服务调用它，甚至用Gateway把这些服务聚合起来。

坚持下去，每一个高手都是从新手成长而来的，而你已经在路上了！

📝 本文约3867字，适合收藏、随时复习使用

标签:Python开发心得

最热最新

暂无评论

为你推荐

暂无相关推荐