动态路由表与缓存隔离的核心是确保租户间资源不污染,通过配置中心+数据库兜底加载路由、统一租户前缀键、拦截器注入上下文、双删+版本号联动刷新,并规避ThreadLocal未清理等陷阱。

动态路由表的获取与缓存隔离,本质是让系统在运行时快速、准确地知道“该查哪个库/哪个表/哪个缓存”,同时确保租户间不互相污染。它不是孤立功能,而是数据隔离和资源控制的执行枢纽。
动态路由表的来源与加载时机
路由表记录租户ID与物理资源(数据库URL、Schema名、缓存前缀等)的映射关系,必须可靠、可维护、低延迟访问。
- 配置中心驱动:将路由信息(如 tenant-a → db-prod-01, schema_a)存入 Nacos 或 Apollo,应用启动时全量拉取,运行时监听变更并热更新。适合租户数中等(几百)、变更不频繁的场景。
-
数据库兜底存储:在主库中建一张
tenant_route表,存放租户ID、数据源标识、Schema名、配额参数等。首次访问或配置中心不可用时查此表,并本地缓存。避免单点依赖,增强容灾能力。 - 懒加载+本地缓存:不预加载全部租户,而是按需加载。第一次请求某租户时,从配置中心或DB查出其路由信息,放入本地ConcurrentHashMap,并设TTL(如30分钟)。减少冷启动压力,但需处理缓存穿透(加布隆过滤器或空值缓存)。
缓存键的租户前缀隔离
缓存是高频共享资源,键设计不当极易导致跨租户读写污染。核心原则是“所有缓存键必须显式携带租户上下文”。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
-
统一前缀策略:所有缓存Key强制以
tenant:{id}:开头,例如tenant:abc123:user:1001、tenant:xyz789:order:list:page1。Redis 或 Caffeine 层面无需额外逻辑,靠命名隔离。 -
拦截器自动注入:在Web拦截器或Feign Client拦截器中,解析请求Header(如
X-Tenant-ID)或JWT中的租户标识,绑定到当前线程上下文(TenantContextHolder.setTenantId()),后续业务代码拼Key时直接调用TenantContextHolder.getTenantId()获取,避免硬编码或遗漏。 - 禁止无租户上下文的缓存操作:在缓存工具类封装层加入校验,若当前线程未设置租户ID,则抛异常或拒绝写入。杜绝“全局缓存”陷阱。
路由表与缓存的联动刷新机制
租户配置变更(如升配、迁移库、切换Schema)后,旧路由和旧缓存必须同步失效,否则会出现数据错乱。
-
双删策略:修改租户路由配置时,先删除对应租户在本地缓存中的路由条目,再删除Redis中该租户的所有缓存(可用
KEYS tenant:abc123:*+ pipeline,或更优的SCAN遍历删除);最后通知其他节点清本地缓存(通过MQ或配置中心事件)。 -
版本号标记:为每个租户路由信息增加
version字段。每次更新路由时 version+1,同时将 version 写入缓存Key(如tenant:abc123:v2:user:1001)。应用读缓存时校验 version 是否匹配当前路由表,不匹配则回源加载并刷新缓存。 - 缓存Key自带租户+版本:把租户ID和路由版本号共同作为缓存Key的一部分,天然规避旧数据残留问题,也降低误删风险。
避免常见陷阱
这些细节看似微小,却常引发线上事故:
-
ThreadLocal未清理:HTTP请求结束后必须调用
TenantContextHolder.clear(),否则线程复用时会携带上一个租户的ID,造成“串租户”。建议用Spring的HandlerInterceptor.afterCompletion或@Around切面统一处理。 -
异步线程丢失上下文:定时任务、CompletableFuture、@Async方法中,ThreadLocal不自动传递。必须显式传递租户ID(如
task.submit(() -> { TenantContextHolder.set(tenantId); ... })),或使用TransmittableThreadLocal。 -
跨租户统计类缓存未隔离:平台级报表缓存(如“全站订单总数”)不属于某个租户,应单独命名(如
platform:order:total),并确保查询逻辑不依赖租户上下文,避免被误塞进租户前缀空间。


















