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。该类需继承 \Illuminate\Database\Eloquent\Factories\Factory，并实现 definition() 方法。
关键点：
- 工厂类必须通过
protected $model指定关联的 Eloquent 模型，不能靠文件名自动推断 - 不支持在
definition()中直接调用$this->faker->name等方法——必须先声明use Faker\Generator as Faker;并在configure()或构造函数中注入 - 注册不是“自动”的，需要在
DatabaseFactory中显式调用from()或通过Model::factory()触发加载
namespace Database\Factories;
use App\Models\User;
use Illuminate\Database\Eloquent\Factories\Factory;
use Faker\Generator 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 [App\Models\User]。此时检查路径是否为 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() 或手动移除——但这通常不是你想要的。
