hyperf中无法直接运行时修改连接池配置，因dbconnectionpool启动即固化；正确做法是中间件存租户id至context，dao层读取后动态创建pdo连接，绕过db门面与预定义连接池。
Hyperf 中无法直接在运行时修改连接池配置
Hyperf 的 DbConnectionPool 在服务启动时就完成了初始化，连接池实例、PDO 实例、配置元数据（如 host、dbname、username）全部被固化。调用 Context::set() 或手动替换 Container 中的连接对象，对已创建的连接池无实际影响——后续 Db::select() 仍会从原池中取连接，不会感知上下文里的“新配置”。
正确做法：用独立连接 + Context 透传租户标识
绕过连接池复用逻辑，每次请求按租户 ID 构造全新 PDO 连接。关键在于把租户信息从请求入口（如中间件）写入 Context，并在 DAO 层读取并构建连接：
- 在中间件中解析租户标识（如子域名、header、token payload），存入
Context::set('tenant_id', $id) - DAO 方法内调用
Context::get('tenant_id')，查出对应数据库配置（如从 Redis 缓存或配置中心） - 使用
new PDO($dsn, $user, $pass, $options)创建连接，不走Db::静态门面 - 注意手动设置
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION和字符集
示例片段：
本页面提供企业级 PHP 协程框架 Hyperf 3.1.66 版本的官方源码下载与完整更新日志。重点解析 v3.1.66 版本中新增的 gRPC 多客户端负载均衡支持、Pool 连接池全量刷新、Guzzle 持久化 Cookie 以及数据库 JSON 包含键查询等核心优化特性。
// 在 Service 中
$tenantId = Context::get('tenant_id');
$config = $this->tenantConfigService->get($tenantId);
$pdo = new PDO(
"mysql:host={$config['host']};dbname={$config['dbname']};charset=utf8mb4",
$config['user'],
$config['pass'],
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);
为什么不用 Hyperf Db 组件的「多库」能力？
Hyperf db 配置支持多个预定义连接（如 default、tenant_a），但前提是连接名必须在 config/autoload/db.php 中静态声明。动态租户数可能达数百甚至上千，不可能预先配几百个连接块。硬编码会导致配置膨胀、启动变慢、热更新失效——这不是多租户场景的设计路径。
Context 切换不等于连接切换，漏掉这步必连错库
很多人以为在中间件里 Context::set('tenant_id', 't1') 后，DAO 里直接 Db::table('users')->get() 就能自动路由，这是错的。Hyperf 的 Db 门面底层仍依赖容器中注册的固定连接池，和 Context 完全解耦。必须显式构造连接、显式执行 SQL、显式管理事务边界（$pdo->beginTransaction() 等）。否则所有租户请求都会打到同一个默认库上。
