Laravel模型工厂Factory伪造海量测试数据技巧【仿真】

应优先使用 Post::factory()，它自动绑定模型并触发默认行为；Factory::new() 是裸构造器，易致字段为空或外键缺失，且 Lara vel 10+ 已移除全局 factory() 辅助函数。

模型工厂这件事，说大不大，但踩坑的开发者可真不少。尤其是团队里刚升级 Lara vel 10+ 的小伙伴，最容易碰上一句 Call to undefined function factory()——别怀疑路径写错，罪魁祸首就是那个全局辅助函数被官方正式移除了。下面把几个高频的坑一次性说清楚，省得大家再走弯路。

Post::factory() 和 Factory::new() 到底用哪个

99% 的场合，直接选 Post::factory()，别碰 Factory::new()。Lara vel 10+ 已经彻底拿掉了全局的 factory() 辅助函数，Post::factory() 现在是最标准的入口——它自动绑定模型、加载 HasFactory trait、触发默认行为。而 Factory::new() 呢？它就是个裸工厂构造器，既不关联具体模型，也不读取工厂类定义，很容易让字段变成 null 或者外键缺失。

常见的错误提示 Call to undefined function factory() 根本不是路径问题，纯粹是 Lara vel 10 把这个函数删了。修复方法简单粗暴：把旧写法 factory(Post::class)->create() 全部替换成 Post::factory()->create()。

不过替换之前，有三个要点需要确认：

• 模型体内一定要有 use Illuminate\Database\Eloquent\Factories\HasFactory。
• 工厂类命名必须严格对应：比如 User 模型→UserFactory 类，文件放在 database/factories/ 下。
• 工厂类必须继承 Illuminate\Database\Eloquent\Factories\Factory，千万别再用 Lara vel 7 之前那种闭包式定义。

批量插入 1000+ 条时 unique() 失效怎么办

$this->faker->unique()->safeEmail() 在单次 create() 或 make() 内是有效的，可一旦在循环里反复调用 User::factory()->create()，Faker 的唯一计数器不会跨调用保留，跑着跑着就抛出 Integrity constraint violation。

正确做法是一次性批量创建：User::factory()->count(1000)->create()。这会让 Faker 为本次批次维护一个独立去重池，所有邮箱互不重复。

如果内存实在顶不住，必须分批（比如 200 条一批），那就别指望 unique() 了。改用带随机后缀的构造方式：

• $this->faker->numerify('user###@test.com')
• $this->faker->uuid() . '@test.com'

有一点需要特别强调：数据库字段上加 UNIQUE 约束不是备选方案，而是必选项——它能在测试跑崩之前就暴露出工厂逻辑的缺陷，而不是等数据冲突了再追悔莫及。

for() 和 has() 关联时外键总为空或报错

典型报错长这样：SQLSTATE[HY000]: General error: 1364 Field 'user_id' doesn't ha ve a default value。说白了就是子模型（比如 Post）没拿到父模型 ID。

根本原因多半是工厂类没有正确定义 $model 属性，或者 PSR-4 自动加载路径错位，导致 Lara vel 找不到对应工厂，回退到一个空工厂实例——所有字段都是 null。

遵循这三条规则就能避开：

• Post::factory()->for($user)->create() 要求 $user 是已保存的模型实例（也就是 create() 返回的对象），绝对不能用 make() 出来的临时对象。
• User::factory()->has(Post::factory()->count(3))->create() 会自动生成用户 + 关联文章，并正确设置 post.user_id。
• 检查工厂类里有没有漏写 protected $model = User::class;（Lara vel 8+ 可以省略，但低版本或自定义路径时最好显式声明）。

想混插固定值和随机值，比如前两条是 "UK" 和 "USA"

千万别用 ->create(['name' => 'UK'])——这会让全部记录都变成 UK；也别傻傻手写 20 次 create()，太啰嗦。

直接上 Sequence 类，按照创建顺序动态返回不同的属性数组：

use Illuminate\Database\Eloquent\Factories\Sequence;

$countries = Country::factory()
    ->count(20)
    ->sequence(
        ['name' => 'UK'],
        ['name' => 'USA'],
        fn () => ['name' => fake()->country()]
    )
    ->create();

它会严格按顺序分配：第 1 条 name=UK，第 2 条 name=USA，剩下 18 条用 Faker 随机国家名。多个闭包写法更灵活，比如 fn ($index) => $index === 0 ? ['name' => 'UK'] : []，适合需要条件判断的场景。

容易被忽视的一点：Sequence 只作用于当前 create() 调用批次，跨批次不共享状态；而且必须确保工厂类 definition() 方法不与 Sequence 冲突（比如 definition 里也写了 'name' 字段，会被 Sequence 覆盖掉）。