ThinkPHP主从配置不解决MySQL复制延迟，需业务层主动控制读库走向；必须同时设置deploy=>1和rw_separate=>true，slave为完整数组配置，写后立即读应强制走主库，监控需基于Db::listen()获取真实连接信息，缓存需与主从路由协同避免脏数据。
ThinkPHP 数据库主从配置本身不解决延迟问题，延迟是 MySQL 复制机制固有特性，框架只负责路由，不自动感知或规避。真正有效的处理方式是“业务层主动控制读库走向”，而不是等配置自动修正。
主从配置必须满足的硬性条件
很多延迟问题其实源于配置未生效——看起来配了从库，实际所有查询仍走主库，导致误判为“延迟高”，其实是根本没走从库。
-
deploy => 1 和 rw_separate => true 必须同时存在，且写在具体连接配置内（如
connections.mysql），不能放在顶层或 default 分组里 - TP6 中
slave必须是数组，每个元素是完整独立配置（含hostname、database、username、type => 'mysql'），缺一不可 - 别用旧版 TP5 的逗号分隔写法（如
'DB_HOST' => 'master,slave1,slave2'），TP6 已废弃该逻辑，会静默退化为单库 - 确认
readwrite_type设置为'balance'或'random'，否则权重和轮询无效
写后立即读不到数据？强制走主库
这是最常见也最容易被忽视的问题：用户注册成功后跳转个人页，Db::name('user')->find($id) 返回 null。不是从库坏了，而是它还没同步完。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 对强一致性场景，直接加
->master(true)：Db::name('user')->master(true)->find($id) - 事务内所有操作（包括 SELECT）自动走主库，无需额外标注，可放心在事务中完成写+读
- 模型操作可用
$model->db('master')->find()，注意该方法只影响后续链式调用 - 避免全局启用
forceMaster，它会让整个请求所有读都绕过从库，失去读写分离意义
监控与日志要带真实连接信息
仅靠 Db::getLastSql() 判断走哪台库是不可靠的——它不反映实际执行连接，也不包含上下文。
立即学习“PHP免费学习笔记（深入）”；
- 监听
Db::listen()回调，在$info中取$info['connection']->getConfig()['hostname']，这才是真实执行的数据库地址 - 日志中必须记录
$info['time']（毫秒级耗时）和$info['type']（read/write），才能关联分析是否因某台从库响应慢导致延迟假象 - 检测主从延迟时，必须禁用 PDO 预处理（
'deploy' => 0），用独立连接执行SELECT UNIX_TIMESTAMP() - UNIX_TIMESTAMP(Seconds_Behind_Master)，直接查Seconds_Behind_Master在只读账户下可能返回 NULL
缓存与读写分离协同避坑
缓存层若不配合主从路由，会放大延迟问题，形成“脏缓存闭环”。
- 写操作后只删缓存，但下次读仍发往从库，查到旧数据再写回缓存——这是典型错误
- 关键路径（如订单详情）应绑定主库读：先
Db::master()->find()，再写入缓存；而不是依赖“缓存失效后自动重载” - 非关键数据可接受短暂延迟，缓存 TTL 可设为略大于平均主从延迟（如 2 秒），减少穿透压力
