Webman动态切换数据库连接必须绕过默认连接池，本质是按需构造全新连接实例；推荐使用预配置命名连接（Db::connection('name')），租户级或运行时动态场景需手动new Connection并显式释放。
Webman 动态切换数据库连接必须绕过默认连接池
Webman 默认使用 PDO 连接池（仅限 Swoole/Swow 驱动），host、port、database 等参数在启动时固化，运行时无法修改。所谓“动态切换”，本质是**按需构造全新连接实例**，而非复用或重置已有连接。
常见错误现象包括：Connection refused（复用旧 host）、Database xxx does not exist（库名未生效）、高并发下连接数暴涨（每次 Db::connection() 都新建但未释放）。
- 不要试图在运行时调用
Db::setConfig()修改全局配置 —— 它不生效，且可能引发协程间状态污染 - 避免在循环或高频接口中反复调用
Db::connection('xxx')而不缓存实例 —— 每次都会新建 PDO 对象，消耗内存与连接数 - 租户级动态切库（如
tenant_001、tenant_002）必须提前预置所有连接名，或按规则生成连接配置并手动 new Connection 实例
用 Db::connection('name') 切换已配置的命名连接
这是最常用、最安全的“动态”方式，前提是连接名已在 config/database.php 的 connections 中静态定义好。它不创建新连接，而是从连接池中取出对应配置的已复用连接（若启用池）。
使用场景：读写分离、主业务库 + 日志库、插件独立库等固定多源场景。
- 确保
config/database.php中已声明连接，例如'log_db' => [...]，且'default'未被误覆盖 - 在控制器中直接调用：
$logs = Db::connection('log_db')->table('sys_log')->where('level', 'error')->get(); - 模型绑定更省事：
class LogRecord extends Model { protected $connection = 'log_db'; }，后续所有 ORM 操作自动走该连接 - 注意：跨连接事务不支持，
DB::transaction()只作用于单个连接，多库一致性需靠补偿逻辑或消息队列
临时连接新数据库必须手动 new Connection
当连接目标（如库名、host）在请求时才确定（例如 SAAS 多租户按域名切换 tenant_a / tenant_b），必须脱离连接池，手动生成 Illuminate\Database\Connection 实例。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
否则会触发连接池拒绝新配置，或复用旧连接导致查错库。
- 不能依赖
Db::connection('dynamic')，因为'dynamic'不在配置文件里，会 fallback 到 default 并报错 - 正确做法：拼接运行时参数，new PDO 后传入
Connection构造函数，示例：$pdo = new \PDO("mysql:host={$host};dbname={$dbname};charset=utf8mb4", $user, $pass);<br>$conn = new \Illuminate\Database\MySqlConnection($pdo, $dbname, '', []);<br>$result = $conn->table('users')->get(); - 务必在协程结束前显式关闭
$pdo或 unset$conn，否则连接泄漏风险极高 - PHP 8.4+ 需额外调用心跳检测逻辑，否则空闲连接可能被 DBMS 主动断开
Model 动态切库慎用 User::on('xxx')
User::on('mysql2') 看似方便，但它每次调用都会 new 一个全新连接实例，不走连接池，也不复用。高并发下极易耗尽 MySQL 连接数或打满 PHP 内存。
只适合低频、离线任务或调试场景，绝不可用于 Web 请求主链路。
- 替代方案：为每个租户/场景预定义 Model 类，如
TenantAUser继承User并设protected $connection = 'tenant_a' - 若必须运行时决定，优先用
Db::connection($connName)+ 原生查询，避开 Eloquent 初始化开销 - 检查
support\Db是否已引入，未引入会导致Class 'Db' not found—— 这不是命名空间问题，是 autoloader 未加载该类
实际最易被忽略的是连接生命周期管理：Webman 是常驻内存模型，连接池中的连接长期存活，但手动 new 的 PDO 实例不会自动回收。哪怕只在一个中间件里临时切一次库，也得确保它被显式释放，否则几天后连接数可能突破 MySQL 的 max_connections 限制。
