Hyperf协程池不支持复用多种数据库连接，而是为每种数据库实例配置独立连接池；需在databases.php中按版本/环境命名、显式声明驱动与pool参数，并调优max_idle_time、heartbeat等协同参数。
Hyperf 协程池本身不支持“复用”多个不同数据库连接——这不是功能缺失，而是设计上的主动隔离。关键在于：**不是让一个连接池兼容多种数据库，而是为每种数据库实例配置独立、精准的连接池**。这样既能避免协议冲突、认证失败、连接失效等隐患，又能实现真正的高性能复用。
为什么不能混用同一连接池
MySQL 5.7 和 MySQL 8.0 默认认证插件不同（mysql_native_password vs caching_sha2_password），共用连接池会导致部分连接卡在握手阶段；PostgreSQL 12+ 的预编译语句行为与旧版驱动不兼容，可能抛出 prepared statement "pdo_stmt_" does not exist；更严重的是，若按高版本调优 max_connections，低版本实例会直接拒绝新连接，报错 Too many connections。
正确配置多个独立连接池
在 config/autoload/databases.php 中为每个数据库定义语义清晰的连接名和完整配置：
- 命名要有区分度，例如
mysql_v57_rds、mysql_v80_local、pgsql_v14_cloud，避免db1、db2这类无意义名称 - 每个连接必须显式声明
driver、host、port、charset及完整pool子项 -
pool内务必设置enable_pool => true，且min_connections/max_connections按该实例实际承载力设定（如 MySQL 5.7 实例max_connections=200，其连接池建议 ≤150） - 存在认证差异时，补全连接参数：MySQL 8.0 加
'options' => [PDO::ATTR_EMULATE_PREPARES => false]，5.7 则可能需设true
连接池关键参数调优要点
真正影响稳定性和复用效率的不是数量，而是几个易被忽略的协同参数：
-
max_idle_time必须严格小于数据库服务端的空闲超时（MySQL 的wait_timeout，PostgreSQL 的tcp_keepalives_idle），建议设为wait_timeout - 30 -
heartbeat不是后台常驻心跳，默认只在连接取出时单次 PING；真正起效的是空闲检查线程，它依赖max_idle_time与heartbeat协同，推荐heartbeat = max_idle_time / 2 -
min_connections别设为 0，冷启动延迟高；建议 ≥ 2，确保初始就有可用连接 -
wait_timeout（客户端等待连接超时）建议生产环境 ≥ 5.0 秒，太小容易触发排队失败
运行时动态切换连接池（无需重启）
Hyperf 支持框架启动后通过 ConfigInterface 修改内存中连接配置，适用于灰度升级或 A/B 测试场景：
示例代码：
获取配置实例 → 修改指定连接池的 max_connections → 触发连接池重建。整个过程不影响正在处理的请求，连接池会在下一次获取连接时自动应用新配置。
