Hyperf模型基类封装多数据库连接的核心是通过统一BaseModel接管连接逻辑，避免硬编码；需为各数据源配置语义化连接名及独立调优的连接池，跨版本或引擎必须分池，模型通过$connection属性或on()方法动态绑定，事务和关联需显式指定连接以确保一致性。
Hyperf 模型基类封装多数据库连接，核心是让不同数据源的模型能自动绑定对应连接，同时保持复用性和可维护性。不建议在每个模型里硬编码 connection()，而是通过基类统一接管连接逻辑。
定义语义化连接名并配置完整连接池
在 config/autoload/databases.php 中为每个数据库实例声明独立、带含义的连接名（如 mysql_log、pgsql_report），避免使用 db1、db2 这类无意义命名：
- 每个连接必须显式指定
driver、host、database、username、password -
pool配置需按实际 DB 实例承载力单独调优，例如 MySQL 5.7 实例最大连接数为 200，则其连接池max_connections建议设为 ≤150 - 跨大版本（如 MySQL 5.7 vs 8.0）或跨引擎（MySQL vs PostgreSQL）必须分池，不可混用
创建通用 BaseModel 并支持动态连接绑定
所有业务模型继承自统一基类，该基类通过静态属性或构造时参数决定连接名：
- 在基类中定义
protected static string $defaultConnection = 'default'; - 重写
getConnectionName()方法，优先读取模型类中声明的$connection属性，未设置则返回$defaultConnection - 支持运行时传入连接名，例如
User::on('mysql_v80_local')->find(1)，底层调用newQuery()->connection($name)
按业务场景自动切换连接（非硬编码）
连接选择应由业务上下文驱动，而非模型自身硬写死：
- 日志类模型（如
LogRecord）可在类中固定protected $connection = 'mysql_log'; - 报表类模型（如
SalesReport）绑定pgsql_report - 对同一张物理表但部署在不同环境的场景（如灰度库），可通过
ConfigInterface动态覆盖连接配置，无需重启服务
配合 Query Builder 与事务保持一致性
确保查询、关联、事务都走同一连接：
- Eloquent 关联默认复用主模型连接，若关联表在另一库，需在关联方法中显式调用
->on('other_db') - 事务必须用
Db::connection('xxx')->transaction(...)显式指定，不能依赖模型默认连接 - 预加载（
with()）跨库时会报错，应拆分为多次查询并在应用层合并
