IndexHint 在 Laravel 中并非强制指定索引的手段,仅少数数据库驱动支持,真正生效依赖迁移中正确创建索引及数据库优化器选择;应通过 EXPLAIN 分析执行计划、合理设计复合索引、克制高频写入表索引,并优先考虑缓存优化重复查询。

IndexHint 是 Laravel 提供的底层机制,但它**不等于“手动指定用哪个索引”**,更不是 MySQL 的 USE INDEX 语法代理。它只在极少数驱动(如 SQL Server)中被实际解析,MySQL 和 PostgreSQL 驱动里基本被忽略。别指望靠它强制走某个索引。
真正起作用的,是你在迁移里建的索引 + 数据库优化器自动选择。下面说清楚怎么让索引真正生效。
WHERE 条件字段没索引?先看执行计划
遇到慢查询,别急着加 IndexHint。先确认数据库到底有没有走索引:
- 用
DB::enableQueryLog()+DB::getQueryLog()拿到原始 SQL - 在 MySQL 客户端或 phpMyAdmin 中执行
EXPLAIN SELECT ... - 重点看
type列:要是ALL,说明全表扫描;ref或range才算走了索引
如果 EXPLAIN 显示没走索引,那问题一定出在索引缺失、字段类型不匹配(比如 varchar 字段查时用了整数)、或 WHERE 条件用了函数(WHERE YEAR(created_at) = 2025 会失效)。
Laravel 迁移中加索引的实操要点
索引必须通过迁移落地,不能只靠模型注释或运行时提示:
- 单字段索引:
$table->index('email'),适合WHERE email = ? - 复合索引:
$table->index(['status', 'created_at']),注意顺序——高区分度字段(如status只有 3 个值)放前面效果差,应优先放created_at再补status - 外键字段必须显式加索引:
$table->foreignId('user_id')->constrained()->index(),Laravel 不自动加 - 唯一约束自带索引:
$table->unique('token'),不用再额外index('token')
加完记得跑 php artisan migrate,否则只是纸上谈兵。
通知表、日志表这些高频写入表,索引要克制
像 notifications 表,默认只有主键,但如果你频繁调用 $user->unreadNotifications,就会卡在 notifiable_id + notifiable_type 上:
- 必须加联合索引:
$table->index(['notifiable_id', 'notifiable_type']) - 但别给
read_at单独建索引——它基数低,且写入时维护成本高 - 如果表数据超 100 万行,考虑分区或归档旧数据,索引救不了设计缺陷
索引不是银弹。它加速读,拖慢写;对小表几乎没用;对 LIKE '%xxx' 或 JSON 字段模糊查询也基本无效。
缓存比索引更常是正确答案
如果你的接口响应慢是因为反复查同一组数据(比如首页 banner、用户权限树),加索引不如直接缓存:
Cache::remember('homepage_banners', 3600, fn() => Banner::active()->get())- 配合模型事件自动清除:
Banner::updated(fn() => Cache::forget('homepage_banners')) - 缓存命中率 >95% 时,数据库压根不参与查询,索引也就无从谈起
索引是数据库层的优化手段,而缓存是应用层的降级策略。很多所谓“慢查询”,本质是重复请求不该重复查的东西。先想清楚要不要查,再决定怎么查。


















