ci4读写分离必须手动扩展database类而非修改.env；需重写connect()方法动态路由select/非select查询至不同连接，且pdo持久连接需覆盖initdriver()实现，主从延迟导致的弱一致性属mysql固有特性，非框架问题。
CI4 读写分离必须绕过 .env 直接改 Database 类
CodeIgniter 4 官方不支持开箱即用的读写分离，.env 文件只允许配置单个默认连接（database.default.*），填多个 host 或加从库参数会被忽略。想实现读写分离，必须手动扩展 \Config\Database 类，不能依赖配置文件自动加载。
常见错误是试图在 .env 里写 database.read.hostname 或复制一份 database.write.* —— CI4 的 Database 类根本不解析这些键名，启动时静默跳过，最终所有查询仍走 default 连接。
- 正确做法：在
app/Config/Database.php中重写connect()方法，根据当前请求类型（SELECTvsINSERT/UPDATE/DELETE）动态返回不同连接实例 - 需提前定义两个独立的 DSN 配置数组（如
$db['read']和$db['write']），再在connect()里做路由判断 - 注意：
connect()方法接收$group参数，但 CI4 默认只传'default'；你要拦截并改写逻辑，不能只靠$group切换
连接池调优要改底层 PDO 层，不是配 CI4 的 config
CI4 自身没有内置连接池管理，它用的是 PHP 原生 PDO，而 PDO 本身不维护连接池——每次 new PDO() 都是新建物理连接。所谓“连接池”，实际由数据库驱动层（如 MySQL 的 mysqlnd）或中间件（如 ProxySQL、ODP）承担，CI4 只能间接影响。
你在 app/Config/Database.php 里设置的 DBDriver、port、charset 等，只是透传给 PDO::__construct() 的参数，无法控制复用行为。想启用长连接，关键在 PDO DSN 字符串里加 ;PDO::ATTR_PERSISTENT=>true，但 CI4 默认不暴露这个开关。
- 必须在自定义的
Database类中，覆盖initDriver()方法，在构造PDO实例时显式传入[PDO::ATTR_PERSISTENT => true] - 持久连接（pconnect）在 PHP-FPM 下有效，在 CLI 或 Apache prefork 模式下可能失效或引发连接泄漏
- MySQL 服务端需同步调大
wait_timeout（建议 ≥ 300），否则空闲连接会被服务端主动断开，导致下次复用时报 “MySQL server has gone away”
读写分离后查不到最新数据？弱一致性不是 bug 是设计
一旦把 SELECT 路由到从库，就必须接受主从延迟带来的数据不一致。这不是 CI4 或你代码的问题，而是 MySQL 复制机制的固有特性。比如用户刚下单成功（写主库），立刻刷新订单页（读从库），可能看到“订单不存在”——这不是连接配置错，是业务逻辑没兜住。
OceanBase 或 TiDB 等分布式数据库提供 /*+READ_CONSISTENCY(WEAK)*/ Hint 强制弱读，但 MySQL 原生不支持该语法。你在 CI4 的 query 方法里硬塞这个注释，MySQL 会直接报错 Unknown character set: 'READ_CONSISTENCY'。
- 真正可控的方案只有两个：对强一致性读，强制走主库（例如在模型方法里指定
$this->db->group_start()->group_end()并手动切连接） - 对报表、搜索等非关键读，接受几秒延迟，并在前端加“数据可能略有延迟”的提示
- 不要试图用
SLEEP(0.1)或轮询来“等同步”，这只会拖慢响应，且无法保证时效性
连接池监控得靠日志 + 数据库侧指标，CI4 不提供埋点
CI4 的 Database 类没暴露连接获取耗时、空闲连接数、等待队列长度等指标。你没法像 HikariCP 那样调 getActiveConnections() 或看 JMX。想确认连接池是否健康，只能靠外部观测。
最直接的方式是查 MySQL 的 SHOW STATUS LIKE 'Threads_connected'，结合应用 QPS 和平均 SQL 耗时反推连接使用率。如果 Threads_connected 长期接近 max_connections（默认 151），说明池子不够或连接泄漏。
- 在 CI4 的 BaseController 构造函数里加
log_message('debug', 'DB conn count: '. $this->db->getConnection()->getAttribute(PDO::ATTR_CONNECTION_STATUS));没用——PDO::ATTR_CONNECTION_STATUS不返回数字，而是字符串描述，且不可靠 - 有效手段：用
mysqli扩展直连 MySQL，执行SHOW PROCESSLIST，过滤出你的应用 user，统计 sleep 状态连接数 - 更推荐部署
pt-heartbeat监控主从延迟，配合应用层日志里的 SQL 执行时间，交叉定位是网络抖动、从库慢还是连接复用失败
