如何从Eloquent模型集合中移除不需要的关联关系字段？

安全阿岳

2026-10-1

最优解决方案

直接使用Laravel Eloquent集合原生提供的makeHidden()方法即可批量隐藏指定关联（或模型属性），无需手动遍历unset，修改后的代码如下：

return Foo::with(['something'])->get(['id', 'content', 'target'])->makeHidden('something');

makeHidden()方法会遍历集合内的所有模型实例，将传入的字段/关联加入模型的隐藏列表，序列化输出JSON时就会自动过滤something字段，是符合Laravel最佳实践的写法，代码简洁易读。

其他可选方案

如果你的场景有特殊要求，也可以选择以下适配方案：

明确指定返回字段：使用map->only()明确指定只保留需要输出的字段，适合需要严格控制输出结构、避免新增字段意外暴露的场景：
```
return Foo::with(['something'])
    ->get(['id', 'content', 'target'])
    ->map(fn (Foo $foo) => $foo->only(['id', 'content', 'target']))
    ->values();
```
彻底卸载关联：如果需要直接从模型实例中完全移除关联属性（不仅仅是隐藏输出），可以调用模型原生的unsetRelation()方法，配合集合的each使用，比直接unset写法更规范、兼容性更强：
```
return Foo::with(['something'])
    ->get(['id', 'content', 'target'])
    ->each(fn (Foo $foo) => $foo->unsetRelation('something'));
```
全局统一结构：如果多个接口都需要统一控制Foo模型的输出字段，建议创建Laravel API资源类，在资源类中固定定义返回的字段，后续维护成本更低。