Hyperf读写分离查询不走从库连接修复办法-php教程-PHP中文网

根本原因是连接池未显式绑定或语义未正确传递，导致查询默认命中指向主库的default池；需规范池命名、分离读写配置、显式指定连接池（如on()或$connection）、原生查询前置connection()，强一致场景用usewritepdo()。

hyperf读写分离查询不走从库连接修复办法

Hyperf读写分离配置后查询仍走主库，根本原因不是配置没加，而是连接池未被显式绑定或语义未正确传递。默认情况下，所有未指定连接名的操作都命中 default 池，而这个池若指向主库，就会导致“明明配了读库，却还是查主库”的现象。

检查并规范连接池命名与配置

连接池名称必须全小写、不含点号或大写字母，否则 Db::connection('read_pool_1') 会直接抛出 Connection [read_pool_1] not found。同时，default 连接池应明确指向写库（如 db.write），且不可复用其他池的配置块；读库需单独定义，例如：

db.write：显式配置 host/port/database/username/password，禁用 strict_type 等可能影响写入的选项
read_pool_1：建议启用 strict_type => false 和 fetch_mode => PDO::FETCH_ASSOC，降低从库类型转换开销
default 池保留但不实际使用，避免业务代码漏指定时意外走主库

Model 查询强制走从库的三种有效方式

Eloquent 默认不自动识别读写语义，必须显式声明。以下写法均需确保模型未覆盖 $table 或 $connection 导致冲突：

Hyperf 3.2.4

Hyperf 3.2.4 官方源码下载，适合 PHP 协程框架、微服务组件和高并发应用升级，覆盖 3.2 分支新增函数与稳定性优化。

下载

链式调用 on()：适用于静态查询，如 User::on('read_pool_1')->where('status', 1)->get()；注意 save() 类操作会失败，因从库通常只读
模型内声明 $connection：在模型类顶部加 protected $connection = 'read_pool_1';，该设置仅对 find()、all()、first() 等静态方法生效
关联查询逐层指定：with() 不继承父级连接，必须显式路由每个关联，例如 User::on('read_pool_1')->with(['posts' => fn($q) => $q->on('read_pool_1')])；漏掉任一环节，对应表将回退到 default 池

原生查询与事务的连接绑定要点

Query Builder 与 Eloquent 的连接上下文完全隔离，不能靠“前面用了 on()，后面就自动走读库”。所有原生操作必须前置 connection()：

Db::table('users') 永远走 default，必须写成 Db::connection('read_pool_1')->table('users')->where(...)->first()
Db::select() 不接受连接名参数，必须先 Db::connection('read_pool_1') 再调用
Db::transaction() 仅支持单池，跨 db.write 和 read_pool_1 会直接报错；MySQL 从库本身不支持 BEGIN，分布式事务无自动协调机制