索引失效的根本原因是sql中where条件违反数据库索引使用规则，而非thinkphp框架问题；常见诱因包括字段上使用函数、隐式类型转换、join字符集不一致及模糊查询开头等。
ThinkPHP 本身不决定索引是否生效，真正失效的是你写的 SQL 查询语句——数据库优化器看到不符合索引使用规则的 WHERE 条件，直接放弃走索引。问题不在 ThinkPHP 框架，而在你调用 where() 时传入的表达式写法。
WHERE 中对字段用函数或运算导致索引失效
这是最隐蔽也最高频的问题。ThinkPHP 的链式查询看着干净，但一不小心就把函数塞进 where() 里了。
-
where('YEAR(create_time)', '=', 2024)→ MySQL 无法用create_time索引，全表扫描 -
where('UPPER(name)', '=', 'ADMIN')→ 同样失效；应改用name字段原值 +COLLATE utf8mb4_general_ci或确保入库时统一大小写 -
where('id + 1', '=', 101)、where('status', '=', 1)->whereOr('status', '=', 2)（未加括号分组）都可能触发优化器弃用索引
正确做法：把计算逻辑移到 PHP 层，让数据库只做简单比较。
✅ 替换为：where('create_time', '>=', '2024-01-01')->where('create_time', '
LIKE 模糊查询以 % 开头，联合索引没按最左前缀用
ThinkPHP 写 where('name', 'like', '%admin') 很自然，但 MySQL 的 B+ 树索引根本没法从右往左匹配。
- 失效场景：
where('name', 'like', '%abc')、where('mobile', 'like', '%138%') - 能走索引的写法：
where('name', 'like', 'admin%')、where('name', 'like', 'ad%in')（中间通配符可接受，但效率低于前缀） - 联合索引
(status, create_time, user_id)下：where('status', '=', 1)->where('user_id', '=', 100)只能用上status列；where('create_time', '>', '2024-01-01')则完全不走索引
注意：BETWEEN 和 > 是范围查询，它右边的列在联合索引中不再参与查找 —— 这点在 ThinkPHP 链式调用里极易被忽略。
隐式类型转换让索引“视而不见”
ThinkPHP 自动做参数绑定，但类型不一致时，MySQL 仍会悄悄触发隐式转换，索引就废了。
-
where('user_id', '=', 123)→ 若user_id是VARCHAR，MySQL 实际执行CAST(user_id AS SIGNED) = 123，索引失效 -
where('mobile', '=', 13800138000)→ 同样问题，整数会被转成字符串比对，但过程不可控 - JOIN 表字段字符集不同（如
utf8mb4_unicode_civsutf8mb4_general_ci）也会让关联字段索引失效
实操建议：所有字符串字段的查询条件，显式加引号；建表时统一字符集和 collation；用 EXPLAIN 查看 type 是否为 ref 或 range，而不是 ALL。
ThinkPHP 批量操作与唯一校验绕过索引
模型 save() 或 Excel 导入时，如果靠 PHP 层查重再插入，容易漏掉并发写入冲突；但若只依赖数据库唯一索引，又拿不到具体冲突字段提示。
-
unique验证规则不支持多字段，['unique' => 'table,user_id,sku_id']在 ThinkPHP 中无效 - 逐行
where()->count()查重 → 1000 条数据 = 1000 次查询，IO 崩溃 - 用
concat(user_id,"_",sku_id)拼接查重 → 若字段含 NULL，结果为 NULL，整个 IN 查询失效
可靠方案：先用 Db::name()->where('user_id', 'in', $ids)->where('sku_id', 'in', $skus)->select() 批量捞出已存在组合，再用 PHP 做差集；同时必须在数据库加联合唯一索引（如 ALTER TABLE xx ADD UNIQUE uk_user_sku (user_id, sku_id)），否则高并发下必丢数据。
索引是否生效，最终得看 EXPLAIN 输出的 key 和 rows 字段。ThinkPHP 再优雅，也救不了一个写错的 where() 表达式 —— 尤其是带函数、类型混用、模糊开头这三类，最容易在测试环境看不出问题，上线后查慢才暴露。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
