ThinkPHP模型怎么使用复合索引查询_ThinkPHP多字段索引指南【指南】-ThinkPHP-PHP中文网

ThinkPHP模型中复合索引需严格匹配最左前缀原则：where条件顺序必须与索引字段顺序一致，等值条件放前、范围条件放后，排序字段靠后；应使用explain验证执行计划，useIndex仅作提示且不保证生效。

thinkphp模型怎么使用复合索引查询_thinkphp多字段索引指南【指南】

ThinkPHP模型中如何正确使用复合索引查询

复合索引不是“自动生效”的，ThinkPHP模型本身不感知数据库索引结构，where条件是否走复合索引，完全取决于 SQL 生成后能否被 MySQL（或其他数据库）的查询优化器识别。你写了 where(['status' => 1, 'type' => 2])，不代表就一定命中 (status, type) 索引——顺序、范围条件、NULL 值都会让它失效。

为什么 `where` 条件顺序和复合索引字段顺序必须一致

MySQL 的 B+ 树索引是按定义顺序逐列比较的。如果你建了 INDEX idx_status_type (status, type)，那只有以下情况能高效使用该索引：

where status = 1 and type = 2 → ✅ 全匹配，走索引
where status = 1 → ✅ 最左前缀，走索引
where type = 2 → ❌ 没有 status，跳过最左列，索引失效
where status > 1 and type = 2 → ⚠️ status 是范围查询，type 列无法用索引排序/查找，只用到 status

ThinkPHP 的 where 方法不会重排字段顺序，它原样拼 SQL，所以你在 PHP 里写 ->where(['type' => 2, 'status' => 1])，生成的 WHERE 子句仍是 WHERE `type` = 2 AND `status` = 1，依然不满足最左前缀——顺序由数组键的插入顺序决定（PHP 7.4+ 保持插入序），但更稳妥的做法是显式调用链式方法，控制逻辑顺序：

$model->where('status', 1)->where('type', 2)->select(); // 明确先 status 后 type

使用 `useIndex` 强制指定索引但要注意兼容性

ThinkPHP 6.0+ 支持在查询时通过 useIndex 提示优化器使用某个索引，例如：

$model->useIndex('idx_status_type')->where('status', 1)->where('type', 2)->select();

但它只是 SQL 中的 USE INDEX (idx_status_type) 提示，并不保证生效，且存在几个现实限制：

仅对 MySQL 有效，SQLite、PostgreSQL 不支持该语法，会报错
如果提示的索引根本不存在，或字段类型不匹配（比如索引是 (status, category_id)，你却用了 type 字段），查询仍会失败或退化为全表扫描
TP 不校验索引定义，写错名字也不会报 warning，只能靠 explain 验证

真正验证是否走索引，一定要在开发环境执行 EXPLAIN 查看执行计划，而不是只看 PHP 层有没有报错。

复合索引字段顺序怎么定：高频等值 + 低频范围 + 排序字段靠后

别凭感觉排，按实际查询模式来。例如常见场景：

查「启用中的文章」且「分类 ID 为 X」→ status 和 category_id 都是等值，选区分度更高的放前面（如 category_id 取值多，status 只有 0/1，优先放 category_id）
查「某天之后的已发布订单」→ status = 1（等值） + create_time > '2024-01-01'（范围），必须把 status 放前面，否则范围之后的字段索引失效
查「用户按注册时间倒序分页」→ 如果经常 where is_deleted = 0 order by create_time desc，那就建 (is_deleted, create_time)，让排序也能利用索引避免 filesort

一个容易被忽略的点：ThinkPHP 的 order 和 limit 不影响索引选择，但会影响是否触发索引覆盖或排序优化。如果复合索引包含了 SELECT 中的所有字段（比如 SELECT id, status, type FROM table，而索引是 (status, type, id)），MySQL 可能直接走索引树不回表——这点 TP 完全不参与，纯数据库行为。