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

协程在摸鱼

2025-06-28 20:56

阅读 358

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

对于刚开始学习编程的你来说，Spring Cloud 可能听起来有点“高大上”，但其实它的目标很单纯：帮助开发者更容易地构建分布式系统（也叫微服务架构）。

什么是微服务？

你可以把传统的Web应用想象成一间“全功能的房子”——厨房、客厅、卧室都在一起。如果这间房出了问题，整栋房子可能都无法使用。

而微服务就像是把这间房子拆成了多个独立的小屋，每个小屋只做一件事，比如一个专门做菜（处理订单），另一个专门洗澡（用户管理）。它们之间通过沟通（调用接口）来协作完成整体任务。

这样做的好处是：

某个小屋坏了不影响其他部分
可以根据需要扩建某个小屋，而不必重建整个房子
团队可以分头开发不同的“小屋”

Spring Cloud 能帮你做什么？

Spring Cloud 是一套工具集，帮助你轻松实现和管理这些“小屋”之间的沟通、监控、负载均衡等功能。它基于 Spring Boot，如果你已经用过 Spring Boot，会很容易上手。

环境准备：搭建你的第一个微服务开发环境

要开始写代码，首先我们要准备好开发工具和运行环境。

1. 安装JDK（Java Development Kit）

Spring Cloud 是基于 Java 的框架，所以你需要安装 JDK。

推荐版本：JDK 8 或 JDK 11（目前最稳定）
下载地址：https://www.oracle.com/java/technologies/javase-downloads.html
验证安装是否成功：在命令行中输入 java -version 和 javac -version

2. 安装IDE（推荐IntelliJ IDEA）

虽然你可以用任何文本编辑器编写Java代码，但使用专业的IDE（集成开发环境）会让你效率更高。

IntelliJ IDEA 社区版免费下载：https://www.jetbrains.com/idea/download/
安装完成后启动，选择 “Create New Project”

3. 安装Maven

Maven 是用来管理项目依赖的工具，类似“自动帮你下载插件”的工具。

官网下载：https://maven.apache.org/download.cgi
设置环境变量后，在命令行输入 mvn -v 检查是否安装成功

💡 小贴士：IntelliJ IDEA 自带了 Maven，不需要单独安装。如果你刚接触，建议先直接使用 IDE 自带的功能。

核心概念：通俗理解Spring Cloud的关键组件

微服务架构示意图-1

下面是一些 Spring Cloud 中常用的核心组件，我用类比的方式带你理解它们的作用。

1. Eureka（注册中心）

就像小区里的物业管理公司一样，Eureka 是微服务之间的“电话簿”。

微服务启动后都要去 Eureka 注册一下：“我是订单服务，住在192.168.0.1:8080”
其他服务想访问订单服务时，就去 Eureka 问地址

2. Ribbon（负载均衡器）

Ribbon 类似于小区门口的保安大叔，他在多个人想去同一个小屋时，帮你安排谁先进去。

比如有3个订单服务副本，当你请求“下单”功能时，Ribbon 帮你决定走哪一个副本

3. Feign（远程调用）

Feign 相当于“打电话给邻居办事”的工具。

比如：用户服务想调用订单服务的一个方法，就可以通过 Feign 来远程调用，像调用本地方法一样方便

4. Zuul（API网关）

Zuul 就像是小区大门，所有外部访问都必须经过这里。

它可以做统一鉴权、日志记录、路由到不同服务等功能

实战项目：跟着一步步构建两个简单的微服务

现在我们动手实战！我们将创建两个微服务：

服务A：订单服务
服务B：用户服务（调用订单服务）

还会加上 Eureka 注册中心。

第一步：创建父工程（可选）

为了更好的管理多个微服务模块，我们可以创建一个 Maven 父工程。

<!-- pom.xml -->
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>microservice-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
</project>

第二步：创建 Eureka 服务器

1. 新建子模块：eureka-server

右键父工程 -> New Module -> Maven Module，名字设为 eureka-server

2. 添加 Spring Cloud 依赖

<!-- 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>Hoxton.SR12</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3. 启动类

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

4. 配置 application.yml

server:
  port: 8761

eureka:
  instance:
    hostname: localhost
  client:
    registerWithEureka: false
    fetchRegistry: false
    serviceUrl:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

5. 运行并查看

启动后访问 http://localhost:8761，看到 Eureka 的界面说明成功！

第三步：创建订单服务（order-service）

1. 新建模块 order-service

同样的方式新建一个模块，命名为 order-service

2. 添加依赖

<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
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

4. 配置 application.yml

server:
  port: 8080
spring:
  application:
    name: order-service
eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

5. 创建一个测试控制器

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

    @GetMapping("/{id}")
    public String getOrder(@PathVariable Long id) {
        return "Order ID: " + id;
    }
}

启动后刷新 Eureka 页面，你会看到 order-service 出现。

第四步：创建用户服务（user-service）

步骤几乎与 order-service 相同，只不过这次我们要让它调用订单服务。

1. 新建模块 user-service

2. 添加 Feign 依赖

除了 eureka-client，还要加 feign

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

3. 启动类添加注解启用 Feign

@SpringBootApplication
@EnableFeignClients
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:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

5. 创建 Feign 客户端接口

@FeignClient(name = "order-service")
public interface OrderServiceClient {
    @GetMapping("/orders/{id}")
    String getOrderById(@PathVariable("id") Long id);
}

6. 创建UserController

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private OrderServiceClient orderServiceClient;

    @GetMapping("/order/{id}")
    public String getUserOrder(@PathVariable Long id) {
        return orderServiceClient.getOrderById(id);
    }
}

测试访问：

启动顺序：先启动 Eureka → 再启动 order-service → 最后启动 user-service
访问：http://localhost:8081/users/order/1001

你应该能看到返回内容：Order ID: 1001

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

常见问题：新手容易遇到的坑及解决办法

❓ 问题1：Eureka页面不显示注册的服务？

✅ 解决方案：
- 确保服务配置中的 spring.application.name 正确
- 检查 eureka.client.serviceUrl.defaultZone 地址是否正确
- 查看控制台是否有报错信息
- 给服务配置一个合适的超时时间（默认可能等几分钟才注册）

❓ 问题2：Feign调用失败或超时？

✅ 解决方案：
- 确保服务名拼写一致（区分大小写）
- 使用 @LoadBalanced 注解（如果你自己写了 RestTemplate）
- 检查网络连接是否正常（尤其是 Docker 容器部署时）
- 添加 Ribbon 负载均衡配置

❓ 问题3：多个服务无法同时运行？

✅ 解决方案：
- 检查各个服务使用的端口是否冲突（例如都是8080）
- 修改其中一个服务的 server.port 配置
- 在 IntelliJ 中使用 Run Dashboard 同时运行多个服务

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

微服务架构示意图-2

恭喜你完成本教程，接下来你可以沿着这些方向继续深入学习：

🚀 方向1：更强大的服务治理

Spring Cloud Gateway（新一代API网关）
Hystrix（熔断机制，防止单点故障导致雪崩）
Config Server（统一配置管理）
Sleuth + Zipkin（分布式链路追踪）

📦 方向2：部署与运维

Docker + Docker Compose 编排多个微服务
Kubernetes 部署微服务集群
Jenkins 搭建持续集成流水线

🔐 方向3：安全与权限

Spring Security 实现认证授权
OAuth2、JWT 实现单点登录和令牌校验
Zuul + Token 验证拦截非法请求

总结

这篇文章作为一本面向完全零基础读者的《Spring Cloud从零开始》教程，从基本概念讲起，带着你一步步搭建起了两个能够互相通信的简单微服务，并解决了常见问题。

记住一句话：“复杂的东西，只要一步步来，也能学会。”

只要多动手实践，保持好奇心，你完全可以成为驾驭Spring Cloud的高手！

Happy Coding 🧑‍💻

标签:爬虫实战经验资源

最热最新

暂无评论

为你推荐

暂无相关推荐

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

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

什么是微服务？

Spring Cloud 能帮你做什么？

环境准备：搭建你的第一个微服务开发环境

1. 安装JDK（Java Development Kit）

2. 安装IDE（推荐IntelliJ IDEA）

3. 安装Maven

核心概念：通俗理解Spring Cloud的关键组件

1. Eureka（注册中心）

2. Ribbon（负载均衡器）

3. Feign（远程调用）

4. Zuul（API网关）

实战项目：跟着一步步构建两个简单的微服务

第一步：创建父工程（可选）

第二步：创建 Eureka 服务器

1. 新建子模块：eureka-server

2. 添加 Spring Cloud 依赖

3. 启动类

4. 配置 application.yml

5. 运行并查看

第三步：创建订单服务（order-service）

1. 新建模块 order-service

2. 添加依赖

3. 启动类

4. 配置 application.yml

5. 创建一个测试控制器

第四步：创建用户服务（user-service）

1. 新建模块 user-service

2. 添加 Feign 依赖

3. 启动类添加注解启用 Feign

4. 配置 application.yml

5. 创建 Feign 客户端接口

6. 创建UserController

测试访问：

常见问题：新手容易遇到的坑及解决办法

❓ 问题1：Eureka页面不显示注册的服务？

❓ 问题2：Feign调用失败或超时？

❓ 问题3：多个服务无法同时运行？

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

🚀 方向1：更强大的服务治理

📦 方向2：部署与运维

🔐 方向3：安全与权限

总结

评论 0

为你推荐

相关推荐

精选内容