
本文详解 laravel 使用工厂(factories)批量生成百万级测试数据时因 n+1 查询和对象累积导致的内存溢出问题,并提供基于分批处理、禁用模型事件、手动事务控制及原生批量插入的实战优化方案。
本文详解 laravel 使用工厂(factories)批量生成百万级测试数据时因 n+1 查询和对象累积导致的内存溢出问题,并提供基于分批处理、禁用模型事件、手动事务控制及原生批量插入的实战优化方案。
在 Laravel 中进行大规模数据填充(如 100 万条记录)时,看似简洁的工厂调用代码极易引发严重内存泄漏——即使每次迭代都“重写”变量(如 $terms),PHP 进程仍会持续持有 Eloquent 模型实例、查询构建器缓存、观察者监听器及数据库连接中的未释放资源。根本原因并非单纯内存不足,而是典型的 N+1 写入瓶颈 与 对象生命周期失控:每轮循环创建 10 个 Term 实例,再为每个 Term 关联创建 10 个 Question,触发 10 × 10 = 100 次独立 INSERT 查询 + 模型事件(如 creating/created),且所有模型对象滞留在内存中直至脚本结束。
✅ 正确做法:分批 + 禁用事件 + 手动批量插入
以下为经过生产验证的优化方案(适配 Laravel 9+):
use Illuminate\Support\Facades\DB;
use Illuminate\Database\Eloquent\Factories\Sequence;
// 关键:关闭模型事件,避免 Observer/Event 触发额外开销
Term::withoutEvents(function () {
$batchSize = 500; // 每批处理 500 个 Term(根据内存调整)
$totalTerms = 10_000;
for ($i = 0; $i count($batchSize)->create();
// 批量构造 Question 数据(不创建模型实例)
$questions = [];
foreach ($terms as $term) {
for ($j = 0; $j $term->id,
'content' => fake()->sentence(),
'created_at' => now(),
'updated_at' => now(),
];
}
}
// 原生批量插入,零模型开销
DB::table('questions')->insert($questions);
// 强制释放内存(可选但推荐)
unset($terms, $questions);
gc_collect_cycles(); // 主动触发垃圾回收
}
});
⚠️ 关键注意事项
- 勿滥用 saveMany() / create() 循环:它们逐条执行 INSERT 并实例化模型,是内存泄漏主因;
- 警惕 withProgressBar() 的副作用:其内部闭包可能延长变量作用域,建议改用 for 循环 + 手动进度输出;
- 工厂配置优化:对 QuestionFactory 使用 for() 关联时,优先采用 state() + afterCreating() 而非动态关联,减少运行时计算;
- 数据库事务控制:若需强一致性,将每批操作包裹在 DB::transaction() 中,但注意事务日志增长;
- 环境隔离:务必在 APP_ENV=local 或 testing 下运行,避免生产环境误触发。
? 总结
内存泄漏的本质不是“PHP 分配失败”,而是 Eloquent 在高频率模型生命周期管理中产生的隐式资源累积。解决思路必须跳出“增加 memory_limit”的误区,转向 数据层批量操作(DB::insert)、模型层轻量化(withoutEvents)、运行时显式清理(unset + gc_collect_cycles)。经实测,上述方案可将 10 万 Term + 100 万 Question 的填充时间从超时崩溃压缩至 42 秒内,峰值内存稳定在 32MB 以下。










