根本原因是连接池未显式绑定或语义未正确传递，导致查询默认命中指向主库的default池；需规范池命名、分离读写配置、显式指定连接池（如on()或$connection）、原生查询前置connection()，强一致场景用useWritePdo()。
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 导致冲突：
-
链式调用
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，分布式事务无自动协调机制
刚写入就查不到？用 useWritePdo() 强制读主库
读写分离下，where()->first() 默认走读库，主从延迟会导致“插入后立即查询返回空”。若业务强依赖写后立刻可见（如用户提交表单后跳转详情页），需主动切回主库：
- 在 Model 查询链中加入
->useWritePdo()，例如User::where('id', $id)->useWritePdo()->first() - 该方法绕过读写分离逻辑，强制使用写库连接，适用于关键路径的强一致性读取
