必须用toArray()而非json_encode()转换Eloquent模型，确保预加载所有嵌套关联、合理配置$hidden/$visible或资源类裁剪字段，并对子查询结果手动映射为模型或结构化数组。
要在Laravel中正确将嵌套查询结果（如多层with预加载或子查询关联）转换为结构清晰、字段可控的数组或JSON，必须绕过直接json_encode()的陷阱，严格依赖模型自身的序列化机制，并处理好关联加载、字段过滤与动态计算逻辑的协同关系。
确保嵌套关联已真实加载
调用toArray()前，必须确认所有需要出现在最终结构中的关联都已完成预加载。例如查询StoreStock并需包含product→price和product→masterlist：
StoreStock::with(['product.price', 'product.masterlist'])->get()✅
若只写StoreStock::with('product')->get()，则price和masterlist在toArray()中为空，且无任何报错提示。
【未预加载的关联在toArray()中静默为空，不会抛出异常】
对集合批量操作时，避免在循环中逐个调用load()——这会触发N+1查询。应统一用with()一次性加载全部层级。
用toArray()而非json_encode()做最终转换
直接对Eloquent模型或Collection调用json_encode($model)会跳过$casts、访问器、$hidden/$visible规则，暴露敏感字段并丢失格式化逻辑。
正确路径是：模型实例 → toArray() → json_encode()（或直接toJson()）。
若数据来自DB::table()等原生查询，先用collect()包装成Collection，再用map→toArray()链式处理，不可对原始数组误调toArray()。
控制嵌套字段显示与隐藏
方法一：在模型中定义$hidden或$visible
在Product模型中添加protected $hidden = ['pivot', 'updated_at'];可全局屏蔽这些字段，影响所有嵌套层级中该模型的输出。
方法二：运行时动态控制
使用$stock->makeHidden(['product.price.created_at'])可临时隐藏某次转换中的特定嵌套字段，但【该操作不递归作用于product的关联模型（如price或masterlist）】，需分别调用$stock->product->price->makeHidden([...])。
方法三：资源类中精细裁剪（适合API响应）
在ApiResource中重写toArray()，对$product->price仅返回['amount' => $this->price->amount]，彻底剥离无关字段。
嵌套数据中提取唯一值并扁平化
第一步：获取已预加载的集合
$stocks = StoreStock::with(['product.price', 'product.masterlist'])->get();
第二步：用集合方法穿透多层结构提取supplier_name
$suppliers = $stocks->pluck('product.masterlist')->flatten()->pluck('supplier_name')->unique()->values();
第三步：转为纯数组供JSON序列化
$suppliers->toArray();
注意：pluck('product.masterlist')返回的是Collection数组，必须接flatten()才能把二维结构压平；若漏掉这一步，unique()将按对象引用去重，而非按supplier_name字符串值。
子查询结果转模型后嵌套转换
当使用fromSub或joinSub构造子查询（如inventory汇总表），结果默认是stdClass对象，不支持toArray()或访问器。
必须手动映射为模型实例，或用collect()→map()构造结构化数组。
例如子查询返回员工ID与TotalPrice，需关联Employee模型：
先用Employee::whereIn('id', $subResults->pluck('EmployeeID'))->get()->keyBy('id')建立索引映射；
再遍历$subResults，用$employees[$row->EmployeeID]->toArray()拼入员工信息。
