Laravel如何实现含一对一关联的批量插入？

嘿，这个需求很常见！Laravel 本身并没有直接提供像你设想的 Model::withSecondTable()->insert($data) 这种“一键式”关联批量插入方法，但我们可以通过几种靠谱的方式实现同时向主表和关联表插入数据的需求，下面给你拆解一下：

方法一：循环插入 + 数据库事务（小数据量首选） #

如果你的数据量不大（比如几十上百条），最稳妥的方式是用数据库事务包裹循环，确保主表和关联表的插入操作要么全部成功，要么全部回滚，避免数据不一致。

假设我们有 User 主模型（对应 users 表）和 Profile 关联模型（对应 profiles 表，一对一关联，profiles.user_id 关联 users.id），代码示例如下：

use App\Models\User;
use App\Models\Profile;
use Illuminate\Support\Facades\DB;

// 准备包含主表和关联表数据的数组
$data = [
    [
        'name' => '张三', 
        'age' => 25,
        'profile' => ['bio' => '喜欢编程', 'location' => '北京']
    ],
    [
        'name' => '李四', 
        'age' => 30,
        'profile' => ['bio' => '热爱设计', 'location' => '上海']
    ],
];

// 开启事务
DB::beginTransaction();

try {
    foreach ($data as $item) {
        // 1. 插入主表数据，获取创建的模型实例
        $user = User::create([
            'name' => $item['name'],
            'age' => $item['age']
        ]);
        
        // 2. 利用关联关系插入关联表数据
        $user->profile()->create($item['profile']);
    }
    
    // 提交事务
    DB::commit();
} catch (\Exception $e) {
    // 出错则回滚
    DB::rollBack();
    // 可以在这里处理错误，比如记录日志、返回错误信息
    throw $e;
}

这种方式的优势是逻辑清晰，能保证数据一致性，而且利用了 Laravel 模型的关联方法，不需要手动处理外键。

方法二：利用模型事件（自动触发关联插入） #

如果你希望每次创建主模型时，自动创建对应的关联模型，可以通过模型事件来实现，这样批量插入主模型时，每个模型都会自动触发关联插入。

在 User 模型中定义 created 事件：

// app/Models/User.php
class User extends Model
{
    // 定义一对一关联
    public function profile()
    {
        return $this->hasOne(Profile::class);
    }

    protected static function booted()
    {
        static::created(function ($user) {
            // 这里可以从请求或预先设置的属性中获取关联数据
            // 比如如果批量插入时给每个User模型设置了profile_data属性
            if (isset($user->profile_data)) {
                $user->profile()->create($user->profile_data);
                // 清理临时属性
                unset($user->profile_data);
            }
        });
    }
}

然后批量插入时，给每个数据项添加临时属性：

$data = [
    [
        'name' => '张三', 
        'age' => 25,
        'profile_data' => ['bio' => '喜欢编程', 'location' => '北京']
    ],
    [
        'name' => '李四', 
        'age' => 30,
        'profile_data' => ['bio' => '热爱设计', 'location' => '上海']
    ],
];

// 注意这里要用createMany而不是insert，因为insert是批量插入原生SQL，不会触发模型事件
User::createMany($data);

⚠️ 注意：必须用 createMany 而不是 insert，因为 insert 是直接执行批量插入的SQL语句，不会触发任何模型事件，而 createMany 会循环调用 create，从而触发 created 事件。

方法三：批量插入主表 + 批量插入关联表（大数据量首选） #

如果你的数据量很大（比如几千上万条），循环插入的效率会很低，这时候可以先批量插入主表，然后获取插入的ID列表，再批量插入关联表。

步骤如下：

1. 提取主表数据，批量插入，获取所有插入记录的ID
2. 构造关联表数据，将主表ID与关联数据一一对应
3. 批量插入关联表数据

代码示例：

use App\Models\User;
use App\Models\Profile;
use Illuminate\Support\Facades\DB;

// 原始数据
$data = [
    [
        'name' => '张三', 
        'age' => 25,
        'profile' => ['bio' => '喜欢编程', 'location' => '北京']
    ],
    [
        'name' => '李四', 
        'age' => 30,
        'profile' => ['bio' => '热爱设计', 'location' => '上海']
    ],
];

// 1. 提取主表数据
$userData = collect($data)->map(function ($item) {
    return ['name' => $item['name'], 'age' => $item['age']];
})->toArray();

// 2. 批量插入主表，获取插入的ID列表
// 注意：只有当表的主键是自增ID时，才能用这种方式获取连续ID
DB::table('users')->insert($userData);
$lastId = DB::getPdo()->lastInsertId();
$userIds = range($lastId - count($userData) + 1, $lastId);

// 3. 构造关联表数据
$profileData = collect($data)->map(function ($item, $index) use ($userIds) {
    return array_merge($item['profile'], ['user_id' => $userIds[$index]]);
})->toArray();

// 4. 批量插入关联表
Profile::insert($profileData);

⚠️ 注意：这种方式依赖于数据库自增ID的连续性，如果你的数据库设置了非连续自增（比如MySQL的auto_increment_offset），或者插入过程中有其他操作插入了数据，ID列表可能会出错。如果要更安全，可以在支持的数据库（比如MySQL 8.0+）中使用 RETURNING 子句直接获取插入的ID。

以上三种方法可以根据你的数据量和业务场景选择，核心都是保证主表和关联表的数据一致性，同时满足批量插入的需求。

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