Laravel 10+ 移除了全局 factory() 辅助函数，须改用模型静态 factory() 方法（需 use HasFactory），工厂类须命名规范、继承 Factory，definition() 中用 $this->faker，关联数据用 for()/has() 而非手动赋值。
为什么 factory() 在 Laravel 10+ 里直接报错？
因为 Laravel 10 移除了全局 factory() 辅助函数，也废弃了 FactoryBuilder 的链式调用方式。如果你还在用 factory(User::class)->count(5)->create()，会看到 Call to undefined function factory() 错误。
正确路径是：必须通过模型自身的 factory() 静态方法（由 HasFactory trait 提供）来触发。
- 确保模型已 use
Illuminate\Database\Eloquent\Factories\HasFactory - 对应工厂类需命名规范：如
User模型 →UserFactory类，且位于database/factories/下 - 工厂类必须继承
\Illuminate\Database\Eloquent\Factories\Factory
怎么写一个兼容 Laravel 9/10/11 的 UserFactory？
关键在 definition() 返回数组，以及用 $this->faker（不是 Faker\Generator 实例变量）；Laravel 10+ 工厂默认支持 PHP 8.1+ 属性提升，但为兼容性建议显式声明 protected $model。
use Illuminate\Database\Eloquent\Factories\Factory;
use App\Models\User;
class UserFactory extends Factory
{
protected $model = User::class;
public function definition(): array
{
return [
'name' => $this->faker->name(),
'email' => $this->faker->unique()->safeEmail(),
'password' => bcrypt('password'),
];
}
}
注意：$this->faker 是工厂基类自动注入的，不要手动 new Faker；unique() 必须链在 safeEmail() 前，否则重复数据会插入失败。
如何在测试或 Tinker 中批量创建带关系的测试数据？
用 for() 方法关联父模型，比老版 create(['user_id' => $user->id]) 更可靠，避免外键约束失败或 N+1。
- 生成 3 个属于同一用户的 Post：
Post::factory()->for($user)->count(3)->create() - 生成带嵌套关系的用户+文章+评论：
User::factory()->has(Post::factory()->hasComments(2))->create() - 需要自定义子模型字段时，传闭包：
->has(Post::factory()->state(['title' => 'Draft']))
⚠️ 容易踩坑：如果 Post 模型的工厂没定义 $model 或路径不对，会抛出 Target class [App\Database\Factories\PostFactory] does not exist —— 检查命名空间和文件路径是否匹配 PSR-4 自动加载规则。
数据库迁移后工厂不生效？检查这三处硬编码陷阱
工厂本身不依赖迁移，但测试数据插入失败常因字段不匹配。最典型的是：
-
created_at/updated_at字段在模型中被禁用（public $timestamps = false），但工厂仍尝试写入 —— 此时要在definition()中剔除时间字段，或在state()里覆盖 - 数据库字段类型不兼容 faker 输出，比如用
$this->faker->text()往VARCHAR(255)字段插 2000 字符 → 截断或报错，改用$this->faker->sentence() - 模型的
$fillable没包含工厂里写的字段（如is_active），导致批量赋值被拒绝 —— 工厂数据不会绕过$fillable
复杂点在于：工厂执行时机在模型实例化之后、保存之前，所有 Eloquent 事件（creating, saving）都会触发。如果这些事件里有强校验或外部依赖（比如 Redis 连接），测试环境可能静默失败 —— 记得在 TestCase 的 setUp() 中 mock 掉非核心依赖。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
