Laravel Livewire公共Collection属性添加元素时对象转数组问题排查

1. Livewire序列化机制限制：Livewire会在组件请求周期结束时对所有公共属性执行脱水（序列化）操作，Eloquent模型默认会被序列化为关联数组。当第二次触发组件方法时，Livewire将之前脱水的集合反序列化（再水化），此时集合内的原模型实例已转为数组。
2. 重复引用同一模型实例：代码中反复复用$this->order_items这同一个模型实例添加到集合，Livewire为避免循环引用，会将重复引用的模型转为数组。
3. 临时属性未被正确处理：你给模型添加了未在数据库中定义的amount_ordered临时属性，Eloquent模型的默认序列化逻辑不会保留该属性，进一步引发序列化异常。

方案1：改用protected属性存储集合 #

将$temp_items声明为protected，Livewire不会序列化protected/private属性，可完整保留集合内的模型实例类型：

use Illuminate\Support\Collection;

protected Collection $temp_items;

public function mount()
{
    $this->temp_items = collect();
}

注意：protected属性无法跨请求保留，若需持久化数据，需配合会话存储或在hydrate方法中恢复。

方案2：克隆模型实例后再添加 #

每次添加时克隆模型对象，避免重复引用同一实例，同时妥善处理临时属性：

// 替换原代码中的添加逻辑
$item = clone $this->order_items;
$item->amount_ordered = $this->amount_ordered;
$this->temp_items->add($item);

更稳妥的方式是将数据封装为数组（而非修改模型）：

$itemData = $this->order_items->toArray();
$itemData['amount_ordered'] = $this->amount_ordered;
$this->temp_items->add($itemData);

// 后续需模型实例时，通过stock_id重新查询
$stock = Stock::find($itemData['stock_id']);

方案3：自定义序列化/反序列化逻辑 #

通过Livewire的生命周期方法自定义temp_items的处理逻辑，手动控制模型与数组的转换：

// 自定义序列化逻辑
public function serialize()
{
    return [
        'temp_items' => $this->temp_items->map(fn($item) => $item instanceof Stock ? $item->toArray() + ['amount_ordered' => $item->amount_ordered] : $item),
        // 其他需要序列化的属性
    ];
}

// 自定义反序列化逻辑
public function hydrate()
{
    $this->temp_items = collect($this->temp_items)->map(function($item) {
        if(is_array($item) && isset($item['stock_id'])) {
            $stock = Stock::find($item['stock_id']);
            $stock->amount_ordered = $item['amount_ordered'];
            return $stock;
        }
        return $item;
    });
}

方案4：明确声明Eloquent集合类型 #

确保$temp_items被正确声明为Eloquent集合，配合克隆使用可缓解问题：

use Illuminate\Database\Eloquent\Collection;

public Collection $temp_items;

public function mount()
{
    $this->temp_items = new Collection();
}

内容的提问来源于stack exchange，提问作者Jamesson Cardozo