Hyperf携程MySQL多数据源拆分实操步骤-php教程-PHP中文网

hyperf多数据源需在config/autoload/databases.php中显式定义各连接名（如'user_db'、'order_db'），每个连接独立配置pool、charset等参数，模型需声明$connection属性，跨库查询须用全限定表名或分步查询，事务仅限单库，热更新配置后需重启进程生效。

hyperf携程mysql多数据源拆分实操步骤

Hyperf 项目里直接用 mysql 多数据源做垂直拆分（比如用户库、订单库分离），不是靠框架自动识别业务边界，而是靠你手动配、手动切、手动管——不写清楚数据源归属，Db::connection('user_db') 就会报 Connection not found。

怎么配多个 MySQL 数据源而不冲突

Hyperf 的 db 组件默认只认 default 连接，加第二个必须显式声明；否则 Db::connection('order_db') 会直接抛异常，而不是 fallback 到 default。

在 config/autoload/databases.php 里定义多个连接配置，每个以键名区分，例如 'user_db'、'order_db'，不能只改 host 或 database 却共用同一个连接名
每个连接的 pool.min_connections 和 pool.max_connections 要按业务读写量单独设，比如订单库写多，max_connections 建议设为 50，用户库读多缓存强，可设为 20
务必检查 charset 和 collation 是否一致，混合使用 utf8mb4_unicode_ci 和 utf8mb4_general_ci 可能导致 JOIN 查询时隐式转换失败
如果用了 hyperf/database 的模型功能，每个模型顶部要加 protected $connection = 'user_db';，否则它默认走 default，哪怕你在查询时写了 Db::connection('user_db')，模型实例仍可能错连

跨库关联查询时为什么查不到数据

MySQL 本身不支持跨库 JOIN（除非用 db_name.table_name 全限定写法且权限允许），而 Hyperf 的 Db 类不做自动库名补全——from('users') 永远只查当前连接指定的库，不会因为你之前连了 user_db 就自动把 orders 表也拉过去。

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

禁止在单个 Db::connection() 链式调用里混用不同库的表，例如 Db::connection('user_db')->table('users')->join('orders', ...) 必然失败，因为 orders 不在 user_db 中
真要关联，得用两次查询：先查 users，取出 user_id 数组，再用 whereIn 查 orders 表，或者用 Db::raw() 写全限定名 Db::table('order_db.orders')（前提是账号有跨库权限）
如果依赖 Eloquent 模型关联，belongsTo 等方法底层仍是单连接查询，需重写 newQuery 方法强制指定连接，或改用 DB::raw 手动拼

事务跨多数据源一定会失败

Hyperf 的 Db::transaction() 仅作用于单个连接实例，Db::connection('user_db')->transaction(...) 和 Db::connection('order_db')->transaction(...) 是两个完全隔离的事务，无法保证原子性。XA 事务在 Hyperf + MySQL 场景下基本不可用，官方不推荐。