# Spring Cloud 常用组件说明文档

# 一、核心概念与概述

# 1.1 什么是 Spring Cloud

Spring Cloud 是一系列框架的有序集合，它利用 Spring Boot 的开发便利性，为分布式系统中的基础设施提供了开发工具集，包括配置管理、服务发现、断路器、智能路由、微代理、控制总线、全局锁、决策竞选、分布式会话和集群状态管理等功能。

分布式系统开发工具集：提供了分布式系统中常见问题的解决方案
Spring Boot 无缝集成：基于 Spring Boot 开发风格，简化配置和开发流程
组件化设计：各个组件可以独立使用，也可以组合使用
轻量级：遵循 "约定优于配置" 的设计理念，减少样板代码

# 1.2 Spring Cloud 与 Spring Boot 的关系

Spring Boot：关注单机应用的快速开发，提供自动配置和起步依赖
Spring Cloud：关注分布式系统的协调，利用 Spring Boot 实现分布式系统的基础设施
依赖关系：Spring Cloud 依赖于 Spring Boot，但可以独立使用
版本对应：Spring Cloud 有自己的版本命名（如 Hoxton、Ilford），每个版本对应多个 Spring Boot 版本

# 1.3 主要版本与特性

Spring Cloud 采用伦敦地铁站名称进行版本命名，按照字母顺序发布：

Hoxton（2020）：支持 Spring Boot 2.2.x-2.3.x，引入 Kubernetes 集成增强
Ilford（2021）：支持 Spring Boot 2.4.x-2.5.x，强化云原生特性
Jubilee（2022）：支持 Spring Boot 2.6.x-2.7.x，优化性能和稳定性
Kilburn（2023）：支持 Spring Boot 3.0.x-3.1.x，全面支持 Java 17 和 Jakarta EE

# 二、服务发现与注册

# 2.1 Spring Cloud Eureka

Eureka 是 Netflix 开源的服务发现组件，用于实现服务注册与发现。

# 2.1.1 核心概念

服务注册中心：Eureka Server，维护所有服务的实例信息
服务提供者：向注册中心注册自己的服务
服务消费者：从注册中心获取服务提供者的信息并调用
心跳机制：服务提供者定期向注册中心发送心跳，证明自己还活着

# 2.1.2 使用示例

服务端配置（Eureka Server）：

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableEurekaServer
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/

客户端配置（服务提供者）：

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableDiscoveryClient
public class ServiceProviderApplication {
    public static void main(String[] args) {
        SpringApplication.run(ServiceProviderApplication.class, args);
    }
}

# application.yml 配置
server:
  port: 8001

spring:
  application:
    name: service-provider

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/
  instance:
    preferIpAddress: true  # 使用 IP 地址注册

# 2.2 Spring Cloud Consul

Consul 是 HashiCorp 开源的服务发现和配置工具，具有高可用、多数据中心的特性。

# 2.2.1 核心特性

服务发现：自动注册和发现服务实例
健康检查：支持多种健康检查方式
KV 存储：分布式键值存储，可用于配置中心
多数据中心：原生支持多数据中心部署
安全通信：支持 TLS 加密和 ACL 访问控制

# 2.2.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-consul-discovery</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableDiscoveryClient
public class ConsulClientApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConsulClientApplication.class, args);
    }
}

# application.yml 配置
spring:
  application:
    name: service-consul
  cloud:
    consul:
      host: localhost
      port: 8500
      discovery:
        instance-id: ${spring.application.name}-${random.uuid}
        service-name: ${spring.application.name}
        prefer-ip-address: true

# 2.3 Spring Cloud Nacos

Nacos 是阿里巴巴开源的服务发现、配置管理和服务管理平台，提供 "注册中心 + 配置中心" 的一站式解决方案。

# 2.3.1 核心特性

动态服务发现：支持基于 DNS 和基于 RPC 的服务发现
配置管理：动态配置服务，支持配置的版本管理和灰度发布
服务健康检查：提供服务的健康检查机制
负载均衡：内置负载均衡策略
高可用：支持集群部署

# 2.3.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableDiscoveryClient
public class NacosClientApplication {
    public static void main(String[] args) {
        SpringApplication.run(NacosClientApplication.class, args);
    }
}

# application.yml 配置
spring:
  application:
    name: service-nacos
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        namespace: public

# 三、配置中心

# 3.1 Spring Cloud Config

Spring Cloud Config 为分布式系统中的外部配置提供服务器和客户端支持，支持配置的集中管理和动态刷新。

# 3.1.1 核心概念

Config Server：配置服务器，管理所有环境的配置文件
Config Client：配置客户端，从配置服务器获取配置
环境：如 dev、test、prod 等不同环境的配置
版本控制：配置文件通常存储在 Git 仓库中，支持版本管理

# 3.1.2 使用示例

服务端配置（Config Server）：

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-server</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableConfigServer
public class ConfigServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConfigServerApplication.class, args);
    }
}

# application.yml 配置
server:
  port: 8888

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/example/config-repo
          search-paths: '{application}'
          default-label: master

客户端配置（Config Client）：

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-config</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

# bootstrap.yml 配置（注意：Spring Cloud 2020.0.0+ 版本需要使用 bootstrap.yml）
spring:
  application:
    name: service-config-client
  cloud:
    config:
      uri: http://localhost:8888
      profile: dev
      label: master

// 配置刷新注解
@RestController
@RefreshScope  // 支持配置动态刷新
public class ConfigController {
    @Value("${config.property}")
    private String configProperty;
    
    @GetMapping("/config")
    public String getConfig() {
        return configProperty;
    }
}

# 3.2 Spring Cloud Nacos Config

Nacos Config 是 Nacos 提供的配置中心功能，支持动态配置更新、多环境配置管理等特性。

# 3.2.1 核心特性

动态配置更新：配置变更后无需重启应用即可生效
多环境配置：支持基于命名空间和分组的多环境配置管理
配置版本管理：记录配置的历史版本，支持回滚
灰度发布：支持配置的灰度发布
配置加密：支持配置的加密和解密

# 3.2.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

# bootstrap.yml 配置
spring:
  application:
    name: service-nacos-config
  cloud:
    nacos:
      config:
        server-addr: localhost:8848
        namespace: dev
        group: DEFAULT_GROUP
        file-extension: yaml

// 配置刷新注解
@RestController
@RefreshScope
public class NacosConfigController {
    @Value("${nacos.config.property}")
    private String nacosConfigProperty;
    
    @GetMapping("/nacos-config")
    public String getNacosConfig() {
        return nacosConfigProperty;
    }
}

# 四、负载均衡与服务调用

# 4.1 Spring Cloud LoadBalancer

Spring Cloud LoadBalancer 是 Spring Cloud 官方提供的负载均衡组件，用于替代 Netflix Ribbon。

# 4.1.1 核心特性

客户端负载均衡：在客户端进行负载均衡决策
多种负载均衡策略：支持轮询、随机等多种负载均衡算法
响应式支持：支持响应式编程模型
可扩展性：支持自定义负载均衡策略

# 4.1.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>

// 配置负载均衡客户端
@Configuration
public class LoadBalancerConfig {
    @Bean
    public ReactorLoadBalancer<ServiceInstance> randomLoadBalancer(Environment environment, 
            LoadBalancerClientFactory loadBalancerClientFactory) {
        String name = environment.getProperty(LoadBalancerClientFactory.PROPERTY_NAME);
        return new RandomLoadBalancer(loadBalancerClientFactory
                .getLazyProvider(name, ServiceInstanceListSupplier.class), name);
    }
}

// 在 RestTemplate 中使用负载均衡
@Configuration
public class RestTemplateConfig {
    @Bean
    @LoadBalanced  // 添加负载均衡注解
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

# 4.2 OpenFeign

OpenFeign 是一个声明式的 Web 服务客户端，简化了 HTTP 客户端的开发。

# 4.2.1 核心特性

声明式 API：通过接口和注解定义 HTTP 客户端
集成负载均衡：内置集成了 Spring Cloud LoadBalancer
支持熔断器：可以与 Hystrix 或 Resilience4j 集成
请求/响应压缩：支持请求和响应的压缩
可插拔编码器/解码器：支持自定义编码器和解码器

# 4.2.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableFeignClients
public class FeignClientApplication {
    public static void main(String[] args) {
        SpringApplication.run(FeignClientApplication.class, args);
    }
}

// 定义 Feign 客户端接口
@FeignClient(name = "service-provider", path = "/api")
public interface UserServiceClient {
    
    @GetMapping("/users/{id}")
    User getUserById(@PathVariable("id") Long id);
    
    @PostMapping("/users")
    User createUser(@RequestBody User user);
    
    @GetMapping("/users")
    List<User> getUsers(@RequestParam("page") int page, 
                        @RequestParam("size") int size);
}

// 使用 Feign 客户端
@RestController
@RequestMapping("/consumer")
public class ConsumerController {
    
    @Autowired
    private UserServiceClient userServiceClient;
    
    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) {
        return userServiceClient.getUserById(id);
    }
}

# 五、断路器与服务容错

# 5.1 Resilience4j

Resilience4j 是一个轻量级的容错库，提供了断路器、限流器、重试、隔离等机制，适合与函数式编程模型一起使用。

# 5.1.1 核心特性

断路器模式：防止系统故障级联传播
限流器：控制并发访问量
重试机制：对失败的请求进行重试
隔离机制：通过信号量或线程池隔离资源
缓存：结果缓存，减少重复计算
时间限制：限制操作的执行时间

# 5.1.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
</dependency>
<dependency>
    <groupId>io.github.resilience4j</groupId>
    <artifactId>resilience4j-spring-boot2</artifactId>
</dependency>

# application.yml 配置
resilience4j:
  circuitbreaker:
    instances:
      userService:
        slidingWindowSize: 10
        minimumNumberOfCalls: 5
        permittedNumberOfCallsInHalfOpenState: 3
        automaticTransitionFromOpenToHalfOpenEnabled: true
        waitDurationInOpenState: 5s
        failureRateThreshold: 50
        eventConsumerBufferSize: 10
  retry:
    instances:
      userService:
        maxAttempts: 3
        waitDuration: 1s
        retryExceptions:
          - java.net.SocketTimeoutException
          - java.io.IOException

// 使用注解方式配置断路器
@RestController
@RequestMapping("/resilience")
public class ResilienceController {
    
    @Autowired
    private RestTemplate restTemplate;
    
    @GetMapping("/users/{id}")
    @CircuitBreaker(name = "userService", fallbackMethod = "getUserFallback")
    @Retry(name = "userService")
    public User getUser(@PathVariable Long id) {
        return restTemplate.getForObject("http://service-provider/api/users/{id}", User.class, id);
    }
    
    // 降级方法
    public User getUserFallback(Long id, Exception e) {
        User fallbackUser = new User();
        fallbackUser.setId(id);
        fallbackUser.setName("Fallback User");
        return fallbackUser;
    }
}

# 5.2 Hystrix（已进入维护模式）

Hystrix 是 Netflix 开源的断路器库，虽然已经进入维护模式，但在很多现有项目中仍广泛使用。

# 5.2.1 核心特性

断路器模式：当服务失败率超过阈值时，自动触发断路器
降级机制：当服务不可用时，返回默认值或备选方案
资源隔离：通过线程池或信号量隔离不同服务的调用
监控面板：提供 Hystrix Dashboard 监控断路器状态
聚合监控：通过 Turbine 聚合多个服务的监控数据

# 5.2.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableCircuitBreaker
public class HystrixApplication {
    public static void main(String[] args) {
        SpringApplication.run(HystrixApplication.class, args);
    }
}

// 使用 HystrixCommand 注解
@Service
public class UserService {
    
    @Autowired
    private RestTemplate restTemplate;
    
    @HystrixCommand(fallbackMethod = "getUserFallback")
    public User getUserById(Long id) {
        return restTemplate.getForObject("http://service-provider/api/users/{id}", User.class, id);
    }
    
    public User getUserFallback(Long id, Throwable e) {
        User fallbackUser = new User();
        fallbackUser.setId(id);
        fallbackUser.setName("Fallback User");
        return fallbackUser;
    }
}

# 六、API 网关

# 6.1 Spring Cloud Gateway

Spring Cloud Gateway 是 Spring Cloud 官方提供的 API 网关，基于 Spring WebFlux 和 Project Reactor 实现，提供了路由转发、请求过滤等功能。

# 6.1.1 核心概念

路由（Route）：网关的基本构建块，由 ID、目标 URI、断言集合和过滤器集合组成
断言（Predicate）：用于匹配请求的条件，只有满足条件的请求才会被路由
过滤器（Filter）：用于修改请求和响应，可以在请求被路由前后执行
动态路由：支持从配置中心动态加载路由配置
限流：支持请求限流功能

# 6.1.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

// 启动类
@SpringBootApplication
@EnableDiscoveryClient
public class GatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}

# application.yml 配置
server:
  port: 9000

spring:
  application:
    name: gateway-service
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true
          lower-case-service-id: true
      routes:
        - id: user-service
          uri: lb://service-provider
          predicates:
            - Path=/api/users/**
            - Method=GET,POST
          filters:
            - StripPrefix=1
            - name: RequestRateLimiter
              args:
                redis-rate-limiter.replenishRate: 10
                redis-rate-limiter.burstCapacity: 20

# 配置限流需要的 Redis
# spring:
#   redis:
#     host: localhost
#     port: 6379

# 注册中心配置
# eureka:
#   client:
#     serviceUrl:
#       defaultZone: http://localhost:8761/eureka/

# 6.2 Zuul（已进入维护模式）

Zuul 是 Netflix 开源的 API 网关，虽然已经进入维护模式，但在一些现有项目中仍有使用。

# 6.2.1 核心特性

动态路由：支持动态更新路由规则
监控与弹性：与 Hystrix 集成，提供熔断和降级功能
安全认证：支持身份认证和授权
请求过滤：支持自定义过滤器处理请求

# 6.2.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
</dependency>

// 启动类添加注解
@SpringBootApplication
@EnableZuulProxy
public class ZuulApplication {
    public static void main(String[] args) {
        SpringApplication.run(ZuulApplication.class, args);
    }
}

# application.yml 配置
server:
  port: 9000

spring:
  application:
    name: zuul-service

zuul:
  routes:
    user-service:
      path: /api/users/**
      serviceId: service-provider
      stripPrefix: true
  host:
    connect-timeout-millis: 2000
    socket-timeout-millis: 5000

# 注册中心配置
# eureka:
#   client:
#     serviceUrl:
#       defaultZone: http://localhost:8761/eureka/

# 七、消息总线

# 7.1 Spring Cloud Bus

Spring Cloud Bus 用于在分布式系统中传播状态变化，通常与 Spring Cloud Config 配合使用，实现配置的动态刷新。

# 7.1.1 核心概念

消息总线：通过消息代理连接分布式系统中的各个节点
事件传播：在一个节点上触发的事件可以传播到整个系统
配置刷新：支持全局配置刷新
支持多种消息代理：如 RabbitMQ、Kafka 等

# 7.1.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bus-amqp</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

# application.yml 配置
spring:
  rabbitmq:
    host: localhost
    port: 5672
    username: guest
    password: guest

# 开启 refresh 端点
management:
  endpoints:
    web:
      exposure:
        include: refresh,bus-refresh

// 在需要刷新配置的类上添加 @RefreshScope 注解
@RestController
@RefreshScope
public class ConfigController {
    @Value("${config.property}")
    private String configProperty;
    
    @GetMapping("/config")
    public String getConfig() {
        return configProperty;
    }
}

触发全局刷新：

# 向任意一个节点发送 POST 请求，触发全局配置刷新
curl -X POST http://localhost:8001/actuator/bus-refresh

# 八、链路追踪

# 8.1 Spring Cloud Sleuth + Zipkin

Spring Cloud Sleuth 提供了分布式系统中的链路追踪功能，而 Zipkin 是一个开源的分布式追踪系统，两者结合使用可以实现完整的链路追踪。

# 8.1.1 核心概念

Trace ID：一条完整链路的唯一标识
Span ID：链路中单个操作的唯一标识
Span：表示一个基本的工作单元，包含操作名称、开始时间、结束时间等信息
Span 上下文：在服务间传递 Trace ID 和 Span ID
采样率：控制链路追踪数据的采集比例

# 8.1.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-sleuth</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-sleuth-zipkin</artifactId>
</dependency>

# application.yml 配置
spring:
  zipkin:
    base-url: http://localhost:9411
    sender:
      type: web
  sleuth:
    sampler:
      probability: 1.0  # 采样率，1.0 表示全部采样

启动 Zipkin 服务：

可以通过 Docker 启动 Zipkin 服务：

docker run -d -p 9411:9411 openzipkin/zipkin

也可以通过 Java 命令启动：

java -jar zipkin-server-2.23.9-exec.jar

# 九、安全认证

# 9.1 Spring Cloud Security

Spring Cloud Security 提供了在分布式系统中处理安全认证和授权的解决方案。

# 9.1.1 核心特性

OAuth2 支持：集成 OAuth2 实现认证和授权
单点登录（SSO）：支持分布式系统中的单点登录
令牌中继：在服务间调用时传递认证信息
API 网关集成：与 Spring Cloud Gateway 或 Zuul 集成，实现统一的安全控制

# 9.1.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-oauth2</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-security</artifactId>
</dependency>

// 认证服务器配置
@Configuration
@EnableAuthorizationServer
public class AuthorizationServerConfig extends AuthorizationServerConfigurerAdapter {
    
    @Autowired
    private AuthenticationManager authenticationManager;
    
    @Override
    public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
        clients.inMemory()
            .withClient("client")
            .secret("secret")
            .authorizedGrantTypes("authorization_code", "password", "refresh_token")
            .scopes("read", "write")
            .redirectUris("http://localhost:8080/callback");
    }
    
    @Override
    public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
        endpoints.authenticationManager(authenticationManager);
    }
}

// 资源服务器配置
@Configuration
@EnableResourceServer
public class ResourceServerConfig extends ResourceServerConfigurerAdapter {
    
    @Override
    public void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/public/**").permitAll()
            .anyRequest().authenticated();
    }
}

# 9.2 Spring Cloud Alibaba Sentinel

Sentinel 是阿里巴巴开源的流量控制和熔断降级框架，提供了丰富的流量控制、熔断降级、系统负载保护等功能。

# 9.2.1 核心特性

流量控制：基于 QPS 或并发线程数的流量控制
熔断降级：当服务不可用时，自动触发熔断
系统负载保护：根据系统负载自动调整流量
热点参数限流：对热点参数进行精确控制
实时监控：提供实时监控和告警功能

# 9.2.2 使用示例

<!-- 添加依赖 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>

# application.yml 配置
spring:
  application:
    name: service-sentinel
  cloud:
    sentinel:
      transport:
        dashboard: localhost:8080
        port: 8719
      eager: true  # 立即加载 Sentinel

// 使用注解方式配置 Sentinel
@RestController
@RequestMapping("/sentinel")
public class SentinelController {
    
    @GetMapping("/hello")
    @SentinelResource(value = "hello", fallback = "helloFallback")
    public String hello() {
        return "Hello Sentinel!";
    }
    
    public String helloFallback() {
        return "Hello Fallback!";
    }
}

启动 Sentinel Dashboard：

java -jar sentinel-dashboard-1.8.6.jar

# 十、最佳实践与架构设计

# 10.1 微服务架构设计原则

单一职责原则：每个微服务只负责一个业务领域的功能
服务边界清晰：根据业务领域划分服务边界，避免服务间耦合
接口设计：
- 采用 RESTful API 设计风格
- 接口版本化管理
- 合理的请求/响应格式
数据管理：
- 每个微服务拥有自己的数据库
- 跨服务数据访问通过 API 调用
- 分布式事务采用最终一致性方案
通信方式：
- 同步通信：使用 OpenFeign 进行服务间调用
- 异步通信：使用消息队列处理异步事件

# 10.2 性能优化建议

缓存策略：
- 引入多级缓存（本地缓存 + 分布式缓存）
- 合理设置缓存过期时间
- 缓存预热和缓存穿透防护
数据库优化：
- 合理设计数据库表结构
- 添加适当的索引
- 读写分离和分库分表
服务优化：
- 服务拆分粒度适中
- 避免长事务
- 合理设置超时时间
网关优化：
- 限流和熔断配置
- 缓存静态资源
- 压缩请求和响应

# 10.3 部署架构建议

开发环境：
- 单机部署所有微服务
- 使用 Docker Compose 管理容器
测试环境：
- 独立的测试环境
- 模拟生产环境的配置
- 自动化测试
生产环境：
- Kubernetes 容器编排
- 服务网格（如 Istio）
- 多环境多集群部署
- 灰度发布和金丝雀发布

# 10.4 监控与运维

监控体系：
- 应用监控：健康检查、性能指标
- 业务监控：关键业务指标
- 基础设施监控：服务器、网络、存储
日志管理：
- 集中式日志收集（如 ELK 栈）
- 结构化日志格式
- 日志级别管理
告警机制：
- 阈值告警
- 异常告警
- 智能告警（如基于机器学习的异常检测）
问题排查：
- 链路追踪
- 分布式日志查询
- 性能分析

# 十一、总结与展望

Spring Cloud 作为目前最流行的微服务框架之一，提供了丰富的组件和工具，帮助开发者快速构建和部署分布式系统。随着云原生技术的发展，Spring Cloud 也在不断演进，加强与 Kubernetes、Service Mesh 等技术的集成，提供更加完善的云原生解决方案。

未来，Spring Cloud 将继续朝着以下方向发展：

更加云原生：深度集成 Kubernetes，支持更多云原生特性
更加轻量级：减少依赖，提高性能
更加智能化：引入 AI 技术，实现智能监控和自动调优
更加安全：加强安全特性，提供更完善的安全解决方案

通过合理使用 Spring Cloud 提供的组件，结合最佳实践，开发者可以构建出高性能、高可用、可扩展的分布式系统，为业务发展提供有力的技术支持。

← Spring Boot 常见问题及答案 Spring Data →