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/构造器可指定连接。读写分离分摊读压力,但主从延迟要求业务区分强一致读与最终一致读。
常见误区
- 写后立即读从库:读到旧数据,表现为刚创建查不到。
- 所有连接池按满配置:实例数 × 连接数超过数据库上限。
追问
- 副本延迟怎么观测?复制延迟指标,超阈值读流量切回主库。
- 分库分表与读写分离区别?读写分离扩展读能力,分库分表解决容量与写入扩展。