Spring Cloud 微服务核心组件实战指南 | 极客日志

Javajava

Spring Cloud 微服务核心组件实战指南

Spring Cloud 微服务架构涵盖注册中心、配置中心、网关及分布式事务等关键组件。本文详解 Nacos 服务注册与配置管理，OpenFeign 声明式调用，Sentinel 流控降级，Gateway 路由过滤以及 Seata 分布式事务解决方案。通过实际代码示例，展示如何搭建高可用微服务架构，解决远程调用、负载均衡及数据一致性等问题。

女王发布于 2025/10/26更新于 2026/4/240 浏览

Spring Cloud 微服务核心组件实战指南

Spring Cloud 微服务架构实战

Spring Cloud 简介

Spring Cloud 是分布式系统的一站式解决方案。理解分布式架构前，先明确它与单体、集群的区别：

架构演进	单体架构	集群架构	分布式架构
定义	所有功能模块都在一个项目里	单体的多服务器版本	大型应用拆分成小应用分布部署
优点	开发部署简单	解决大并发	解决单体 + 集群问题，模块自治
缺点	无法应对高并发	模块升级麻烦，多语言交互难	需处理远程调用、数据一致性等

在分布式架构中，通常通过网关（Gateway）分发请求，微服务独立部署并注册到注册中心（Nacos）。若模块跨服务器调用，需借助 Nacos 进行服务发现与配置管理。当服务调用失败可能引发雪崩时，需引入熔断机制（Sentinel）。涉及多个数据库操作时，则需分布式事务方案（Seata）。

前期准备

搭建项目骨架

快速搭建框架结构，创建父工程 spring-cloud-demo。

导依赖

在父模块的 pom.xml 中管理版本，注意 Spring Boot、Spring Cloud 及 Spring Cloud Alibaba 的版本兼容性。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        3.3.4
        
    
    4.0.0
    com.atguigu
    spring-cloud-demo
    1.0-SNAPSHOT
    pom
    
        17
        17
        UTF-8
        2023.0.3
        2023.0.3.2
    
    
        
            
                org.springframework.cloud
                spring-cloud-dependencies
                ${spring-cloud.version}
                pom
                import
            
            
                com.alibaba.cloud
                spring-cloud-alibaba-dependencies
                ${spring-cloud-alibaba.version}
                pom
                import

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
</dependencies>

server.port=8000
spring.application.name=service-order
spring.cloud.nacos.server-addr=127.0.0.1:8848

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

@Service
@Slf4j
public class OrderServiceImpl implements OrderService {
    @Autowired DiscoveryClient discoveryClient;
    @Autowired RestTemplate restTemplate;

    @Override
    public Order createOrder(Long userId, Long productId) {
        // 获取服务实例列表
        List<ServiceInstance> instances = discoveryClient.getInstances("service-product");
        ServiceInstance instance = instances.get(0);
        String url = "http://" + instance.getHost() + ":" + instance.getPort() + "/productId/" + productId;
        log.info("远程请求：{}", url);
        return restTemplate.getForObject(url, Product.class);
    }
}

@Autowired LoadBalancerClient loadBalancerClient;
ServiceInstance choose = loadBalancerClient.choose("service-product");

@Configuration
public class OrderConfig {
    @LoadBalanced
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

spring.config.import=nacos:service-order.properties
# 关闭配置检查，避免未配置时报错
spring.cloud.nacos.config.import-check.enabled=false

spring:
  profiles:
    active: prod
  cloud:
    nacos:
      config:
        import-check:
          enabled: false
        namespace: ${spring.profiles.active:public}

@FeignClient(value = "service-product")
public interface ProductFeignClient {
    @GetMapping(value = "/productId/{id}")
    public Product getProductById(@PathVariable("id") Long productId);
}

logging:
  level:
    com.atguigu.order.feign: debug

spring:
  cloud:
    openfeign:
      client:
        config:
          default:
            connect-timeout: 1000
            read-timeout: 2000

@Bean
Retryer retryer() {
    return new Retryer.Default();
}

@FeignClient(value = "service-product", fallback = ProductFeignClientFallback.class)
public interface ProductFeignClient { ... }

spring.cloud.sentinel.transport.dashboard=localhost:8080
spring.cloud.sentinel.eager=true

spring:
  cloud:
    gateway:
      routes:
        - id: order-route
          uri: lb://service-order
          predicates:
            - Path=/api/order/**
          filters:
            - RewritePath=/api/order/?(?<segment>.*), /${segment}

@Component
public class RTGlobalFilter implements GlobalFilter, Ordered {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        long startTime = System.currentTimeMillis();
        return chain.filter(exchange).doFinally(r -> {
            long endTime = System.currentTimeMillis();
            log.info("耗时：{}ms", endTime - startTime);
        });
    }
    @Override
    public int getOrder() { return 0; }
}

@GlobalTransactional
public void createOrder(...) {
    // 调用其他服务
    accountService.deduct(...);
    storageService.reduce(...);
}