performance-optimization

性能优化（Performance Optimization for Rails 8）

概述

性能优化聚焦于以下方面：

N+1 查询检测与预防
查询优化
内存管理
响应时间改进
数据库索引

快速开始

在 Gemfile 中配置：

group :development, :test do
  gem 'bullet'           # N+1 detection
  gem 'rack-mini-profiler' # Request profiling
  gem 'memory_profiler'  # Memory analysis
end

N+1 查询检测与预防

N+1 查询发生在代码先加载一个集合、再为每条关联记录单独发起查询时。Bullet gem 可自动检测此类问题。通过 includes、preload 或 eager_load 进行急切加载即可修复。

急切加载决策表

方法	适用场景
includes	大多数情况（Rails 会选择最佳策略）
preload	强制使用单独查询、大数据集
eager_load	需要在关联上过滤、需要单条查询
joins	仅需过滤，不需要关联数据

关键模式包括：Bullet 配置、急切加载方法、带作用域的急切加载、计数器缓存、带查询计数断言的 N+1 规格测试。

更多代码示例与模式见 references/n-plus-one.md。

查询优化

通过仅选择所需列、对大数据集使用批量处理、选择高效的存在性检查来优化查询。

关键模式

模式	差	好
列选择	User.all.map(&:name)	User.pluck(:name)
大迭代	Event.all.each { ... }	Event.find_each { ... }
存在性检查	.any? / .present?	.exists?
集合大小	.length（加载全部）	.size（智能）

数据库索引

为以下内容添加索引：外键、WHERE/ORDER BY/JOIN 子句中的列、唯一约束。多列查询使用复合索引，过滤子集使用部分索引。

查询分析

使用 Event.where(...).explain(:analyze) 检查查询计划。通过 ActiveSupport::Notifications 设置慢查询日志，捕获超过阈值的查询。

更多代码示例与模式见 references/query-optimization.md。

内存管理与性能分析

使用 memory_profiler 检测内存问题。优先使用 pluck 而非加载完整 ActiveRecord 对象，使用 find_each 进行流式处理，使用 update_all / in_batches 进行批量操作。

Rack Mini Profiler

在开发环境中提供按请求的性能分析。显示查询数、耗时和火焰图（需 stackprof gem）。通过分析器徽章或 ?pp=flamegraph 访问。

更多代码示例与模式见 references/memory-and-profiling.md。

快速修复参考

问题	解决方案
belongs_to 上的 N+1	includes(:association)
has_many 上的 N+1	includes(:association)
慢 COUNT	添加 counter_cache
加载所有列	使用 select 或 pluck
大数据集迭代	使用 find_each
外键缺少索引	在 *_id 列添加索引
慢 WHERE 子句	在过滤列添加索引
加载未使用的关联	从 includes 中移除

性能检查清单

在开发/测试环境启用 Bullet
关键路径中无 N+1 查询
外键均有索引
频繁计数使用计数器缓存
控制器中使用急切加载
大数据集使用批处理
对慢端点进行查询分析

工作流

检测（Detect）—— 启用 Bullet，运行规格测试，检查 Rack Mini Profiler
分析（Analyze）—— 使用 explain(:analyze)、检查慢查询日志、分析内存
修复（Fix）—— 应用参考文件中合适的模式
验证（Verify）—— 重新运行规格测试，确认查询计数，检查性能分析器

参考文件

references/n-plus-one.md —— N+1 检测、急切加载方法、Bullet 配置、计数器缓存、测试模式
references/query-optimization.md —— 列选择、批处理、索引策略、EXPLAIN 分析、慢查询日志
references/memory-and-profiling.md —— 内存分析器用法、内存高效模式、Rack Mini Profiler 设置、部署检查清单

技能介绍