ThinkPHP不提供EXPLAIN封装接口，因Db::query('EXPLAIN...')易因字段类型不匹配、参数未替换或上下文不一致而报错；推荐在Db::listen()回调中通过$explain参数安全获取执行计划，前提是MySQL配置debug=>true且slow_sql_explain=>true。
ThinkPHP 本身不提供 EXPLAIN 命令的封装接口，直接执行 EXPLAIN 需绕过 ORM 抽象层，手动构造原生查询；但框架在慢 SQL 监听中已预留 $explain 参数，可安全获取执行计划（仅限 MySQL，且需配置开启）。
为什么不能直接用 Db::query('EXPLAIN SELECT ...')
ThinkPHP 的 Db::query() 默认返回结果集，而 EXPLAIN 在 MySQL 中返回的是元数据表格（非业务数据），某些驱动（如 PDO）会因字段类型不匹配或 fetch 模式问题抛出 PDOException: SQLSTATE[HY000]: General error。更关键的是：该方式无法复用当前查询上下文（绑定参数、事务状态、连接配置），容易和实际执行的 SQL 不一致。
- 不要在控制器里临时拼
"EXPLAIN " . $sql——SQL 中的占位符（?）不会被替换，导致语法错误 - 避免用
Db::raw()包裹EXPLAIN，它只用于 SELECT/INSERT 等语句内部，不能作为独立查询执行 - 若强行调用，必须显式指定
PDO::FETCH_ASSOC并捕获异常，但结果结构不稳定（不同 MySQL 版本字段名可能不同）
推荐做法：在 Db::listen() 回调中取 $explain
ThinkPHP 8 的 sql_express 事件在 SQL 执行完成后自动触发，并在回调第三个参数 $explain 中返回 EXPLAIN 结果（前提是配置启用且数据库支持）。这不是额外查询，而是复用同一连接、同一语句的原生执行计划。
- 启用条件：MySQL 连接配置中需设置
'debug' => true（默认开发环境开启），且config('database.slow_sql_explain', false)设为true -
$explain是数组，结构同mysqli_fetch_all($result, MYSQLI_ASSOC)，含id、type、key、rows、Extra等字段 - 仅对「成功执行」的 SELECT/UPDATE/DELETE 生效；INSERT IGNORE 或 REPLACE 等语句不触发
- 示例判断是否走了索引：
if (!empty($explain) && !in_array($explain[0]['type'], ['ALL', 'index'])) { /* 走了索引 */ }
useIndex() 和 forceIndex() 怎么影响 EXPLAIN 输出
ThinkPHP 的 useIndex('idx_name') 会生成 USE INDEX (idx_name) 提示，forceIndex('idx_name') 生成 FORCE INDEX (idx_name)。这两者都会反映在 $explain['key'] 字段中，是验证索引是否被采纳的最直接依据。
立即学习“PHP免费学习笔记（深入）”；
-
USE INDEX是建议，优化器仍可能忽略；FORCE INDEX强制使用（除非索引不存在），但可能导致更差性能，慎用于生产 - 若
$explain[0]['key'] === null或为空字符串，说明未命中任何索引，此时应检查字段顺序、NULL 值、函数包裹（如WHERE DATE(created_at) = '2026-04-23'） - 注意
Extra字段：出现Using filesort或Using temporary是典型性能风险信号，和复合索引设计强相关
生产环境别依赖 $explain，改用 MySQL 原生日志
开启 $explain 会增加每次查询的额外开销（至少一次额外的 EXPLAIN 执行），在高并发场景下可能放大延迟。它适合定位单条慢 SQL 的根因，而非长期监控。
- 生产环境应关闭
database.slow_sql_explain，改用 MySQL 的slow_query_log配合long_query_time捕获语句，再人工对重点 SQL 执行EXPLAIN - 不要在日志里直接 dump 整个
$explain数组——体积大、难检索；提取关键字段如type、key、rows、Extra即可 - 如果用了 Swoole，
$explain可能因协程上下文丢失而为空，此时必须回退到原生mysqli::query("EXPLAIN ...")并确保连接未被复用
