罗罗编程学习记录
本页内容 展开查看

06.5.4.7 Eloquent 查询优化与 N+1 治理

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.4 Laravel

覆盖范围

  • N+1 成因、检测与预加载取舍
  • lazy/chunk/chunkById/cursor 内存模型
  • whereHas 子查询成本、模型事件开销
  • 查询日志、慢查询定位与批量写入

基础 N+1 与延迟加载概念见 06.5.1.3 Eloquent ORM 与事务;本页聚焦优化治理纵深。

06.5.4.7-001 N+1 查询在代码层面如何形成?

一句话结论

先查出 N 条主模型,循环内每条再访问未预加载的关联,触发 N 次独立查询;主查询 1 次加关联查询 N 次,随列表规模线性放大。

概念解释

延迟加载在首次访问关联时按当前模型 ID 查询。外层集合越大,循环内关联查询次数越多。典型代码:foreach ($users as $u) { $u->posts; } 且未 with('posts')。

原理流程

  1. 主查询取出 N 条模型集合。
  2. 循环访问 $model->relation,关联未加载。
  3. 按当前模型 ID 发起一次关联查询。
  4. 每条重复一次,共 N 次关联 SQL。

代码或图示

// 风险:循环内触发延迟加载
$users = User::all();
foreach ($users as $user) {
    echo $user->posts->count(); // 每条一次 select ... where user_id = ?
}

常见误区

  • 只有循环才会 N+1:集合 map/filter/视图模板内访问未加载关联同样触发。
  • 以为关联被序列化时才查询:访问属性即触发,与输出方式无关。

追问

  • 嵌套关联会叠加 N+1 吗?答:会,第二层关联在第一层结果上再展开,查询次数按层级放大。
  • 如何静态发现?答:代码评审检索循环内关联访问;测试环境开启查询日志统计条数,部分扩展包可检测延迟加载告警。

06.5.4.7-002 如何用查询日志定位 N+1 与重复 SQL?

一句话结论

开启数据库查询日志后执行目标请求,导出日志按 SQL 文本与绑定参数聚合,识别“同一关联查询按 ID 重复 N 次”的模式,定位触发代码位置。

概念解释

查询日志记录每条 SQL 与绑定参数。N+1 特征是相同 SQL 模板反复出现、仅主键参数不同。结合调试工具(如开发期查询面板)可关联到控制器/视图调用点。

原理流程

  1. 请求前 DB::enableQueryLog(),结束后 DB::getQueryLog()。
  2. 按规范化 SQL 模板分组统计次数。
  3. 重复次数等于集合规模的模板即为 N+1 嫌疑。
  4. 回溯代码访问点,补充预加载。

代码或图示

DB::enableQueryLog();
$users = User::with('posts')->get();
$log = DB::getQueryLog();

$duplicates = collect($log)->groupBy('query')->filter(fn ($q) => $q->count() > 1);

常见误区

  • 只看总 SQL 条数不看重复模板:偶发重复与 N+1 的区别在于是否随列表规模线性增长。
  • 生产环境长期开启查询日志:日志写入成本与体积高,仅在排查窗口使用。

追问

  • 队列任务如何采集查询日志?答:任务执行前后开关日志并落盘记录;任务批量处理时关注单任务 SQL 总量。
  • 查询日志包含绑定参数吗?答:日志条目含 query 与 bindings 字段;敏感参数需按项目日志规范脱敏。

06.5.4.7-003 预加载 with 与延迟加载如何取舍?

一句话结论

列表/批量场景且关联数据会被访问时用预加载,以少量批量查询替代 N 次单查;单条详情、关联未必访问、预加载条件复杂时保留延迟加载,避免无谓加载大集合。

概念解释

预加载成本是固定的批量查询 + 内存持有关联集合;延迟加载成本是按需单查。判断标准:数据是否会被访问、访问规模、关联体积与内存承受度。

原理流程

  1. 评估当前接口是否遍历集合并访问关联。
  2. 会访问且规模大:with 批量预加载。
  3. 单条记录或关联可选:延迟加载即可。
  4. 预加载大关联时用约束闭包缩窄列与条件。

代码或图示

// 列表:预加载
$users = User::with('posts:id,user_id,title')->get();

// 详情:按需加载
$user = User::find($id);
$profile = $user->profile; // 仅在需要时查询

常见误区

  • 全量 with 所有关联:未访问的关联也被批量查出,内存与 SQL 成本浪费。
  • 详情接口也预加载重关联:单条场景延迟加载一次的成本更低。

追问

  • 预加载后内存超限怎么办?答:缩小 select 列、加约束条件,或改用 lazy/chunk 分批处理。
  • 如何判断关联是否被访问?答:结合模板/资源字段清单;未出现在输出中的关联不要预加载。

06.5.4.7-004 lazy() 与 chunk() 的内存行为差异是什么?

一句话结论

chunk 按页查询并把整页模型集合载入内存回调处理;lazy 生成游标式生成器,内部按块读取但逐条产出,内存占用接近单条+块缓冲,适合超大结果集流式处理。

概念解释

两者都避免一次性加载全表。chunk 回调内处理完整页;lazy 返回 Generator,遍历时才按需取下一块。数据需要整批集合操作时用 chunk,逐条流水处理用 lazy。

原理流程

  1. chunk:按 ID/页数取一页,回调处理整页,再取下一页。
  2. lazy:创建生成器,内部按块缓冲,逐条 yield 模型。
  3. 处理完一条释放引用,内存不累积全量。
  4. 数据库连接在迭代期间保持。

代码或图示

User::lazy(1000)->each(function (User $user) {
    // 逐条处理,内存接近单条
});

User::chunk(1000, function ($users) {
    // 整页集合在回调内处理
});

常见误区

  • 用 chunk 回调内持有整页集合做全局聚合:整页对象驻留内存,批量聚合应走数据库聚合查询。
  • lazy 生成器中途 break:后续块不再读取,连接随生成器回收。

追问

  • lazy 底层如何取数?答:按块查询并缓冲结果逐条产出;块大小参数控制每批 SQL 行数,具体实现以版本源码为准。
  • 两者都受软删除/全局作用域影响吗?答:是,查询构造器上的作用域条件同样生效。

06.5.4.7-005 chunkById 为什么避免 chunk 翻页丢数据?

一句话结论

chunkById 按主键游标推进(记住最后一条 ID,下一页 where id > 上次ID),避免普通 chunk 按 offset 翻页时,页内数据被修改导致记录漏读或重复。

概念解释

普通 chunk 基于偏移量分页,处理过程中若有插入/删除/排序字段变更,下一页偏移错位。chunkById 用稳定主键范围推进,快照语义更可靠;前提是主键有序且不可变。

原理流程

  1. 按主键升序取第一块。
  2. 记录块内最后一条主键。
  3. 下一页条件为 id > 上次ID 继续取块。
  4. 处理期间数据变更不影响游标位置。

代码或图示

User::chunkById(1000, function ($users) {
    foreach ($users as $user) {
        // 按主键游标翻页
    }
}, 'id');

常见误区

  • 表无自增有序主键却用 chunkById:游标条件无法稳定推进,需选择唯一有序列。
  • 处理中修改主键列:游标依据被改动,可能跳过记录。

追问

  • chunkById 与 lazy 关系?答:lazy 内部按块游标读取;chunkById 是显式分页回调形式,两者都避免 offset 深翻页。
  • 多条件过滤时游标如何稳定?答:排序与过滤条件固定,主键作为次序兜底;复杂排序建议核对分页一致性。

06.5.4.7-006 cursor() 与 lazy() 的底层游标实现差异是什么?

一句话结论

cursor() 用底层数据集游标逐行读取,不把整批模型集合缓存到 PHP 内存;lazy() 按块查询缓冲后逐条产出,两者都流式处理,cursor 更接近数据库驱动游标,lazy 以块为单位往返。

概念解释

cursor 遍历 PDO 结果集逐行实例化模型;lazy 分批 SQL 取数再生成器输出。数据量极大、每行轻量时 cursor 往返少;需要按块批量加载关联时 lazy 更灵活。

原理流程

  1. cursor:执行查询,驱动结果集逐行 fetch。
  2. 每行实例化为模型并产出。
  3. lazy:按块执行 SQL,缓冲块内结果逐条 yield。
  4. 两者都不把全表集合放入内存。

代码或图示

foreach (User::where('active', true)->cursor() as $user) {
    // 逐行读取结果集游标
}

foreach (User::lazy(500) as $user) {
    // 按块缓冲逐条产出
}

常见误区

  • 把 cursor 结果 collect 成集合:流式优势丧失,全量载入内存。
  • cursor 内触发延迟加载关联:每行一次关联查询,回到 N+1 模式。

追问

  • cursor 占用什么服务端资源?答:数据库侧持有结果集/临时表,长游标期间连接不释放;需评估数据库负载。
  • 两者如何选?答:单条轻量、无关联加载优先 cursor;需要块级预加载或批处理逻辑用 lazy。

06.5.4.7-007 each() 与 lazy() / chunk() 的关系是什么?

一句话结论

each 是基于 lazy 集合的逐条遍历封装,内部生成器按块读取并对每条执行回调;chunk 是整页回调,lazy 返回可迭代对象,each 在其上提供方法式遍历入口。

概念解释

集合方法链中 each 消费 lazy 结果;回调签名接收单条模型。底层仍走流式读取,不会先加载全量集合。需要返回映射结果时用 map 配合 lazy。

原理流程

  1. 查询构造器调用 lazy($chunkSize) 取得生成器集合。
  2. each 遍历生成器,逐条调用回调。
  3. 块内结果用完后取下一块。
  4. 回调内不持有跨条引用,内存可控。

代码或图示

User::query()->lazy(1000)->each(function (User $user) {
    $user->notify(new WelcomeMessage());
});

常见误区

  • 在 each 回调内累积全量结果到数组:等于把流式数据又收集成全量,内存回升。
  • 把 each 当成数据库批量更新:逐条仍产生单条写入/通知,批量场景应改集合 SQL。

追问

  • each 与 chunk 回调性能差异?答:遍历模型一致,差异在块缓冲与回调粒度;以实际 SQL 次数和内存为准。
  • 中断遍历如何停止?答:回调返回 false 可终止 each(具体约定以集合源码为准);生成器 break 同样停止后续读取。

06.5.4.7-008 whereHas 子查询的成本如何评估与改写?

一句话结论

whereHas 生成关联存在性子查询,随主表行数与关联索引情况可能成本较高;能转 inner join、预加载计数或数据库索引覆盖时,改写可降低执行成本。

概念解释

存在性子查询对每条主记录校验关联是否存在。关联表缺索引、子查询无法复用主表索引时,容易出现相关子查询反复执行。评估方式是 toSql 看结构、explain 看执行计划。

原理流程

  1. 写出 whereHas 条件并 toSql() 检查子查询结构。
  2. explain 查看是否走索引、是否相关子查询。
  3. 能 join 表达的条件改写为 join/where 连接条件。
  4. 仅需计数时用 withCount 替代存在性判断。

代码或图示

// 存在性过滤
$posts = Post::whereHas('comments', fn ($q) => $q->where('approved', true))->get();

// 改写思路:join 关联表按主表去重(结构按实际表设计)
$posts = Post::join('comments', 'comments.post_id', '=', 'posts.id')
    ->where('comments.approved', true)->distinct()->get();

常见误区

  • 多层嵌套 whereHas:子查询层级深,优化器难以展开,需逐层核对计划。
  • 为 whereHas 关联字段不加索引:子查询过滤回表成本高。

追问

  • whereHas 与预加载冲突吗?答:不冲突,但过滤主模型用 whereHas,加载关联用 with,两者分别生成子查询与批量查询。
  • 大数据量下优先优化什么?答:先核对关联外键与过滤字段索引,再评估 join 改写;不要先改业务结构。

06.5.4.7-009 模型事件与观察者在大批量写入时有什么开销?

一句话结论

每条模型 save/delete 都会触发模型事件钩子与观察者方法,批量逐条写入时事件回调逐条执行,累积为可观 CPU 与 IO 成本;事件内若再查询/发通知会进一步放大。

概念解释

模型事件(creating/created/saving/saved/updating/updated/deleting/deleted 等)在持久化前后触发。批量导入场景逐条触发观察者,回调内的日志、通知、额外查询都会按行数放大。

原理流程

  1. 逐条 save 触发 saving/creating/created 等钩子。
  2. 观察者对应方法逐条执行。
  3. 钩子内查询、发消息、写日志按行数叠加。
  4. 大批量导入时事件开销可能超过数据库写入本身。

代码或图示

// 观察者示例:每条保存后触发
class PostObserver
{
    public function created(Post $post): void
    {
        // 逐条执行:索引更新、通知、搜索同步
    }
}

常见误区

  • 以为事件只在显式注册时触发:模型 booted 内闭包钩子同样逐条运行。
  • 事件钩子内做远程调用:批量任务被网络往返拖垮,应改队列异步。

追问

  • 如何统计事件开销?答:对比关闭事件前后的批量任务耗时;在观察者方法内打点记录执行次数与耗时。
  • 事件能批量订阅吗?答:模型事件按单条生命周期触发;批量语义需在业务层批量处理后统一通知,不依赖逐条钩子。

06.5.4.7-010 withoutEvents 批量操作时如何关闭模型事件?

一句话结论

Model::withoutEvents(Closure) 在闭包执行期间临时移除模型事件监听器,用于批量导入/修复脚本中跳过钩子副作用,执行结束后恢复注册;需确认业务确实不需要事件触发。

概念解释

关闭事件绕过观察者与钩子,适合纯数据搬运场景。风险是本该执行的业务副作用(通知、索引、关联清理)被跳过,需在脚本外补做或确认无此需求。

原理流程

  1. 保存当前事件监听器快照。
  2. 闭包内执行批量模型操作,不触发钩子。
  3. 操作结束恢复原监听器注册。
  4. 脚本记录跳过的事件类型,便于事后核对。

代码或图示

Post::withoutEvents(function () use ($rows) {
    foreach ($rows as $row) {
        Post::create($row); // 不触发 created/created 钩子
    }
});

常见误区

  • 对业务在线请求关闭事件:用户操作应触发完整生命周期副作用,不能为性能绕过。
  • 关闭事件后不补关联清理:子记录、缓存、搜索索引可能残留不一致。

追问

  • 关闭事件影响数据库事务吗?答:不影响事务与约束,只跳过 PHP 层钩子回调。
  • 如何只关闭某类事件?答:框架提供的批量移除粒度以源码为准;通用做法是在观察者方法内按环境/标志位跳过,而非全局关闭。

06.5.4.7-011 select 指定列与全列读取的成本差异?

一句话结论

只取必要列减少网络传输、 hydration 内存与序列化体积;select 需保留主键与关联回填、访问器依赖的列,否则关联组装或属性取值缺失。

概念解释

Eloquent 默认 select *,宽表模型字段多、文本列大时全列读取成本显著。缩窄列对列表接口收益明显,但要核对模板/资源/访问器实际用到的字段。

原理流程

  1. 梳理输出与业务逻辑所需字段清单。
  2. 查询构造器 select(...) 指定列。
  3. 保留主键、外键、访问器依赖列。
  4. hydration 后仅持有声明列的属性。

代码或图示

$posts = Post::select('id', 'user_id', 'title', 'created_at')
    ->where('published', true)->get();

常见误区

  • select 漏掉关联外键:预加载回填失败,关联为空。
  • 访问器依赖未加载列:取值为 null 或触发额外查询,需把依赖列加入 select。

追问

  • 关联预加载也能 select 吗?答:在 with 约束闭包内 select,规则相同,保留两侧键。
  • 全列读取对 OPcache 有影响吗?答:内存差异主要在模型 hydration 与数据传输,与脚本 opcode 缓存无关。

06.5.4.7-012 索引如何配合 Eloquent 查询条件设计?

一句话结论

where 等值/排序/关联外键字段应建匹配索引;Eloquent 生成的 SQL 条件顺序与索引命中以执行计划为准,不能只看代码里的 where 顺序。

概念解释

索引设计围绕查询模式:过滤字段、排序字段、关联键、分页游标。复合索引遵循最左前缀;列表分页深偏移需配合游标或覆盖索引。

原理流程

  1. 收集接口查询条件与排序方式。
  2. 为等值过滤、排序、外键设计单列/复合索引。
  3. 用 explain 核对命中索引与回表行数。
  4. 慢查询按计划补索引或改写条件。

代码或图示

// 常见查询:按租户状态取最新列表
$posts = Post::where('tenant_id', $tid)
    ->where('status', 'published')
    ->orderBy('published_at', 'desc')
    ->limit(20)->get();

// 对应思路:复合索引 (tenant_id, status, published_at)

常见误区

  • 给每个字段单独建索引:复合前缀缺失时组合条件仍走不到合适索引,且写入成本上升。
  • 只在代码层优化不加索引:SQL 结构合理但计划全表扫描,瓶颈仍在数据库。

追问

  • 关联查询用什么索引?答:子表外键索引保证按父 ID 批量取关联;父表过滤索引决定主查询扫描范围。
  • 索引过多有什么副作用?答:写入维护成本上升、优化器选择变差,需按实际查询负载取舍。

06.5.4.7-013 toSql / explain 如何核对生成 SQL 与执行计划?

一句话结论

toSql()(绑定参数另行查看)输出规范化 SQL 结构,explain 查看访问类型、索引命中、扫描行数与排序方式;两者结合判断是 SQL 写法问题还是索引问题。

概念解释

代码层链式条件最终落到 SQL。先看 toSql 确认条件/子查询/join 是否符合预期,再用数据库 explain 核对计划。绑定参数不在 toSql 字符串内,需结合 bindings 查看。

原理流程

  1. 查询构造器调用 toSql() 读取 SQL 文本。
  2. 检查 where、join、子查询、order by 结构。
  3. 在数据库对等价 SQL 执行 explain。
  4. 对照 type、key、rows、Extra 定位全表扫描/临时表/ filesort。

代码或图示

$query = Post::whereHas('comments', fn ($q) => $q->approved())
    ->where('status', 'published');

echo $query->toSql();
// 等价 SQL 到数据库执行:EXPLAIN SELECT ...

常见误区

  • 只看 SQL 文本不看计划:写法简单也可能缺索引导致全表扫描。
  • explain 只看 key 列:rows 估算与 Extra 中的 filesort/临时表同样关键。

追问

  • toSql 如何带绑定参数?答:构造器提供 bindings 读取入口;调试时按顺序把参数代入 SQL。
  • 慢查询与数据量有关吗?答:索引缺失在小表表现不明显,生产数据量放大后才暴露,需按生产量级评估计划。

06.5.4.7-014 已加载关联如何避免重复查询(relation loaded 判断)?

一句话结论

访问关联前用 relationLoaded 判断是否已加载;已加载直接读属性缓存,未加载再按需 load,避免循环内重复触发相同关联查询。

概念解释

模型实例缓存已加载关联。代码中条件化加载时,显式判断可防止重复 load 覆盖缓存,也便于在集合层统一补加载。

原理流程

  1. 遍历模型集合,检查 relationLoaded('posts')。
  2. 已加载:读取 $model->posts 内存结果。
  3. 未加载:调用 load('posts') 批量补加载。
  4. 后续访问不再触发 SQL。

代码或图示

if (! $user->relationLoaded('posts')) {
    $user->load('posts');
}
foreach ($user->posts as $post) {
    // 复用缓存
}

常见误区

  • 每次访问都 load:重复查询并覆盖已加载结果。
  • 集合内逐个 load:应按集合批量 load 一次,避免回到 N+1。

追问

  • 如何判断一批模型哪些缺关联?答:遍历检查 relationLoaded,收集缺失实例后统一 load;框架也提供批量预加载入口。
  • 模型 fresh 后关联缓存还在吗?答:fresh 重新加载模型,关联属性重置,需重新预加载。

06.5.4.7-015 大列表分页深偏移(offset)有什么性能问题与替代方案?

一句话结论

offset 深翻页要扫描并跳过前 N 行,偏移越大扫描成本越高;替代方案是主键/游标分页(where id > 上次ID 取 N 条),保持稳定索引范围扫描。

概念解释

LIMIT offset, N 中数据库先定位 offset 位置再取 N 条,深偏移伴随大量回表与丢弃。游标分页用上一页最后一条的有序字段作为条件,避免跳过扫描。

原理流程

  1. 传统分页:page 增大时 offset 增大,扫描行数累积。
  2. 游标分页:记录最后一条排序字段值。
  3. 下一页条件 排序字段 < 上页值(配合主键兜底)。
  4. 索引直接定位范围,不取跳过行。

代码或图示

// 游标思路:基于最后一条 ID/时间
$next = Post::where('id', '<', $lastId)
    ->orderByDesc('id')
    ->limit(20)->get();

常见误区

  • 排序字段不唯一导致游标重复/遗漏:需加主键作为次级排序键保证稳定次序。
  • 数据集实时变化时游标漂移:翻页期间新增记录可能造成重复/跳过,按业务接受度处理。

追问

  • 后台管理还能用 offset 分页吗?答:浅页可接受;深翻页或对外开放接口建议游标分页。
  • 游标分页如何跳转到指定页?答:游标分页不支持随机跳页;需要页码语义时权衡 offset 成本与业务需求。

06.5.4.7-016 批量插入 insert / insertOrIgnore 与逐条 save 的差异?

一句话结论

批量 insert 一次 SQL 写入多行,绕开逐条模型事件与 hydration,写入成本低;逐条 save 触发模型事件、类型转换与单条 SQL,适合需要生命周期钩子的业务记录。

概念解释

查询构造器批量插入不经过 Eloquent 模型事件,不填充访问器;insertOrIgnore 忽略唯一键冲突错误。需要模型副作用时逐条 save 或分批模型创建。

原理流程

  1. 准备多行数组数据。
  2. 构造器 insert 拼接多行 values 一次执行。
  3. 冲突场景用 insertOrIgnore 跳过重复行。
  4. 需要钩子的记录逐条模型保存,事件逐条触发。

代码或图示

// 批量写入(无模型事件)
Post::insert([
    ['title' => 'A', 'created_at' => now()],
    ['title' => 'B', 'created_at' => now()],
]);

// 逐条模型保存(触发事件)
foreach ($rows as $row) {
    Post::create($row);
}

常见误区

  • 批量 insert 依赖时间戳自动填充:构造器不写 created_at/updated_at,需手动赋值。
  • 用 insertOrIgnore 掩盖唯一键冲突:业务上应判断重复来源,避免静默丢数据。

追问

  • 批量插入大小有限制吗?答:受 SQL 数据包大小与参数数量限制,超大批量应分批;具体阈值按数据库配置核对。
  • 批量插入后如何拿到自增 ID?答:单条 insert 返回最后插入 ID;多行批量取回各 ID 需按表设计分批或补充查询。

06.5.4.7-017 子查询选取关联字段如何替代 withCount?

一句话结论

需要在主查询直接取关联聚合值时,可用 select 子查询(如 (select count(*) from ...))生成派生列;withCount 是其 Eloquent 封装,复杂聚合条件下手写子查询更灵活。

概念解释

withCount 生成标准 count 子查询;当聚合需要 sum/max/条件过滤时,手写 select 子查询可直接取关联聚合值,避免再关联一次查询。子查询需注意相关条件与索引命中。

原理流程

  1. 主查询 select 中追加子查询表达式。
  2. 子查询按当前主表 ID 关联过滤并聚合。
  3. 结果列映射到模型属性。
  4. 配合索引降低子查询成本。

代码或图示

$posts = Post::select('posts.*')
    ->selectSub(
        Comment::whereColumn('comments.post_id', 'posts.id')
            ->where('approved', true)->selectRaw('count(*)'),
        'approved_comments_count'
    )->get();

常见误区

  • 子查询相关条件漏关联主表 ID:聚合全表而非当前记录。
  • 派生列未在模型可见范围:序列化时取不到属性,需补充 append/visible。

追问

  • 子查询与 join 聚合哪个好?答:一对多 join 会放大主表行数,聚合需 group by;计数子查询不放大主表,通常更稳妥。
  • withCount 能满足就不要手写吗?答:框架封装自动处理关联键映射,条件简单时优先 withCount。

06.5.4.7-018 数据库连接与查询超时在批量任务中注意什么?

一句话结论

批量任务长事务、长游标会占用连接与锁;需控制单批大小、及时提交事务、设置合理查询超时,避免连接长时间被占导致池耗尽或锁等待。

概念解释

队列/脚本批处理不同于 Web 请求:执行时间长、持连接久。连接池大小、事务边界、锁等待、语句超时都需按任务量评估,防止大批量操作阻塞在线业务。

原理流程

  1. 评估任务总量与单批处理时长。
  2. 分批提交,避免单一大事务长期持锁。
  3. 核对数据库连接超时与语句超时配置。
  4. 监控连接占用与慢查询,必要时限流并发。

代码或图示

User::chunkById(500, function ($users) {
    DB::transaction(function () use ($users) {
        // 批内更新
    });
});

常见误区

  • 整个批量任务包在一个事务里:锁持有时间长,回滚代价大。
  • 游标遍历期间连接不释放:长结果集占用连接,需控制并发任务数。

追问

  • 批量任务连接从哪来?答:队列 worker 使用数据库连接池配置;常驻进程连接复用需处理断连重连。
  • 超时配置在哪里核对?答:数据库连接配置与数据库服务端超时参数;具体键名按项目配置与驱动文档确认。

06.5.4.7-019 缓存查询结果与模型实例复用的边界是什么?

一句话结论

可缓存的是派生数据(聚合结果、视图快照),模型实例不建议长期缓存:实例携带关联、事件回调与运行时状态,序列化/反序列化后行为可能偏离,且数据易过期。

概念解释

缓存模型本体容易导致脏数据与状态不一致;正确做法是缓存标量/数组 DTO 或聚合值,需要模型时按 ID 重新查询。模型单例只在容器请求作用域内复用,不跨请求持久化。

原理流程

  1. 区分可缓存数据:聚合值、配置快照、只读展示 DTO。
  2. 缓存层存数组/标量,不存模型对象。
  3. 失效后重新查询模型组装。
  4. 模型实例复用限定在单次请求/作用域内。

代码或图示

$stats = Cache::remember("post:{$id}:stats", 300, function () use ($id) {
    return Post::where('id', $id)->withCount('comments')->first()?->toArray();
});

常见误区

  • 把模型集合序列化进缓存:关联未加载、hidden 规则与事件状态随序列化丢失。
  • 缓存模型后不失效:数据更新后缓存返回旧对象,造成一致性问题。

追问

  • 模型缓存有官方机制吗?答:部分缓存包支持模型缓存,但需关注失效策略;业务项目优先缓存 DTO 更可控。
  • 请求内模型实例能复用吗?答:同一请求内容器/查询结果自然复用,跨请求复用需经缓存并处理失效。

06.5.4.7-020 如何固化一条慢查询的排查步骤(日志 → SQL → 计划 → 索引)?

一句话结论

固定流程:采集查询日志定位慢 SQL 与触发代码 → toSql 核对条件结构与绑定参数 → explain 分析访问路径与扫描行数 → 补索引或改写 → 复测对比耗时与计划。

概念解释

排查顺序从现象到根因:先确认是哪条 SQL、在哪触发,再判断写法与计划问题,最后落到索引/改写优化。每步留证据,避免凭直觉改代码。

原理流程

  1. 日志/慢查询记录提取 SQL、耗时、来源任务。
  2. 代码回溯构造器,toSql 与 bindings 还原完整 SQL。
  3. explain 核对 type、key、rows、Extra。
  4. 补索引/改 join/缩窄条件,复测 SQL 条数、耗时与内存。

代码或图示

DB::enableQueryLog();
// 执行目标操作
foreach (DB::getQueryLog() as $entry) {
    echo $entry['query'], ' => ', json_encode($entry['bindings']), PHP_EOL;
}

常见误区

  • 上来就加索引:未看清 SQL 结构与过滤条件,可能建错索引。
  • 优化后不复测:只改代码不对比计划与耗时,无法确认问题解决。

追问

  • 慢查询与 N+1 如何区分?答:单条 SQL 执行慢看计划与索引;大量重复 SQL 看条数与模板重复,属 N+1 治理。
  • 排查产物记录在哪?答:项目可在运维/性能文档记录慢 SQL、优化手段与复测结果;敏感参数脱敏后留存。