在 Spring Boot 中使用 Spring Cloud，主要是通过集成 Spring Cloud 提供的一些功能来构建微服务应用。Spring Cloud 提供了一些有用的组件来支持微服务架构，如服务注册与发现、负载均衡、API 网关、配置管理、断路器等。

下面是如何在 Spring Boot 项目中使用 Spring Cloud 的基本步骤。

1.设置 Spring Boot 项目

首先，确保你已经创建了一个 Spring Boot 项目。你可以使用 Spring Initializr（https://start.spring.io/）来快速生成一个 Spring Boot 项目，选择 Spring Web 和 Spring Boot DevTools 等常见的依赖。

2.添加 Spring Cloud 依赖

在 pom.xml 或 build.gradle 文件中添加 Spring Cloud 相关的依赖。

使用 Maven：

在 pom.xml 文件中，添加 Spring Cloud 相关的依赖，并指定 Spring Cloud 的版本。在 Spring Boot 2.x 和 Spring Cloud 2020.x 版本中，Spring Cloud 提供了一个 BOM（Bill of Materials）来管理依赖的版本。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2020.0.4</version> <!-- 选择适合的版本 -->
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- 选择你需要的Spring Cloud组件，例如服务注册与发现 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>

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

    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Spring Boot Actuator（用于监控） -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

查看全部

使用 Gradle：

dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:2020.0.4"  // 选择适合的版本
    }
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.cloud:spring-cloud-starter-netflix-eureka-client'
    implementation 'org.springframework.cloud:spring-cloud-starter-config'
    implementation 'org.springframework.boot:spring-boot-starter-actuator'
}

3.启用 Spring Cloud 组件

在 application.properties 或 application.yml 配置文件中启用 Spring Cloud 相关组件的功能。

服务注册与发现：Eureka 客户端

例如，如果你想使用 Eureka 作为服务注册与发现框架，你需要添加 @EnableEurekaClient 注解，并配置 Eureka 的相关属性。

在application.yml中配置 Eureka：

spring:
  application:
    name: my-service
  cloud:
    discovery:
      enabled: true
    eureka:
      client:
        service-url:
          defaultZone: http://localhost:8761/eureka # Eureka 服务器地址

在 Spring Boot 主类上启用 Eureka 客户端：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient  // 启用服务发现功能
public class MyServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(MyServiceApplication.class, args);
    }
}

服务注册与发现：Eureka 服务器

如果你也想启动一个 Eureka 服务器，可以创建另一个 Spring Boot 项目，并配置为 Eureka 服务器。

在application.yml中配置 Eureka 服务器：

server:
  port: 8761
spring:
  application:
    name: eureka-server
  cloud:
    eureka:
      server:
        enable-self-preservation: false  # 禁用自我保护机制（方便开发测试）
      client:
        register-with-eureka: false   # 该应用作为 Eureka 服务器，不注册自己
      instance:
        hostname: localhost

启动 Eureka 服务器：

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);
    }
}

4.API 网关：Spring Cloud Gateway

如果你想为微服务应用设置一个 API 网关（统一的入口点），你可以使用 Spring Cloud Gateway。它可以帮助你处理请求路由、认证、限流等。

添加依赖：

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

配置 Gateway 路由规则：

在 application.yml 中配置网关路由：

spring:
  cloud:
    gateway:
      routes:
        - id: my-service-route
          uri: lb://MY-SERVICE  # 微服务的名称（Eureka 服务名）
          predicates:
            - Path=/my-service/**  # 以 `/my-service` 开头的请求都会转发到该服务

5.分布式配置管理：Spring Cloud Config

Spring Cloud Config 提供了集中式配置管理服务，允许将配置文件存储在 Git 仓库或文件系统中，微服务应用可以从 Config Server 拉取配置。

配置 Spring Cloud Config 服务器：

1. 添加 Spring Cloud Config 服务器依赖：
2. <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-config-server</artifactId> </dependency>
3. 启动 Config Server：
4. import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.config.server.EnableConfigServer; @SpringBootApplication @EnableConfigServer // 启用 Config Server public class ConfigServerApplication { public static void main(String[] args) { SpringApplication.run(ConfigServerApplication.class, args); } }
5. 在 application.yml 中配置 Config Server 的 Git 仓库路径：
6. spring: cloud: config: server: git: uri: https://github.com/my-repo/config-repo # 配置文件的 Git 仓库地址 search-paths: '{application}' # 按服务名查找配置

配置 Spring Cloud Config 客户端：

1. 添加 spring-cloud-starter-config 依赖：
2. <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-config</artifactId> </dependency>
3. 配置客户端获取配置：
4. spring: application: name: my-service # 从 Config Server 获取与该名称相关的配置 cloud: config: uri: http://localhost:8888 # Config Server 地址

6.断路器：Hystrix

Spring Cloud 集成了 Netflix Hystrix 作为断路器，用于处理服务间的调用故障。

添加依赖：

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

启用 Hystrix 注解：

import com.netflix.hystrix.contrib.javanica.annotation.HystrixCommand;
import org.springframework.stereotype.Service;

@Service
public class MyService {

    @HystrixCommand(fallbackMethod = "fallbackMethod")
    public String callExternalService() {
        // 外部服务调用
        return "Success";
    }

    public String fallbackMethod() {
        return "Fallback response";
    }
}

7.启动微服务

• 启动 Eureka 服务器。
• 启动服务提供者（如 MyServiceApplication）。
• 启动 API 网关（如 GatewayApplication），通过网关访问微服务。

通过 Spring Cloud 你可以非常方便地在 Spring Boot 中构建一个完整的微服务架构。通过配置服务发现、负载均衡、API 网关、分布式配置等功能，能够解决许

Tags：springinitializr