SaaS 系统中，API 网关承担着流量分发、鉴权、限流等核心职责。在多租户架构下，网关还需要额外处理一项关键任务：租户路由。准确识别每次请求所属的租户上下文，并将其路由到正确的后端服务或数据库实例，是确保系统稳定运行的基础。
识别租户身份的常见方式包括基于子域名（如 tenantA.example.com）、HTTP 请求头（如 X-Tenant-ID）或认证令牌。在现代微服务架构中，利用 JSON Web Token (JWT) 携带租户声明（Claims）是一种兼顾安全与灵活性的方案。当用户完成登录鉴权后，认证服务签发的 JWT 中会包含 tenant_id 以及该租户的层级、路由策略等基本信息。
网关在接收到请求并解析 JWT 后，可以立即获取到租户标识。但这仅仅完成了身份识别，真正的挑战在于如何根据该标识决定后续的路由逻辑。不同租户可能部署在不同的集群，或者配置了不同的限流阈值和功能开关。这些租户元数据如果硬编码或完全依赖关系型数据库实时查询，将无法承受高并发的冲击。
引入 Redis 作为租户元数据的缓存层是解决这一问题的标准实践。网关在内存中无法命中租户路由策略时，通过查询 Redis 获取该租户的后端集群地址、资源配额及降级策略。为了进一步降低网关对 Redis 的依赖和网络延迟，通常会在网关进程内构建一级本地缓存（如使用 LRU 策略的内存缓存），将 Redis 作为二级缓存。本地缓存的失效时间无需设置过长，几秒到几十秒即可有效抵挡突发流量。
在一致性保障方面，当租户的元数据发生变更时（例如因扩容触发了数据迁移，需要更新路由指向），控制面服务会更新数据库，并发布消息到消息队列。网关节点订阅相关主题，收到通知后主动失效本地及 Redis 中的旧配置，确保后续请求能够被路由到新的目的地。
橙星云在处理其复杂的多租户路由时，也采用了类似的网关架构。通过在 APISIX 等高性能网关上编写 Lua 脚本或使用 WebAssembly 插件，可以高效地解析 JWT、校验签名，并从缓存中拉取路由上下文。为了防止单个大租户的异常流量压垮整个系统，网关层还会根据租户的订阅级别和当前系统负载，实施细粒度的限速与配额控制。
设计动态路由时，还需要考虑降级机制。如果缓存层出现故障，网关应该具备回退到后端控制面服务查询元数据的能力，并配合断路器防止雪崩。通过将租户识别、路由查找与流量控制逻辑在网关层进行统一收口，后端的业务微服务可以变得更加纯粹，只需关注具体的业务逻辑实现即可。