如何在Laravel中实现一对多关系的保存及批量更新功能

原代码问题说明 #

原代码无论是否传入地址记录ID，都会初始化新的UserAddress模型实例，且saveMany()方法默认仅会对新实例执行插入操作，因此无法实现更新逻辑。

调整后可同时支持新增/更新的代码 #

public function saveUserAddress($request)
{
    $user = $request->user();
    $addresses = $request->addresses;
    $userAddressInstances = [];

    if (!empty($addresses)) {
        // 先获取当前用户已有地址ID，做权限校验避免越权修改他人地址
        $existAddressIds = $user->addresses()->pluck('id')->toArray();
        $submitIds = [];

        for ($i = 0; $i < count($addresses['country_id']); $i++) {
            $id = $addresses['id'][$i] ?? 0;
            $submitIds[] = $id > 0 ? $id : null;

            // 有有效ID且属于当前用户走更新逻辑，否则走新增逻辑
            $address = $id > 0 && in_array($id, $existAddressIds) 
                ? UserAddress::find($id) 
                : new UserAddress();

            // 填充字段数据
            $address->fill([
                'user_id' => $user->id, // 显式填充用户ID，新增时需要
                'country_id' => $addresses['country_id'][$i] ?? null,
                'state_id' => $addresses['state_id'][$i] ?? null,
                'city_id' => $addresses['city_id'][$i] ?? null,
                'type' => $addresses['type'][$i] ?? null,
                'address_line_1' => $addresses['address_line_1'][$i] ?? null,
                'address_line_2' => $addresses['address_line_2'][$i] ?? null,
                'phone' => $addresses['phone'][$i] ?? null,
                'postcode' => $addresses['postcode'][$i] ?? null,
            ]);

            $userAddressInstances[] = $address;
        }

        // 批量保存：已有ID的模型会执行更新，无ID的执行新增
        $user->addresses()->saveMany($userAddressInstances);

        // 可选：如果需要同步删除前端已移除的地址，打开下方注释
        // $user->addresses()->whereNotIn('id', array_filter($submitIds))->delete();
    }
}

注意：需要先在UserAddress模型的$fillable属性中配置所有可批量填充的字段，否则fill()方法会过滤字段值。

更优的一对多关系存储方案 #

1. 优化前端传参结构 #

建议将现有按字段分组的传参改为按地址条目分组，示例结构如下：

{
  "addresses": [
    {"id":1, "country_id":1, "state_id":2, ...},
    {"id":null, "country_id":1, "state_id":3, ...}
  ]
}

后端处理时无需按索引遍历取值，逻辑更清晰，不易出现下标不匹配的错误。

2. 使用upsert实现更高性能的批量操作 #

如果是Laravel 8+版本，可以使用关联的upsert方法，直接批量处理新增更新，无需循环初始化模型，性能更高：

// 先构造所有地址的原始数据数组
$addressData = [];
foreach ($request->addresses as $addr) {
    $addressData[] = [
        'id' => $addr['id'] ?? null,
        'user_id' => $user->id,
        'country_id' => $addr['country_id'] ?? null,
        // 其他字段按需填充
    ];
}

// 批量upsert：唯一键用id，第三个参数指定需要更新的字段
$user->addresses()->upsert(
    $addressData,
    ['id'],
    ['country_id', 'state_id', 'city_id', 'type', 'address_line_1', 'address_line_2', 'phone', 'postcode']
);

3. 加入事务保证数据一致性 #

涉及批量写入操作时，建议加入数据库事务，避免部分写入成功、部分失败导致的数据不一致：

DB::transaction(function () use ($user, $addresses) {
    // 所有写入逻辑放在事务内执行
});

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