DB::listen() 是 Laravel 推荐的查询监听方式，需在 AppServiceProvider::boot() 中注册，支持读写分离识别、安全拼接 SQL、分级记录与分库分天日志，且须手动扩展至队列、Artisan 和 Tinker 环境。
直接用 DB::listen()，别碰 DB::enableQueryLog() 做长期监控——它只对单请求有效、易漏查、还吃内存。
DB::listen() 必须在 AppServiceProvider::boot() 里注册
监听器不是“写了就能用”，它得在 Laravel 完成数据库连接初始化之后、任何查询执行之前就挂上。注册太晚（比如放到中间件或控制器里），模型启动时的查询就收不到。
- 必须用
use Illuminate\Support\Facades\DB;引入门面 - 不能写在
register()方法里——连接还没建好，监听器注册了也白搭 - 如果用了读写分离，
$query->connectionName字段能帮你区分是走读库还是写库，别忽略这个字段 - 重复调用
DB::listen()会导致同一个查询被记录多次，检查是否在多个服务提供者里都注册了
怎么拼出带真实参数的完整 SQL？别用 vsprintf
$query->sql 是带 ? 占位符的模板，$query->bindings 是参数数组。但 vsprintf() 在遇到 null、false、0 或含单引号的字符串时会崩，或拼出非法 SQL。
- 字符串值必须加单引号，且需
addslashes()转义，否则日志里可能混入 SQL 注入式内容 -
DateTime实例要转成'Y-m-d H:i:s'格式字符串，不是直接format('Y-m-d H:i:s')—— 少那对单引号，复制到 MySQL 客户端就报错 - 推荐用正则逐个替换：
preg_replace('/\?/', $replaced_value, $sql, 1)，避免一次全替导致值里有?被误伤 - 二进制、JSON、大文本字段建议跳过拼接，或截断到 200 字符内，不然日志文件几天就涨到 GB 级
生产环境别无脑全记，按条件分级处理
$query->time 单位是毫秒，不是秒。值为 125.75 就是 125.75ms。不看这个数字直接设阈值，很容易把真慢查放过，或被高频轻量查询刷爆磁盘。
- 慢查询建议从
200ms 起记，不是1000；API 接口平均响应若压在 300ms 内，200ms 已算异常 - 高频查询（比如每秒 >5 次相同
SELECT * FROM config）可结合$query->sql做哈希去重，只记首次和次数 - 写操作（
INSERT/UPDATE/DELETE）建议强制记录，不管耗时，方便事后审计 - 日志路径别硬写
storage/logs/sql.log，用storage_path("logs/sql/{$query->connectionName}_" . date('Y-m-d') . ".log")分库分天，避免锁争用
最常被忽略的一点：队列任务、Artisan 命令、Tinker 会话里的查询，DB::listen() 默认不生效——它们不在 Web 请求生命周期里，得在对应入口手动注册一次监听器。别等线上出问题才想起这事。
