在大型 Web 应用开发中，批量导入百万级甚至千万级数据是常见的挑战。Laravel 的 Eloquent ORM 虽然为开发者提供了优雅的数据操作接口，但在处理海量记录时，其默认的关系加载机制往往成为性能瓶颈。近日，多位资深 Laravel 开发者分享了他们在导入百万条记录时优化 Eloquent 关系的实战经验，揭示了几个关键策略。

问题根源：ORM 的“关系陷阱”

通常，开发者会像这样使用 Eloquent 进行循环导入：

foreach ($records as $record) {
    $user = User::create([...]);
    foreach ($record['orders'] as $orderData) {
        $user->orders()->create($orderData);
    }
}

这段代码看似简洁，但每处理一条记录都会执行多次数据库查询。当记录数达到百万级别时，N+1 查询问题被无限放大，导致脚本运行时间呈指数级增长。数据库连接池耗尽、内存溢出、超时错误接踵而至。

优化策略一：批量插入 + 预解析关系

核心思路是避免在循环中使用 Eloquent 的关联方法，而是先准备好完整的数据结构，一次性批量插入。

$users = [];
$orders = [];
foreach ($records as $record) {
    $users[] = ['name' => $record['name'], 'email' => $record['email']];
    foreach ($record['orders'] as $order) {
        $orders[] = ['user_id' => null, 'product' => $order['product'], 'amount' => $order['amount']];
    }
}
// 先插入用户
User::insert($users);
// 获取新插入用户 ID 映射（假设有唯一标识）
$userMap = User::whereIn('email', array_column($users, 'email'))->pluck('id', 'email');
// 补充 user_id
foreach ($orders as &$order) {
    $order['user_id'] = $userMap[$order['user_email']] ?? null; // 需提前保存 user_email
}
Order::insert($orders);

此方法将数千次查询压缩为两次批量插入和一次查询，性能提升可达数十倍。

优化策略二：禁用模型事件与内存管理

默认情况下，Eloquent 的 insert() 方法不会触发模型事件，但如果你使用了 create() 或 save()，则会触发 creating、created 等事件。在批量导入时，应彻底避免这些事件开销。

此外，使用 chunk 或 cursor 逐批读取源数据，避免一次性加载整个百万级数据集到内存。建议每 500-1000 条记录一批，配合 unset 及时释放变量。

优化策略三：关系缓存与外键预关联

当需要关联多个表（如用户、订单、订单详情）时，可以在内存中建立映射字典。例如，预先将外部数据中的关联字段（如用户邮箱）与数据库中已有 ID 对应，避免在循环中反复查询。

// 提前缓存已有用户
$existingUsers = User::pluck('id', 'email');
foreach ($records as $record) {
    $userId = $existingUsers[$record['user_email']] ?? null;
    if (!$userId) {
        // 新用户处理...
    }
}

这种方法特别适合更新或混合场景（部分记录已存在）。

优化策略四：利用原生 SQL 与临时表

对于极端性能需求，可以直接使用 DB::statement() 执行原生 SQL 批量插入，或者使用 MySQL 的 LOAD DATA INFILE 语句。Laravel 的 DB::unprepared() 可配合事务使用，确保原子性。

临时表也是一个利器：先创建一个与目标表结构相同的临时表，将所有数据批量插入临时表，再通过一条 INSERT ... SELECT 语句将数据从临时表转入主表，并在此过程中处理关系映射。这避免了逐条检查外键约束的开销。

案例：某电商平台月销千万数据导入

某跨境电商团队曾面临每日千万级订单数据的导入需求。最初使用 Eloquent 循环写法，单日导入耗时超过 48 小时。经过上述优化（批量插入 + 预映射 + 关闭事件 + 分块读取），耗时降至 1.5 小时，内存占用控制在 500MB 以内。他们的核心秘诀是：绝不在循环中调用 Eloquent 关系方法，所有数据均以数组形式准备，最后一次性写入。

专家建议：选择合适的工具

对于百万级以上的数据导入，开发者应慎重权衡 ORM 的便利性与性能。建议遵循以下原则：

  • 小批量（<1万）：可用 Eloquent 但注意关闭事件；
  • 中批量（1万-100万）：使用批量插入 + 预映射；
  • 大批量（>100万）：考虑原生 SQL、临时表甚至专门的 ETL 工具（如 Apache Spark）。

同时，务必在测试环境中模拟真实数据量进行基准测试，因为本地几万条数据的表现往往无法反映生产环境的真实瓶颈。

结语

Eloquent ORM 为开发效率而生，但在海量数据场景下，它可能成为性能的“甜蜜毒药”。通过抛弃循环中的关系调用、采用批量预计算策略，开发者完全可以保留 Laravel 生态优势的同时，实现工业化级别的数据吞吐。优秀的技术选型，在于知道何时优雅，何时务实。