4. 整体架构设计：分层架构概览、租户上下文传递、签名服务网关设计

多租户签名链路的核心挑战在于：如何在共享基础设施上，为每个租户提供隔离、安全、可审计的签名服务。本章从分层架构、上下文传递、网关设计三个维度，构建一个可落地、可扩展的多租户签名传输体系。

4.1 分层架构概览

整体架构采用四层模型，自顶向下依次为：接入层、网关层、服务层、存储层。每层职责清晰，层间通过标准化接口通信，确保租户隔离与水平扩展能力。

4.2 租户上下文传递

租户上下文是贯穿整个签名链路的核心数据载体。它必须包含以下关键字段：

上下文传递采用ThreadLocal + 请求拦截器模式，确保在异步调用场景下不丢失租户信息：

// 租户上下文持有者
public class TenantContextHolder {
    private static final ThreadLocal<TenantContext> CONTEXT = new InheritableThreadLocal<>();

    public static void set(TenantContext ctx) {
        CONTEXT.set(ctx);
    }

    public static TenantContext get() {
        return CONTEXT.get();
    }

    public static void clear() {
        CONTEXT.remove();
    }
}

// 网关过滤器：提取并设置租户上下文
public class TenantContextFilter implements GlobalFilter {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        String tenantId = exchange.getRequest().getHeaders()
                .getFirst("X-Tenant-Id");
        String appId = exchange.getRequest().getHeaders()
                .getFirst("X-App-Id");
        TenantContext ctx = new TenantContext(tenantId, appId);
        TenantContextHolder.set(ctx);
        return chain.filter(exchange)
                .then(Mono.fromRunnable(TenantContextHolder::clear));
    }
}

4.3 签名服务网关设计

签名服务网关是多租户签名链路的流量入口与策略执行点。它承担以下核心职责：

• 租户路由：根据tenantId将请求路由到对应的签名服务实例或集群。
• 签名策略分发：从配置中心拉取租户签名策略（算法、密钥版本、有效期），注入到请求上下文中。
• 限流与熔断：按租户维度实施流量控制，防止单个租户突发流量影响全局。
• 审计日志：记录每次签名请求的租户、时间、算法、结果，支持事后审计。

网关层采用插件化架构，每个处理环节（认证、策略、限流、审计）均可独立配置与扩展。以下是一个典型的网关路由配置示例：

# 多租户签名网关路由配置
spring:
  cloud:
    gateway:
      routes:
        - id: sign-service-route
          uri: lb://sign-service
          predicates:
            - Path=/api/v1/sign/**
          filters:
            - name: TenantAuthentication   # 租户认证过滤器
            - name: SignPolicyLoader       # 签名策略加载过滤器
            - name: TenantRateLimiter      # 租户限流过滤器
              args:
                key-resolver: "#{@tenantKeyResolver}"
                redis-rate-limiter:
                  replenishRate: 100       # 每秒令牌数
                  burstCapacity: 200       # 突发容量
            - name: AuditLogging           # 审计日志过滤器