Laravel数据库查询怎么加索引

wen PHP项目 2026-07-10 196

Laravel数据库查询优化：如何高效添加索引（实战指南）

📖 目录导读

索引的核心价值与使用误区
Laravel中创建索引的四种方式
复合索引设计与最佳实践
常见场景索引优化案例
索引监控与性能验证
常见问题问答（FAQ）

索引的核心价值与使用误区

在Laravel项目中,数据库查询性能的瓶颈通常出现在全表扫描，索引就像书籍的目录，能帮助MySQL快速定位数据，避免逐行扫描。

Laravel数据库查询怎么加索引

典型误区：

❌ 对每个字段都加索引 → 降低写入性能，浪费存储
❌ 只在主键加索引 → 复杂查询依然慢
❌ 不关心索引顺序 → 复合索引无效

关键原则：
索引不是越多越好，而是精准命中高频查询的WHERE、JOIN、ORDER BY字段。

Laravel中创建索引的四种方式

迁移文件（最推荐）

// create_users_table.php
Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('email')->unique(); // 唯一索引
    $table->string('status');
    $table->integer('age');
    // 普通索引
    $table->index('status');
    // 复合索引（顺序重要）
    $table->index(['age', 'status']);
});

注意：unique()会自动创建索引，无需重复添加index()。

后期添加索引

// 已有表添加索引
php artisan make:migration add_index_to_users_table
// up()方法
Schema::table('users', function (Blueprint $table) {
    $table->index('created_at');
});

Raw SQL（紧急情况）

ALTER TABLE users ADD INDEX idx_status_created_at (status, created_at);

使用Laravel Scout（全文索引）

// 配置模型
use Laravel\Scout\Searchable;
class Post extends Model {
    use Searchable;
    public function toSearchableArray() { ... }
}
// 自动创建全文索引

性能对比：
迁移文件方式最安全，支持回滚；Raw SQL适合生产环境紧急优化。

复合索引设计与最佳实践

1 最左前缀法则

复合索引 (a, b, c) 实际有效：

✅ WHERE a = 1
✅ WHERE a = 1 AND b = 2
✅ WHERE a = 1 AND b = 2 AND c = 3
❌ WHERE b = 2（跳过a，索引失效）
❌ WHERE a = 1 AND c = 3（跳过b，仅部分生效）

2 索引覆盖（Using index）

避免回表查询,将查询字段全部包含在索引中：

// 表结构：id, name, email, status, created_at
// 创建覆盖索引
$table->index(['status', 'name', 'email']);
// 查询时仅需索引
User::where('status', 'active')
    ->select('name', 'email')
    ->get();

3 索引排序优化

ORDER BY 字段应包含在索引中
ORDER BY 字段顺序需与索引顺序一致
避免 ORDER BY 与 WHERE 字段冲突

常见场景索引优化案例

场景1：用户列表按创建时间排序

优化前：

SELECT * FROM users ORDER BY created_at DESC LIMIT 20;
-- 全表排序，10万行耗时300ms+

优化后：

$table->index('created_at'); 
-- 耗时<5ms

场景2：状态+日期范围查询

优化前：

User::where('status', 'active')
    ->whereBetween('created_at', [$start, $end])
    ->get();

优化后：

$table->index(['status', 'created_at']);
// 先过滤status，再范围筛选created_at

场景3：多条件模糊搜索

避免：

User::where('email', 'like', '%test@example.com%');
// 前面有%会导致索引失效

替代方案：

使用全文索引（FULLTEXT）
使用Elasticsearch等搜索引擎

索引监控与性能验证

1 查看查询是否使用索引

// 在查询前添加
DB::enableQueryLog();
User::where('status', 'active')->get();
$log = DB::getQueryLog();
// 查看日志中的索引信息
// 如果Extra列出现"Using index"说明走索引覆盖
// 出现"Using where"且无"Using index"说明全表扫描

2 使用EXPLAIN分析

EXPLAIN SELECT * FROM users WHERE status = 'active';
-- key列：实际使用的索引名
-- rows列：扫描行数（越小越好）
-- Extra列：出现"Using filesort"或"Using temporary"需优化

3 生产环境监控工具

Laravel Debugbar：开发环境查看索引使用情况
MySQL慢查询日志：SET GLOBAL slow_query_log=ON;
Percona Toolkit：专业索引分析

常见问题问答（FAQ）

Q1：主键默认有索引，为什么查询还是慢？

A：主键索引只能加速“按主键查询”，如果你的查询条件使用WHERE email = 'xx'，必须给email字段单独加索引，主键索引对非主键字段的查询无效。

Q2：复合索引字段顺序如何确定？

A：将区分度最高的字段放在最左边。

gender（只有2种值）区分度低 → 放后面
email（几乎唯一）区分度高 → 放前面
更准确的判断：SELECT COUNT(DISTINCT column)/COUNT(*)，比值越大越应放前面

Q3：添加索引后查询反而变慢？

A：可能原因：

查询条件不符合最左前缀法则 → 索引未被使用
表数据量很小（<1000行） → 全表扫描更快
更新频繁的字段索引 → 写操作开销大
重复或冗余索引 → SHOW INDEX FROM table 检查

Q4：如何删除不必要的索引？

Schema::table('users', function ($table) {
    $table->dropIndex(['age']);           // 普通索引名：表名_字段名_index
    $table->dropUnique(['email']);        // 唯一索引名：表名_字段名_unique
    $table->dropPrimary();                // 主键
});

Q5：Laravel是否自动为外键创建索引？

A：是的，$table->foreign('user_id')->references('id')->on('users') 会自动在user_id字段创建索引，但建议显式添加索引以提高可读性。

索引添加决策树

是否需要加速查询？
├─ 是 → 分析查询条件、排序字段
│       ├─ 单字段查询 → 普通索引
│       ├─ 多字段查询 → 复合索引（区分度最高在前）
│       ├─ 排序需求 → 包含ORDER BY字段
│       └─ 模糊搜索 → 全文索引（中文需分词插件）
├─ 否 → 检查写入性能，考虑删除低效索引
└─ 定期监控 → 使用EXPLAIN验证索引是否命中

最终建议：