codeigniter 4 默认日志不体现主从流向，因 log_message() 仅记录 sql 和耗时，未注入连接别名；需通过 getgroup() 获取组名并手动拼接日志，或在 beforequery 钩子中统一注入，同时将 $threshold 设为 [5, 6] 才能捕获 debug/info 级别读写分离行为。
CodeIgniter 4 默认不自动区分主库/从库操作的日志上下文，log_message() 记录的 SQL 日志无法体现「这条查询走的是主库还是从库」——这是读写分离架构下日志可追溯性的最大缺口。
为什么默认日志看不出主从流向
CI4 的数据库日志（如 log_message('debug', $sql)）只记录 SQL 字符串和执行耗时，不携带连接实例标识。即使你用 $db = \Config\Database::connect('write') 和 $db = \Config\Database::connect('read') 显式调用不同组配置，日志里仍统一显示为 default 或空连接名。
- CI4 的
Database类在启用 query logging 时，只调用Logger::log()，未注入当前连接别名 -
ConnectionInterface实例本身不暴露配置键名（如'write'或'read'），只暴露驱动类型和 host - 日志文件中所有查询都混在一起，排查慢查询时无法判断是主库写阻塞还是从库同步延迟
手动注入连接上下文到日志的实操方式
最轻量且不侵入核心的方式：在自定义数据库服务或模型基类中，用 log_message() 前主动拼接连接标识。不依赖钩子或重写 DB 类。
- 在模型中执行查询前，先获取当前连接的 alias：
$alias = $this->db->getPlatform()->getConnection()->getHost() . ':' . $this->db->getPlatform()->getConnection()->getPort()（不够直观，慎用） - 更可靠的做法：在
app/Config/Database.php中为每组连接显式设置'alias'键，例如：'write' => ['DSN' => '', 'hostname' => 'master.db', ..., 'alias' => 'master'] - 然后在模型中通过
$this->db->getGroup()获取当前组名（需确保你在connect('write')后才调用），再传给日志：log_message('debug', '[' . $this->db->getGroup() . '] ' . $sql) - 若使用 Query Builder，可在
beforeQuery钩子中统一注入（需注册事件监听器）：Events::on('beforeQuery', function($event) { log_message('debug', '[' . $event->connection->getGroup() . '] ' . $event->sql); });
CI4 原生日志阈值对读写分离日志的影响
$threshold 设置直接影响你能否看到主从切换过程中的中间状态日志。比如开启 debug 日志但没看到连接切换记录，很可能是阈值过滤掉了。
- CI4 默认
app/Config/Logger.php中$threshold = 1，仅记录 error 级别，debug和info全部被忽略 - 要观察读写分离行为，必须将
$threshold设为数组并包含5（debug）和6（info）：public $threshold = [5, 6]; - 注意：
info级别日志会记录连接建立事件（如Connected to master.db:3306），但前提是你的自定义连接逻辑里调用了log_message('info', ...) - 生产环境不要长期开启 debug 日志，否则大量 SQL + 连接上下文会快速撑爆日志文件
容易被忽略的连接复用与日志时间错位问题
CI4 的连接池机制会让多次 connect('read') 复用同一个连接实例，但日志里每条 SQL 都可能被记成「新连接」——这其实是日志输出时机和连接生命周期不匹配造成的假象。
- 连接复用发生在
Database::connect()内部，但日志通常在 query 执行后才打，此时连接早已存在，无法反映「首次建连」动作 - 如果你在
afterConnect事件里打日志，又可能因连接复用而漏掉后续复用的记录 - 真正能反映读写分流效果的日志，应聚焦在「SQL 发出前的连接选择决策点」，比如在服务容器中封装一个
DBRouter类，在其query()方法开头就记录：log_message('info', 'Routing to ' . $group . ' for: ' . substr($sql, 0, 64)); - 这种日志比单纯记录 SQL 更有价值，因为它明确告诉你「为什么走这个库」，而不是「它走了哪个库」
