Laravel中如何使用模型工厂Factory_Laravel填充测试数据Factory用法【实战】

Laravel 8.x+ 模型工厂重构为类形式，需继承 Factory 类、指定 $model 属性、实现 definition() 方法，并通过 User::factory()->create() 等静态方法调用；旧版 factory()->create() 已废弃。

直接说结论：laravel 的模型工厂（Factory）在 8.x+ 版本中已重构为基于 php 类的工厂类，不再使用 factory()->create() 全局函数；如果你还在用旧写法，会报 Call to undefined function factory() 错误。

如何定义和注册模型工厂类

Laravel 8+ 要求每个模型对应一个独立的工厂类，放在 database/factories 目录下，命名格式为 ModelNameFactory.php。该类需继承 IlluminateDatabaseEloquentFactoriesFactory，并实现 definition() 方法。

关键点：

• 工厂类必须通过 protected $model 指定关联的 Eloquent 模型，不能靠文件名自动推断
• 不支持在 definition() 中直接调用 $this->faker->name 等方法——必须先声明 use FakerGenerator as Faker; 并在 configure() 或构造函数中注入
• 注册不是“自动”的，需要在 DatabaseFactory 中显式调用 from() 或通过 Model::factory() 触发加载

namespace DatabaseFactories;  use AppModelsUser; use IlluminateDatabaseEloquentFactoriesFactory; use FakerGenerator as Faker;  class UserFactory extends Factory {     protected $model = User::class;      public function definition(Faker $faker): array     {         return [             'name' => $faker->name,             'email' => $faker->unique()->safeEmail,             'password' => bcrypt('password'),         ];     } }

如何在测试或 Tinker 中创建测试数据

不能再用 factory(User::class)->create()。新写法统一走模型的静态 factory() 方法，它会自动查找并实例化对应的工厂类。

常见用法：

• User::factory()->create()：创建一条记录并存入数据库
• User::factory()->count(5)->create()：创建 5 条记录
• User::factory()->make()：只生成模型实例，不入库（适合单元测试中避免 DB 依赖）
• User::factory()->for(Post::factory())->create()：为外键关系生成关联数据（如用户属于某篇文章）

注意：如果工厂类未被自动发现（比如命名不规范或目录不对），会抛出 Unable to locate factory for [appModelsUser]。此时检查路径是否为 database/factories/UserFactory.php，且类名与文件名一致。

如何覆盖默认字段值或动态生成关联

工厂支持链式状态（state()）和关系嵌套，但写法和旧版差异较大。所有覆盖都应在 create() 或 make() 前完成。

示例场景：

• 覆盖单个字段：User::factory()->state(['email' => 'test@example.com'])->create()
• 组合多个状态：User::factory()->admin()->active()->create()（需提前在工厂中定义 admin() 和 active() 方法）
• 强制关联已有模型：User::factory()->for($post, 'post')->create()，其中 'post' 是模型中定义的关联关系名（如 belongsTo(Post::class) 的方法名）

容易踩的坑：for() 第二个参数是关系方法名，不是数据库字段名；如果写成 'post_id' 会静默失败或报错 Relationship method not found。

为什么有时 create() 不触发模型事件或观察者

这是 Laravel 工厂的默认行为：为性能考虑，create() 默认跳过模型事件（creating, created 等）和观察者逻辑。如果你的模型依赖这些钩子做数据处理（如自动生成 slug、同步缓存），必须显式启用：

• 加 ->recycle() 不解决这个问题
• 正确做法是：在工厂调用链末尾加上 ->createQuietly() 的反向操作——等等，其实没有反向操作；你得手动触发，或者改用 new Model([...])->save()
• 更稳妥的方式：在测试中用 Event::fake() 拦截并断言事件，或在工厂中用 afterCreating() 回调模拟部分逻辑

最常被忽略的一点：工厂创建的数据不会经过 boot() 中定义的全局作用域（Global Scopes），除非你在工厂里显式调用 withoutGlobalScopes() 或手动移除——但这通常不是你想要的。