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

掘金夜猫子

2025-06-29 21:54

阅读 379

一、开篇：什么是Spring Cloud？它能做什么？

你可能听说过“微服务”这个词。那微服务到底是什么呢？

想象一下，你正在做一个大项目，比如一个电商平台。这个平台包括用户注册登录、商品展示、购物车、支付等多个功能模块。如果你把这些功能都写在一个程序里，整个系统会非常庞大、复杂、难维护。

微服务（Microservices）就是一种解决这个问题的方法。

它的核心思想是：把一个大型应用拆分成多个小型、独立的服务，每个服务只负责一个功能。这些小服务可以各自开发、部署、运行，彼此之间通过网络通信协作完成整体业务。

而 Spring Cloud 就是一个用来帮助你快速构建和管理这些微服务的工具集合。它基于 Spring Boot 构建，提供了服务注册发现、负载均衡、配置中心、断路器、网关等重要功能，让你轻松搭建起复杂的分布式系统。

🎯 一句话总结：

Spring Cloud = 微服务架构的“瑞士军刀”，帮你简化分布式系统的开发和管理。

二、环境准备：开发环境搭建（Java + Maven + IntelliJ IDEA）

我们先来准备好开发环境，这样你可以边学边敲代码。

1. 安装JDK（Java开发工具包）

建议使用 JDK 1.8 或以上版本。
✅ 下载地址：Oracle JDK 或 OpenJDK

安装后，在命令行输入：

java -version

如果看到类似如下输出就表示安装成功：

openjdk version "1.8.0_292"

2. 安装Maven（项目依赖管理工具）

✅ 下载地址：https://maven.apache.org/download.cgi

解压后配置环境变量 MAVEN_HOME 并将 bin 加入 PATH。在命令行运行：

mvn -v

出现版本信息说明安装成功。

3. 安装IDE（推荐IntelliJ IDEA社区版）

✅ 下载地址：https://www.jetbrains.com/idea/download/

安装完成后打开 IDE，我们将会用它来创建和运行项目。

三、Spring Cloud 核心概念通俗讲解

1. 微服务（Microservice）

就像一个公司分为财务部、技术部、销售部一样。每个微服务是一个功能独立的小程序，它们一起协作完成任务。

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

微服务太多怎么办？谁在运行？谁提供商品服务？谁处理订单？

于是我们需要一个“通讯录”——这就是 服务注册中心（Eureka Server）。所有服务启动时都会告诉它“我上线了”。其他服务需要它时就去查这个通讯录。

3. 负载均衡（Load Balancing）

当有多个相同服务实例（比如两个商品服务），如何选择其中一个调用？

我们可以随机选一个，或者轮询选。这叫负载均衡，Spring Cloud 借助 Ribbon 或 LoadBalancer 来实现这一功能。

4. API 网关（API Gateway）

用户不会直接访问每个微服务。他们统一访问一个入口（网关），由它决定将请求转发给哪个服务。Spring Cloud 中可以用 Gateway 或 Zuul 实现。

5. 配置中心（Config Server）

以前修改配置要改配置文件再重启服务。现在可以通过一个统一配置中心（如 Config Server），集中管理所有服务的配置，并实现动态刷新。

四、实战项目：从零搭建第一个Spring Cloud微服务系统

我们将搭建一个简单的电商系统，包含：

注册中心 Eureka Server
商品服务 Product Service
订单服务 Order Service
网关服务 Gateway（可选）

💡 建议每一步都动手跟着敲一遍代码！

第1步：创建父工程（聚合项目）

新建一个 Maven 工程，作为项目的父工程，pom.xml 内容如下：

<!-- pom.xml -->
<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-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>eureka-server</module>
        <module>product-service</module>
        <module>order-service</module>
    </modules>
    
    <properties>
        <spring.boot.version>2.7.5</spring.boot.version>
        <spring.cloud.version>2021.0.4</spring.cloud.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <!-- Spring Boot 版本控制 -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- Spring Cloud 版本控制 -->
            <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>

然后创建三个 Module：eureka-server, product-service, order-service

第2步：搭建服务注册中心 Eureka Server

右键父工程 → New → Module → Maven 模块，取名 eureka-server

添加依赖（`pom.xml`）：

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

启动类加上注解：

package com.example.eurekaserver;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

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

修改 application.yml：

server:
  port: 8761

eureka:
  instance:
    hostname: localhost
  client:
    registerWithEureka: false  # 不注册自己
    fetchRegistry: false       # 不拉取服务列表
    serviceUrl:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

启动这个服务，访问 http://localhost:8761 即可看到 Eureka 的界面。

第3步：创建商品服务 Product Service

创建模块 product-service

添加依赖（`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>

编写启动类并启用客户端：

package com.example.productservice;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

@SpringBootApplication
@EnableEurekaClient  // 注册为Eureka客户端
public class ProductServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProductServiceApplication.class, args);
    }
}

修改 application.yml：

server:
  port: 8081

spring:
  application:
    name: product-service

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

写个简单接口测试：

package com.example.productservice.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ProductController {

    @GetMapping("/product")
    public String getProduct() {
        return "This is Product Service";
    }
}

启动后，你应该能在 Eureka 控制台看到注册上来的 product-service。

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

创建模块 order-service，步骤与 product-service 类似：

`pom.xml`添加依赖：

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

启动类：

package com.example.orderservice;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients  // 启用Feign调用远程服务
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

`application.yml`：

server:
  port: 8082

spring:
  application:
    name: order-service

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

创建 Feign Client 调用商品服务：

package com.example.orderservice.feign;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient(name = "product-service")
public interface ProductClient {

    @GetMapping("/product")
    String getProduct();
}

创建订单控制器：

package com.example.orderservice.controller;

import com.example.orderservice.feign.ProductClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class OrderController {

    @Autowired
    private ProductClient productClient;

    @GetMapping("/order")
    public String getOrder() {
        String product = productClient.getProduct();
        return "Order Service: " + product;
    }
}

启动后访问：

http://localhost:8082/order
你将看到返回内容包含来自 product-service 的结果。

🎉 至此，你的第一个 Spring Cloud 微服务系统已经跑起来了！

五、常见问题解答（FAQ）

数据库设计模型-1

Q1：Eureka 注册中心看不到服务？

✅ 检查是否加了 @EnableEurekaClient 注解
✅ 检查 application.yml 中的 name 和 defaultZone 地址
✅ 查看日志是否有报错信息，如连接超时、端口被占用

Q2：Feign 调用时报错，找不到服务？

✅ 确保服务已注册进 Eureka
✅ 确保 Feign 接口中使用的 name 和服务中的 spring.application.name 一致
✅ 添加 spring-cloud-starter-loadbalancer 依赖（Spring Boot 2.4+）

Q3：为什么每次改配置都要重启？

✅ 可以引入 Spring Cloud Config 统一管理配置，并结合 Spring Cloud Bus 实现动态刷新

Q4：多个服务实例是怎么选择的？

✅ 默认是轮询算法（Round Robin）。可通过自定义 IRule 改变策略（如随机、权重等）

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

恭喜你迈出了第一步！接下来你可以深入以下方向：

1. 学习服务熔断与限流（Hystrix / Resilience4j）

当某个服务故障时，防止整个系统崩溃，使用断路器机制。

2. 使用配置中心（Config Server）

将所有服务的配置统一管理，并支持动态更新。

3. 引入网关（Spring Cloud Gateway）

统一处理请求，路由、鉴权、限流都在这里做。

4. 日志聚合与链路追踪（Sleuth + Zipkin）

定位分布式系统中某次请求的具体流程和耗时情况。

5. 部署与运维（Docker + Kubernetes）

学会如何打包、部署微服务到生产环境。

📚 推荐资料：

《Spring Cloud官方文档》 https://cloud.spring.io/spring-cloud-static/
GitHub 示例项目合集 https://github.com/spring-cloud-samples
B站/慕课网相关课程：搜索 “Spring Cloud 入门实战”

🎯 结语： 学习 Spring Cloud 很像学骑自行车，刚开始你会手忙脚乱，但一旦掌握之后，就能自由驰骋。坚持实践、多写代码，你也能成为微服务高手！

如果你觉得这篇教程对你有帮助，请收藏分享；也欢迎留言提出问题或想了解的下期主题！

Happy coding 🚀

标签:GitHub项目运营

最热最新

暂无评论

为你推荐

暂无相关推荐

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

一、开篇：什么是Spring Cloud？它能做什么？

二、环境准备：开发环境搭建（Java + Maven + IntelliJ IDEA）

1. 安装JDK（Java开发工具包）

2. 安装Maven（项目依赖管理工具）

3. 安装IDE（推荐IntelliJ IDEA社区版）

三、Spring Cloud 核心概念通俗讲解

1. 微服务（Microservice）

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

3. 负载均衡（Load Balancing）

4. API 网关（API Gateway）

5. 配置中心（Config Server）

四、实战项目：从零搭建第一个Spring Cloud微服务系统

第1步：创建父工程（聚合项目）

第2步：搭建服务注册中心 Eureka Server

添加依赖（pom.xml）：

启动类加上注解：

修改 application.yml：

第3步：创建商品服务 Product Service

添加依赖（pom.xml）：

编写启动类并启用客户端：

修改 application.yml：

写个简单接口测试：

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

pom.xml添加依赖：

启动类：

application.yml：

创建 Feign Client 调用商品服务：

创建订单控制器：

五、常见问题解答（FAQ）

Q1：Eureka 注册中心看不到服务？

Q2：Feign 调用时报错，找不到服务？

Q3：为什么每次改配置都要重启？

Q4：多个服务实例是怎么选择的？

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

1. 学习服务熔断与限流（Hystrix / Resilience4j）

2. 使用配置中心（Config Server）

3. 引入网关（Spring Cloud Gateway）

4. 日志聚合与链路追踪（Sleuth + Zipkin）

5. 部署与运维（Docker + Kubernetes）

评论 0

为你推荐

相关推荐

精选内容

添加依赖（`pom.xml`）：

添加依赖（`pom.xml`）：

`pom.xml`添加依赖：

`application.yml`：