laravel-mongodb查询优化步骤：系统优化方法论
项目地址: https://gitcode.com/gh_mirrors/la/laravel-mongodb 一、查询分析与诊断
1.1 启用查询日志
通过enableQueryLog()方法开启查询日志，记录所有MongoDB操作，便于识别慢查询。日志包含执行时间、查询语句等关键信息，可通过getQueryLog()获取。
DB::enableQueryLog();
Movie::where('title', 'Carrie')->get();
dd(DB::getQueryLog());
相关文档：docs/fundamentals/read-operations/query-logging.txt
1.2 分析执行计划
使用MongoDB的explain()方法获取查询执行计划，分析索引使用情况、扫描文档数等指标，定位性能瓶颈。
$executionPlan = Movie::where('imdb.rating', '>', 8.5)->explain();
二、索引优化策略
2.1 创建基础索引
针对频繁查询的字段创建单字段索引，如title或year，提升过滤效率。通过Schema构建器的index()方法定义索引。
Schema::create('movies', function (Blueprint $collection) {
$collection->index('title');
$collection->index('year');
});
2.2 复合索引设计
对多字段组合查询创建复合索引，注意字段顺序（选择性高的字段前置）。例如，查询year和imdb.rating时，创建year_1_imdb.rating_1复合索引。
$collection->index(['year' => 1, 'imdb.rating' => 1]);
2.3 特殊类型索引
- 地理空间索引：用于位置查询，如
2dsphere索引支持地理坐标过滤。 - 文本索引：优化全文搜索，通过
searchIndex()方法创建。 - TTL索引：自动过期文档，适用于日志等临时数据。
// 地理空间索引
$collection->geospatial('location', '2dsphere');
// TTL索引（3600秒后过期）
$collection->expire('created_at', 3600);
三、查询语句优化
3.1 限制返回字段
使用select()或project()方法仅返回必要字段，减少数据传输量和内存占用。
Movie::select('title', 'year')->where('year', 2010)->get();
相关文档：docs/fundamentals/read-operations/retrieve.txt
3.2 优化分页与排序
通过skip()和take()实现分页，避免全表扫描。排序时确保使用索引字段，如按year排序需创建对应索引。
$movies = Movie::orderBy('year', 'desc')->skip(20)->take(10)->get();
相关文档：docs/fundamentals/read-operations/modify-results.txt
3.3 避免全表扫描
确保查询条件使用索引字段，避免$where、$regex前缀匹配等低效操作。例如，将like '%Spider%'改为文本索引查询。
// 低效
Movie::where('title', 'like', '%Spider%')->get();
// 高效（需文本索引）
Movie::whereText('title', 'Spider')->get();
四、高级优化技巧
4.1 读写分离
通过readPreference()方法设置读取偏好，将查询路由到从节点，减轻主节点压力。支持primaryPreferred、secondary等模式。
Movie::readPreference(ReadPreference::SECONDARY_PREFERRED)->get();
相关文档：docs/fundamentals/read-operations/read-pref.txt
4.2 聚合查询优化
使用聚合管道时，优先通过$match过滤数据，减少后续阶段处理量。利用$project限制字段，$skip和$limit控制结果集大小。
$pipeline = [
['$match' => ['year' => ['$gte' => 2000]]],
['$group' => ['_id' => '$year', 'count' => ['$sum' => 1]]],
['$sort' => ['_id' => 1]]
];
$results = Movie::aggregate($pipeline);
4.3 缓存查询结果
对高频访问且变化少的数据，使用Laravel缓存系统缓存查询结果，减少数据库访问。
$topMovies = Cache::remember('top_rated_movies', 3600, function () {
return Movie::where('imdb.rating', '>', 8.5)->get();
});
五、监控与持续优化
5.1 实时监控工具
结合MongoDB Atlas监控面板或第三方工具（如Prometheus），实时跟踪查询性能指标（如平均响应时间、索引命中率）。
5.2 定期索引维护
删除冗余索引，重建碎片化索引。通过getIndexes()检查现有索引，使用dropIndexIfExists()移除无用索引。
if ($collection->hasIndex('old_index')) {
$collection->dropIndex('old_index');
}
六、优化效果验证
通过对比优化前后的查询执行时间、扫描文档数等指标，验证优化效果。例如，某查询优化后执行时间从500ms降至50ms，扫描文档数从10万减至100。
// 优化前
Movie::where('year', 2010)->where('imdb.rating', '>', 8.5)->get(); // 500ms
// 优化后（添加复合索引）
Movie::where('year', 2010)->where('imdb.rating', '>', 8.5)->get(); // 50ms
总结
laravel-mongodb查询优化需结合索引设计、查询重构、读写策略等多维度措施。通过系统诊断、针对性优化和持续监控，可显著提升MongoDB在Laravel应用中的性能。核心在于理解数据访问模式，合理利用索引和MongoDB特性，平衡查询效率与资源消耗。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
