排查长周期单例多租户串号,核心是识别本该请求级隔离的数据被误存于单例字段、静态变量或未清理的ThreadLocal中;需确认注册为Singleton后,重点检查实例字段、静态集合及ThreadLocal,并用带线程ID和上下文的日志快速验证,修复时按生命周期选用局部变量、HttpContext.Items、AsyncLocal或参数透传。

排查长周期单例中因误用局部变量导致多租户串号,核心在于识别“本该是请求级隔离的数据”被错误地以非线程安全、非作用域隔离的方式暂存。这里的“局部变量”其实是误称——真正危险的是把本应随请求生命周期消亡的数据,存在了单例对象的字段、静态变量或全局缓存里,而开发者误以为“只在当前方法里用,就是局部安全”。
先确认是否真为单例长周期持有问题
检查目标类的注册方式:
- 在 ASP.NET Core 中:看它是否注册为
ServiceLifetime.Singleton(如AddSingleton<itenantservice tenantservice>()</itenantservice>) - 在 Spring 中:确认是否使用
@Scope("singleton")或默认单例作用域 - 在 AWS Lambda 中:观察执行环境复用日志(如
INIT_DURATION后连续多个INVOKE_DURATION),说明容器未销毁,静态/实例字段持续存活
若确认是长周期单例,再往下排查;否则问题可能出在作用域配置错误(比如本该注册为 Scoped 却写成了 Singleton)。
重点排查三类“伪局部”存储位置
这些位置看似只在一次调用中赋值,实则跨请求污染:
-
实例字段(
private string _tenantId;):中间件、服务类中定义的私有字段,每次请求Invoke或handle()时覆盖,但下个请求会读到上个租户残留值 -
静态字段 / 静态集合(
private static Dictionary<string object> _cache;</string>):Lambda 或 Web 容器复用时完全不重置,极易成为跨租户数据通道 -
未清理的线程局部存储(
ThreadLocal<string></string>):尤其在异步场景下,ThreadLocal不随await流动,且若未显式.Remove(),线程被池化复用后仍携带旧值
快速验证串号是否正在发生
在关键路径插入轻量日志,带上下文标识:
- 记录
Thread.CurrentThread.ManagedThreadId和ExecutionContext.IsFlowSuppressed() - 打印当前请求的
tenant_id、时间戳、以及疑似存储位置的当前值(如_tenantId字段值) - 对比相邻两个不同租户请求的日志:若第二个请求刚进入就看到第一个租户的
tenant_id,即确认串号
注意:不要只查日志结尾,要查“刚进方法时”和“刚设字段后”的值,避免掩盖初始化时机问题。
修复方向必须匹配数据生命周期
根据数据用途选择正确载体:
- 仅当前请求内使用 → 改用方法内
var tenantId = ...局部变量 - 需跨中间件/过滤器传递 → 使用
HttpContext.Items["tenant_id"](.NET)或RequestAttributes(Spring WebFlux) - 需贯穿整个异步链路(如日志 MDC、链路追踪)→ 使用
AsyncLocal<string></string>(.NET)或TransmittableThreadLocal(Java) - 需持久化或跨服务 → 必须走参数透传(如 HTTP Header + 显式注入),禁止任何形式的“隐式上下文”

















