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

06.5.1.3 Eloquent ORM 与事务

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

本节要解决的问题

  • Eloquent 模型、关联与预加载如何避免 N+1,访问器与序列化如何控制字段?
  • 事务边界、锁与并发冲突如何处理,迁移与索引如何管理?
  • 查询构造器、原生查询、软删除与分页在什么场景使用?

版本前提:PHP 8.2+ / Laravel 10-11;Eloquent API 细节以框架版本文档为准。

06.5.1.3-001 Eloquent 模型如何映射数据表?

一句话结论

模型类对应一张表,默认按类名复数推断表名,可显式指定 $table;主键默认 id,时间戳字段自动维护;模型实例映射一行记录,属性对应列。

概念解释

Eloquent 以 Active Record 风格封装单表:新建、保存、查询都通过模型方法。表名、主键、连接、时间戳可按模型覆盖配置。

常见误区

  • 模型里写跨表业务编排:应放到服务层,模型只封装数据与简单规则。
  • 列名与属性映射不清晰:魔法属性难维护,关键字段显式声明类型转换。

追问

  • 模型与 Repository 怎么配合?模型表达数据,仓储封装查询,服务编排用例。
  • 非主键如何配置?声明 $primaryKey 与递增策略。

06.5.1.3-002 关联类型有哪些?

一句话结论

一对一 hasOne、一对多 hasMany、属于 belongsTo、多对多 belongsToMany,还有远程关联与多态关联;关联方法返回关联对象,可链式追加约束与预加载。

概念解释

关联方法同时承担关系定义与查询构造。多对多需要中间表,可附带中间表字段与时间戳。

常见误区

  • 关联方法内写死业务条件:复用性差,条件应在查询时追加。
  • 多对多中间表字段未定义:附加数据无法读写。

追问

  • 关联反向如何匹配?belongsTo 指向外键所在方,hasMany 指向对方集合。
  • 多态关联适用什么?同一模型可挂多种父级(如评论关联帖子/视频)。

06.5.1.3-003 如何避免 N+1 查询?

一句话结论

列表查询用 with('relation') 预加载关联,一次性批量取出并在内存组装;避免在循环中访问关联触发单条查询;只预加载需要的关联与字段。

概念解释

N+1 来自懒加载:主列表 1 次查询,遍历每条访问关联各 1 次。预加载把关联查询合并为按主键批量 IN 查询。

常见误区

  • 模板/序列化层遍历访问关联:懒加载在输出层触发 N+1。
  • with 加载全部关联:不需要的大关联被一并查出,浪费内存与时间。

追问

  • 预加载与延迟加载区别?批量预取 vs 按需单查,列表场景必须预加载。
  • 嵌套关联怎么预加载?with('posts.comments') 点号路径加载多层。

06.5.1.3-004 withCount 如何统计关联数量?

一句话结论

withCount('relation') 在主查询附带关联计数子查询,不加载关联集合本身;需要排序或筛选计数时配合 having 约束;避免加载整批关联再 count()。

概念解释

计数通过聚合子查询完成,结果写入模型属性(如 comments_count)。相比加载关联集合,计数只取数量,开销更小。

常见误区

  • 为统计数量 with 整个关联:大集合加载到内存只为数个数。
  • 计数与关联集合混淆:需要数量用 count,需要数据用 with。

追问

  • 关联计数带条件怎么写?withCount(['comments as approved' => fn($q) => ...])。
  • 计数属性如何序列化?默认随模型输出,不需要可隐藏。

06.5.1.3-005 延迟加载与预加载如何取舍?

一句话结论

单条详情可接受懒加载,列表与批量场景必须预加载;关联是否随主数据一起读取取决于访问模式;序列化前确认所有输出关联已预加载。

概念解释

懒加载写法简单但在循环中放大查询次数。取舍标准:一次会访问多少条主记录,批量场景一律预加载。

常见误区

  • 详情页也懒加载多个关联:单条尚可,但关联深时仍产生多条查询。
  • 预加载全量字段:只取展示需要的列,减少数据传输。

追问

  • 如何发现 N+1?开启查询日志或调试工具,观察列表接口的 SQL 条数。
  • 关联按需加载能否缓存?热点关联可缓存到 Redis,但注意一致性窗口。

06.5.1.3-006 访问器、修改器与类型转换如何使用?

一句话结论

访问器在读属性时转换输出,修改器在写入时转换输入;$casts 声明字段类型(数组、日期、布尔、枚举等)自动转换;展示格式化放访问器,存储规范化放修改器。

概念解释

模型层封装格式转换:业务代码拿到的已是类型化属性,不用每次手动解码/格式化。枚举、JSON 列靠 casts 保证读写一致。

常见误区

  • 在访问器里做跨模型查询:读属性触发额外 SQL,加剧 N+1。
  • casts 与访问器逻辑重复:转换规则应集中一处。

追问

  • JSON 列如何读写?casts 为 array/collection,存取自动编解码。
  • 日期字段类型?casts 为 datetime,自动转为 Carbon/日期对象。

06.5.1.3-007 模型序列化如何控制暴露字段?

一句话结论

$hidden 隐藏敏感字段,$visible 白名单开放字段;响应资源类按接口需要组装输出;避免把整个模型直接返回给前端,关联与内部字段按需输出。

概念解释

模型内部结构不等于接口契约。序列化层裁剪字段,防止密码、内部状态、关联全量泄漏。

常见误区

  • return $model:隐藏字段外的所有属性与关联默认输出。
  • 不同接口复用同一模型序列化:字段需求不同,应使用独立资源类。

追问

  • 隐藏字段与可见字段优先级?白名单优先于黑名单,按接口选择策略。
  • 关联如何进入输出?资源类显式选择携带哪些关联数据。

06.5.1.3-008 查询构造器在什么场景使用?

一句话结论

复杂聚合、分组、原生条件或不需要模型实例时用查询构造器;Eloquent 负责模型映射与关联,构造器负责灵活 SQL 组装;两者可切换,结果按需 hydrate 为模型。

概念解释

构造器返回数组/对象集合,不附带模型行为;轻量统计与大批量读写更直接。需要模型方法与关联时回到 Eloquent。

常见误区

  • 简单 CRUD 也手写构造器:失去模型封装与批量赋值保护。
  • 构造器拼接用户输入条件:同样需要参数绑定与白名单。

追问

  • 构造器与模型查询能否混合?模型查询底层即构造器,可追加 where 约束。
  • 批量更新用什么?构造器批量 update,不逐行加载模型保存。

06.5.1.3-009 数据库事务边界如何划定?

一句话结论

事务包裹同一用例内必须一致的多条读写,短事务优先;事务内不做远程调用、发消息与重计算;异常抛出回滚,提交后再触发外部副作用。

概念解释

本地事务保证单库原子性。边界按业务用例划分:增减余额、状态流转等必须同进同退的操作纳入事务;通知、日志等副作用放事务提交后。

常见误区

  • 事务内调用外部接口/队列:长事务持锁等待外部故障,放大死锁与连接占用。
  • 捕获异常不标记回滚:部分写入已提交,数据不一致。

追问

  • 事务嵌套怎么处理?框架支持事务层级,注意回滚传播行为(以版本文档为准)。
  • 跨库/跨服务一致性?本地事务不覆盖,走消息最终一致或分布式事务方案。

06.5.1.3-010 乐观锁与悲观锁如何处理并发冲突?

一句话结论

乐观锁用版本号/时间戳字段,更新时比对版本,冲突重试;悲观锁查询时 lockForUpdate 锁定行直到事务结束;按冲突频率选择:低冲突用乐观,高竞争短临界区用悲观。

概念解释

并发更新同一行时需要防覆盖。乐观锁不阻塞但重试失败,悲观锁阻塞等待但实现简单。库存扣减、余额变更等场景必须有锁机制兜底。

常见误区

  • 读出来判断再写,中间不加版本/锁:并发下后写覆盖先写。
  • 悲观锁范围过大:锁住多行引发锁等待与死锁。

追问

  • 乐观锁冲突如何处理?返回冲突或有限重试,不无限循环。
  • 唯一约束兜底什么?即使应用层漏判,数据库唯一键拒绝重复写入。

06.5.1.3-011 数据库迁移如何管理?

一句话结论

迁移文件按版本编号描述表结构变更(建表、加列、索引、回滚),可向上/向下执行;迁移与代码版本配套部署,评审后执行;不手工改线上表结构跳过迁移。

概念解释

迁移是 Schema 的版本化脚本:团队成员与环境通过迁移保持结构一致。数据变更与结构变更分开评估,破坏性变更需兼容过渡。

常见误区

  • 本地改表不写迁移:环境间结构漂移。
  • 直接删除旧列:仍在运行的旧版本代码访问报错,需先双写过渡。

追问

  • 迁移回滚怎么做?迁移文件提供 down 逻辑,破坏性回滚前备份数据。
  • 种子数据放哪里?seeder 独立于结构迁移,按环境初始化演示数据。

06.5.1.3-012 索引如何配合查询设计?

一句话结论

按高频 where、order by、关联字段建索引,联合索引注意字段顺序;慢查询通过执行计划确认命中索引;索引提升读取但拖慢写入,不为低频字段盲目建索引。

概念解释

索引服务具体查询模式:等值、范围、排序组合成联合索引。模型迁移中定义索引,随版本管理。

常见误区

  • 每列单独建索引:联合查询无法利用,写入成本高。
  • 函数/前导模糊查询导致索引失效:未看执行计划。

追问

  • 唯一索引防什么?业务键重复写入在数据库层被拒绝。
  • 慢查询如何定位?慢查询日志 + 执行计划分析扫描行数与命中索引。

06.5.1.3-013 软删除如何实现与注意什么?

一句话结论

模型引入软删除特性,删除时置删除标记而非物理删除;默认查询排除已删记录,可显式包含;唯一约束需考虑软删记录,列表与统计必须过滤删除标记。

概念解释

软删除保留审计与恢复能力,但占用主表数据量。已删记录归档后可物理清理。

常见误区

  • 关联查询忘记排除软删:已删除内容出现在结果中。
  • 唯一索引未含删除标记:重新创建同业务键报冲突。

追问

  • 软删数据何时归档?定期迁移到历史表后物理删除主表记录。
  • 级联软删怎么处理?按业务规则批量标记关联记录,保持一致。

06.5.1.3-014 列表分页如何实现?

一句话结论

用分页方法返回当前页数据与元信息(总数、页码、页大小);限制最大页大小;深分页用游标/主键续翻避免大偏移扫描;只查需要的字段与预加载必要关联。

概念解释

分页控制单请求数据量。偏移分页实现简单,深页码性能差;游标分页稳定但不支持跳页。

常见误区

  • 允许超大 perPage:单请求加载全表拖垮内存。
  • 分页接口未预加载关联:列表触发 N+1。

追问

  • 总数实时计算代价大怎么办?大数据量用近似计数或异步统计。
  • 排序字段要求什么?分页稳定排序需唯一有序字段。

06.5.1.3-015 批量赋值(fillable)如何保护模型?

一句话结论

$fillable 白名单允许批量赋值字段,$guarded 黑名单排除;请求输入只传入白名单字段;敏感列(角色、状态、余额)显式赋值并经过授权校验。

概念解释

批量赋值防护把"客户端能写哪些列"显式化。模型层白名单与入口 DTO 约束形成两层防护。

常见误区

  • guarded = [] 全开放:请求里任何字段都可写入模型。
  • 白名单包含内部状态列:越权篡改业务状态。

追问

  • 白名单与接口字段不一致怎么办?以接口 DTO 为准,模型白名单做最后防线。
  • 批量更新如何安全做?构造器按条件更新白名单列,不整包接收请求。

06.5.1.3-016 原生查询如何写且防注入?

一句话结论

必要时用原生 SQL,值通过绑定参数传入;表名/列名等标识符走白名单映射;原生查询集中在仓储层,结果转为模型或 DTO;不拼接用户输入进语句。

概念解释

ORM 表达不足时可下沉原生 SQL,但参数绑定规则与手写 SQL 一致。绑定占位符由驱动转义,不手拼引号。

常见误区

  • 原生语句拼接请求参数:注入风险直接进入数据库。
  • 原生 SQL 散落在控制器:难评审、难替换。

追问

  • 绑定占位符形式?? 或命名占位符,按驱动支持选择。
  • 原生结果如何映射?手动 hydrate 到模型或返回数组,上层不依赖数据库行结构。

06.5.1.3-017 模型事件与观察者如何使用?

一句话结论

模型生命周期事件(creating/created/saving/saved/deleting/deleted)挂载回调或观察者类,用于派生字段、缓存失效、联动记录;副作用解耦到事件监听,不堆进保存方法。

概念解释

观察者按模型集中处理生命周期动作。注意事件中再触发模型保存可能形成递归。

常见误区

  • 观察者内做远程调用/队列投递:模型保存路径变重,应转异步事件。
  • 事件回调相互循环触发:保存动作反复进入同一钩子。

追问

  • 观察者与业务事件区别?模型事件绑定数据生命周期,业务事件表达用例事实,后者更适合解耦副作用。
  • 批量操作触发模型事件吗?直接构造器批量更新不经过模型钩子,需注意副作用遗漏。

06.5.1.3-018 数据库连接与读写分离如何配置?

一句话结论

配置主从连接,写走主库、读走只读副本;事务内与强一致读回主库;连接参数按环境注入;副本延迟敏感的操作不依赖从库新鲜度。

概念解释

Eloquent/构造器可指定连接。读写分离分摊读压力,但主从延迟要求业务区分强一致读与最终一致读。

常见误区

  • 写后立即读从库:读到旧数据,表现为刚创建查不到。
  • 所有连接池按满配置:实例数 × 连接数超过数据库上限。

追问

  • 副本延迟怎么观测?复制延迟指标,超阈值读流量切回主库。
  • 分库分表与读写分离区别?读写分离扩展读能力,分库分表解决容量与写入扩展。