withoutRelations() 可创建不包含已加载关系的模型副本,用于优化 laravel 中模型序列化性能。当使用 with() 预加载关联数据但仅需返回模型基本字段时,调用该方法可避免将 posts、profile 等关联数据输出到 jsON,减少响应体积。例如:$user->withoutRelations() 仅返回用户自身属性。可结合 makeHidden() 隐藏敏感字段,提升安全与效率。注意:该方法不影响查询执行,仅作用于序列化阶段,适用于“已加载但不展示”的场景,不能替代合理查询设计。

在 Laravel 中,withoutRelations 是一个简单但容易被忽视的方法,它能有效优化模型序列化时的性能,特别是在返回 json 响应或进行 API 输出时。当模型关联了多个关系(relationships),默认情况下 Eloquent 会将已加载的关系一并序列化到 JSON 中,这可能导致数据冗余甚至性能问题。使用 withoutRelations() 可以避免不必要的关联数据输出。
理解 withoutRelations 的作用
withoutRelations() 方法的作用是创建一个原模型的副本,但不包含任何已加载的关系。这意味着即使你通过 with() 预加载了关联数据,在序列化前调用该方法后,这些关系不会出现在最终的数组或 JSON 中。
适用于以下场景:
- 你在控制器中预加载了关系用于业务逻辑判断,但不想暴露给前端
- 你只想返回模型本身的基本字段,避免深层嵌套 JSON 导致响应体过大
- 调试或日志记录时需要排除关联数据干扰
基本用法示例
假设有一个 User 模型关联了 posts 和 profile:
$user = User::with(['posts', 'profile'])->find(1); // 直接返回会包含 posts 和 profile 数据 return response()->json($user); // 使用 withoutRelations 排除所有已加载的关系 return response()->json($user->withoutRelations());
此时返回的 JSON 只包含 User 模型自身的属性,posts 和 profile 不再出现。
与隐藏属性和访问器配合使用
withoutRelations() 并不影响模型的可见属性控制,你可以结合 hidden 属性或 makeHidden() 进一步精简输出:
return response()->json( $user ->withoutRelations() ->makeHidden(['email_verified_at', 'password']) );
这样既去除了关联数据,又隐藏了敏感或无用字段,提升安全性和传输效率。
注意点与常见误区
需要注意的是:
-
withoutRelations()不会影响数据库查询本身,只是在序列化阶段起作用 - 如果你根本不需要加载关系,最佳做法是在查询时就不使用
with(),而不是先加载再剔除 - 该方法不会“卸载”关系定义,只是返回一个不含关系的新实例
- 适用于临时处理,不影响原始模型对象
换句话说,withoutRelations() 更适合“已经加载但不想展示”的情况,而非替代合理的查询设计。
基本上就这些。合理使用 withoutRelations() 能让你在保持代码灵活性的同时,更精细地控制 API 输出结构,是一种轻量级的序列化优化手段。


