Yii动态切换db组件需在请求开始前用setComponents()重注册并open()，不可直接替换Yii::$app->db；租户识别须早于任何DB操作，推荐在bootstrap或beforeRequest中完成。
Yii 框架本身不内置多租户，但能通过组合数据库层控制、模型层拦截和请求上下文管理，干净地实现 SaaS 级隔离——关键不在“有没有”，而在“怎么串起来”。
如何动态切换 Yii 的 db 组件连接？
独立数据库模式下，每个租户对应一个物理库，必须在请求开始前就绑定正确的 db 实例。Yii 不允许运行时直接替换 Yii::$app->db 对象（会破坏连接池和事务状态），正确做法是用 setComponents() 重注册，并确保新连接已 open。
- 租户识别必须早于任何数据库操作——推荐放在
Application::bootstrap或on beforeRequest事件中，不能等到控制器里才做 - 避免在
config/web.php中硬编码 DSN，应从缓存或配置中心读取租户 DB 配置，否则每次部署都要改配置 - 切换后务必调用
Yii::$app->db->open()，否则首次查询会抛出Connection is not open - 事务跨租户会失效：若 A 租户的请求里手动 new 了一个 B 租户的 Connection，
Yii::$app->db->transaction()不会包含它
共享库+Schema 模式下，schemaName 怎么生效？
MySQL 实际没有真正的 Schema 概念（schema 就是 database），所以该模式在 MySQL 中等价于“独立数据库”；但在 PostgreSQL 中，schemaName 才真正起作用。Yii 的 ActiveRecord::getTableSchema() 返回的 Schema 对象带 schemaName 属性，所有生成的 SQL 会自动加上 schema_name.table_name 前缀。
- 不要在模型里硬写
public static $tableSchema = ['schemaName' => 'tenant_123'];—— 这无法动态变化 - 必须重写
getTableSchema()方法，且返回值中的schemaName要从当前租户上下文读取（如Yii::$app->tenant->id） - 注意 Migration 工具默认不支持动态 schema，执行
yii migrate时需显式指定--db参数指向目标 schema 连接 - PostgreSQL 下需提前为每个租户
CREATE SCHEMA tenant_xxx，并授予相应权限
行级隔离为什么必须配合全局查询作用域？
共享库+共享表（只靠 tenant_id 字段）是最易落地也最危险的模式。一旦漏写 where tenant_id = ?，数据就可能跨租户泄露。Yii 的 scenarios 和 rules 解决不了查询过滤问题，必须用 find() 级别的强制拦截。
- 在基类
BaseActiveRecord中定义find()静态方法，统一追加andWhere(['tenant_id' => Yii::$app->tenant->id]) - 禁用裸
new static()实例化后直接save()，应在基类beforeSave()中校验$this->tenant_id是否已设且匹配当前上下文 - 关联查询（
with()）默认不继承主模型的 tenant 条件，需手动在关联定义里加'on' => ['tenant_id' => new \yii\db\Expression('CURRENT_TENANT_ID')]（需配合数据库变量或应用层传参） - 原生 SQL 查询（
createCommand()）完全绕过 AR 拦截，必须人工补tenant_id条件——这是线上事故高发区
租户上下文怎么安全透传到整个请求生命周期？
租户 ID 通常来自子域名（tenant1.example.com）、路径前缀（/t/tenant1/）或登录态 JWT claim。但只要没把它稳稳钉进 Yii::$app 或 ThreadLocal-like 容器，后续任意位置都可能拿错。
- 别用全局变量或静态属性存租户 ID —— Yii 是单例长驻进程，多请求并发时会污染
- 推荐在
bootstrap阶段解析租户标识后，注入自定义组件（如Yii::$app->set('tenant', new TenantContext($id))），并在该组件内封装getId()、isSuperAdmin()等方法 - RBAC 的
checkAccess()默认不感知租户，需重写AccessControlFilter或自定义Rule类，在判断时显式加入租户维度 - 日志、缓存 key、消息队列 topic 等外围系统，都得把
tenant_id显式带上，否则排查问题时根本分不清是哪个租户的流量
最常被忽略的一点：缓存键设计。用 cacheKey = 'user_list_' . $userId 是错的，必须是 'user_list_' . Yii::$app->tenant->id . '_' . $userId —— 否则租户 A 可能命中租户 B 的缓存结果。
