Spring Cloud 微服务上云实战：用华为云 ServiceStage + CSE 实现全链路治理

一、背景与痛点

用户服务 (user-service)     ← 被调用
库存服务 (inventory-service) ← 被调用
订单服务 (order-service)     ← 入口，调用上面两个

• 注册中心：Eureka
• 配置中心：Spring Cloud Config + Git
• 链路追踪：Sleuth + Zipkin
• 熔断：Hystrix

二、方案设计

2.1 组件选型

2.2 架构图

┌─────────────────────┐
                    │   API Gateway       │
                    │  (ELB / APIG)       │
                    └─────────┬───────────┘
                              │
                    ┌─────────▼───────────┐
                    │  order-service      │
                    │  (ServiceStage)     │
                    └───┬───────────┬─────┘
                        │           │
            ┌───────────▼┐        ┌▼──────────────┐
            │ user-      │        │ inventory-    │
            │ service    │        │ service       │
            │            │        │               │
            └────────────┘        └───────────────┘

    ┌───────────────────────────────────────────────────┐
    │  CSE 微服务引擎                                    │
    │  ├── 服务注册发现（Service Registry）               │
    │  ├── 配置管理（Config Center）                      │
    │  └── 治理中心（熔断/限流/路由）                      │
    └───────────────────────────────────────────────────┘

    ┌───────────────────────────────────────────────────┐
    │  APM 应用性能管理                                   │
    │  ├── 全链路追踪（Trace）                             │
    │  ├── 应用拓扑（Topology）                            │
    │  └── JVM / 方法级监控                               │
    └───────────────────────────────────────────────────┘

2.3 为什么不用 Istio / Service Mesh

• 需要改部署架构（注入 Sidecar）
• 网络调试复杂度陡增
• 对延迟敏感的业务，Sidecar 多一跳有影响

三、实操步骤

3.1 创建 CSE 微服务引擎

1. 进入 微服务引擎 CSE​ 控制台 → 创建引擎
2. 规格选择：入门版（测试）/ 专业版（生产）
3. 网络：选择与应用同一个 VPC
4. 创建完成后，记录：
   • 注册中心地址：https://cse-xxxx.sr.{region}.cse.myhuaweicloud.com
   • 配置中心地址：https://cse-xxxx.cc.{region}.cse.myhuaweicloud.com

避坑点：CSE 引擎有「专享版」和「共享版」之分。生产环境务必选专享版，避免多租户资源争抢。

3.2 改造 Spring Cloud 应用接入 CSE

<!-- CSE Spring Cloud 适配 -->
<dependency>
  <groupId>com.huaweicloud</groupId>
  <artifactId>spring-cloud-starter-huawei-servicecomb-discovery</artifactId>
  <version>1.11.0-2023.0.x</version>
</dependency>
<dependency>
  <groupId>com.huaweicloud</groupId>
  <artifactId>spring-cloud-starter-huawei-config</artifactId>
  <version>1.11.0-2023.0.x</version>
</dependency>
<dependency>
  <groupId>com.huaweicloud</groupId>
  <artifactId>spring-cloud-starter-huawei-governance</artifactId>
  <version>1.11.0-2023.0.x</version>
</dependency>

版本需与 Spring Boot / Spring Cloud 版本对齐，具体参考官方版本配套表。

spring:
  application:
    name: order-service
  cloud:
    servicecomb:
      discovery:
        enabled: true
        address: https://cse-xxxx.sr.cn-north-4.cse.myhuaweicloud.com
      config:
        enabled: true
        address: https://cse-xxxx.cc.cn-north-4.cse.myhuaweicloud.com
        file-source: order-service.yaml
      governance:
        enabled: true

# AK/SK 认证（使用华为云凭证）
servicecomb:
  credentials:
    enabled: true
    accessKey: ${AK}
    secretKey: ${SK}
    region: cn-north-4

3.3 使用 CSE 配置中心

server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://rds-address:3306/order_db
    username: ${db_user}
    password: ${db_password}

# 自定义业务配置
order:
  timeout-ms: 3000
  max-retry: 2

# 日志级别动态调整
logging:
  level:
    com.example.order: DEBUG

@RestController
@RefreshScope
public class OrderController {

    @Value("${order.timeout-ms}")
    private int timeoutMs;

    @GetMapping("/config/timeout")
    public int getTimeout() {
        return timeoutMs;  // 修改配置中心后无需重启即可生效
    }
}

避坑点：CSE 配置中心的配置优先级高于本地 application.yml，但低于 bootstrap.yml。不要把 spring.application.name 放到配置中心里。

3.4 部署到 ServiceStage

• 环境名称：test-env
• 关联 CCE 集群（或弹性伸缩组）
• 关联 CSE 引擎

• 部署系统：CCE
• 命名空间：shop-demo
• 镜像：SWR 中构建好的 order-service:v1.0
• 环境变量：

  JAVA_OPTS=-javaagent:/opt/asm/asm-agent.jar  # APM Agent
  AK=xxx
  SK=xxx

• 健康检查：HTTP GET /actuator/health
• 弹性伸缩：CPU > 70% 时自动加实例

3.5 接入 APM 全链路追踪

JAVA_OPTS=-javaagent:/opt/asm/asm-agent.jar \
          -Dservice.name=order-service \
          -Dservice.instance=order-service-${HOSTNAME}

• 应用拓扑：自动展示 order → user、order → inventory 的调用关系
• Trace 列表：每次请求生成一条完整调用链
• 方法级耗时：看到 OrderService.createOrder() 里具体哪一步慢

order-service POST /api/orders (120ms)
  ├── user-service GET /api/users/{id} (35ms)
  └── inventory-service POST /api/inventory/deduct (60ms)

3.6 配置熔断与限流

circuitBreaker:
  targetService: inventory-service
  minRequests: 20        # 20 次请求内不触发
  failureRate: 50        # 失败率超 50% 打开熔断
  openDuration: 30s      # 熔断 30 秒后半开

rateLimit:
  targetService: user-service
  qps: 100              # 单实例限流 100 QPS
  algorithm: token_bucket

fallback:
  targetService: inventory-service
  method: deduct
  fallbackResponse: '{"success": false, "message": "库存服务暂不可用，请稍后重试"}'

关键原则：熔断是保护调用方，限流是保护被调方。两者要配合，不能只配一个。

四、验证结果

五、生产避坑清单

1. CSE 版本与 Spring Cloud 版本不匹配：启动直接报错，务必查官方配套表
2. AK/SK 权限过大：给了 AdministratorAccess，应只给 CSE 相关权限
3. 配置中心存敏感信息明文：数据库密码应走密钥管理（KMS）或 CSE 配置加密
4. 熔断阈值设太低：正常波动就触发熔断，反而降低可用性
5. APM Agent 内存不够：Java Agent 本身占 100-200MB，容器内存限制要留余量
6. 服务名用下划线：CSE 服务名不支持 _，用 - 分隔
7. 没配优雅停机：Pod 被杀死时正在处理的请求直接中断

• 认证最小化：创建 IAM 子账号，只授权 CSE FullAccess + APM FullAccess
• 配置分层：公共配置放 common.yaml，服务独有配置放 {service-name}.yaml
• 熔断参数渐进：先观察一周错误率，再定阈值（建议初始 50% / 20次）
• APM 采样率：生产环境采样率设 10%-20%，全量采集性能开销大
• 优雅停机：Spring Boot 配置 server.shutdown=graceful，等待 30s 再 SIGTERM
• 多环境隔离：CSE 引擎按环境创建独立实例（test / staging / prod）

六、总结与扩展

• 注册发现：从自建 Eureka 到 CSE 托管，可用性从 99% 到 99.95%
• 配置管理：从配置文件到动态配置中心，变更从分钟级到秒级
• 可观测性：从翻日志到拓扑+链路+指标三位一体
• 故障防护：从裸奔到熔断+限流+降级三层保护

1. 灰度发布：ServiceStage 支持金丝雀发布，按 Header/权重路由
2. 多AZ 容灾：CSE 引擎跨 AZ 部署，服务实例分布在多个可用区
3. Mesh 演进：当团队和规模都上来后，平滑迁移到 ASM（应用服务网格）
4. 全链路压测：结合 APM 和性能测试服务 CPTS，做生产环境压测
5. 安全治理：服务间 mTLS 通信，结合 IAM 做细粒度访问控制