必须为每个租户创建独立*sql.DB实例并缓存,因连接池不保留search_path状态,复用会导致租户A的schema设置污染租户B查询;所有租户资源(Redis、etcd、文件句柄等)均需按tenantID隔离初始化与缓存,禁止全局复用。

延迟加载多租户资源必须按租户粒度缓存实例,不能共享连接池或全局句柄;否则第一次加载的租户上下文会污染后续所有请求。
为什么db.Exec("SET search_path TO tenant_a")不能复用连接池
database/sql 的连接池不保证连接状态延续——连接归还后,search_path 设置丢失,下个 goroutine 拿到该连接时仍处于默认 public schema。实际现象是:租户 A 请求触发 SET search_path,租户 B 紧接着复用同一连接,却查到了租户 A 的表数据。
- 必须为每个租户创建独立的
*sql.DB实例,用sync.Map缓存tenantID → *sql.DB - 首次初始化时立即执行
db.Exec("SET search_path TO " + safeSchemaName),确保该连接从诞生起就绑定 schema -
safeSchemaName必须白名单校验(如正则^[a-z][a-z0-9_]{2,30}$),禁止拼接原始输入 - 每个租户实例必须调用
db.SetMaxOpenConns(5)和db.SetConnMaxLifetime(5 * time.Minute),防连接数爆炸
缓存客户端(Redis/etcd)如何避免跨租户污染
全局单例的 *redis.Client 或 *clientv3.Client 本身无租户语义,直接复用会导致 key 冲突、watch 范围越界、配置覆盖等静默错误。
- 不要在中间件里往
context.Context塞 client 实例——context 是透传载体,不是资源容器 - 应封装成工厂函数:
func(tenantID string) *redis.Client,内部做连接池隔离 + key 前缀固化 - etcd 的
Watch()必须按租户路径过滤,例如/config/tenant-a/,且 watch channel 不可跨租户复用 - viper 等配置库若需租户级热更新,必须为每个租户启动独立
viper.New()实例,禁用全局viper
文件句柄和临时资源为何不能延迟“一次加载、长期持有”
*os.File、os.TempDir()、flock 文件锁等资源不具备租户上下文,延迟加载后若缓存在全局 map 或 long-lived struct 中,将导致租户 A 的文件操作影响租户 B。
立即学习“go语言免费学习笔记(深入)”;
- 禁止缓存
*os.File到全局变量或结构体字段中;每次读写都应基于租户路径重新os.Open/os.Create - 临时文件必须用租户专属子目录:
filepath.Join(os.TempDir(), tenantID, uuid.New().String()) - 文件锁(
syscall.Flock)必须在租户路径上加锁,且锁文件名含tenantID,避免不同租户锁竞争失效 - 所有路径构造前必须过
filepath.Clean(),再比对是否仍以/data/tenant-a/开头,拦截../遍历
最易被忽略的是:延迟加载常伴随“首次调用才初始化”的惯性思维,但多租户场景下,“首次”属于哪个租户必须绝对明确——没有“全局首次”,只有“每个租户各自的首次”。任何试图复用、缓存、懒初始化跨租户资源的行为,本质上都在制造隐式共享状态。


















