最省事的是 User::factory()->count(50)->create(),但需注册工厂、显式调用 Seeder、区分 make()/create()、处理时间/唯一性/外键等细节,否则易失败。

直接用 User::factory()->count(50)->create() 最省事,但不注册工厂、不手动调用、不处理时间字段或唯一性,八成会失败。
Seeder 类没被调用?检查 DatabaseSeeder::run() 里有没有 $this->call(UserSeeder::class)
Laravel 6+ 的 DatabaseSeeder.php 默认是空的,不会自动扫描或执行你新建的 UserSeeder。运行 php artisan db:seed 却没反应,大概率就是这一步漏了。
- 必须在
DatabaseSeeder::run()中显式调用:$this->call(UserSeeder::class) - 多个 Seeder 要按依赖顺序排列,比如先
RoleSeeder再UserSeeder,否则外键约束报错 - 如果只跑单个,用
php artisan db:seed --class=UserSeeder可绕过DatabaseSeeder,但上线前别依赖这个
用模型工厂批量插入时,->make() 和 ->create() 别搞混
->make() 只生成内存对象,不写库;->create() 才真正执行 INSERT。这是最常卡住新手的地方。
- 工厂未注册会报
Factory for [App\Models\User] is not defined,确认database/factories/UserFactory.php存在且命名空间正确 - 模型启用了
$fillable但字段漏写,create()会抛MassAssignmentException - 关联字段别硬填 ID,用
User::factory()->has(Profile::factory()->count(1))->create(),让 Laravel 自动处理外键
大批量数据(>1000 条)别用 Eloquent,改用 DB::table()->insert()
每条 create() 都触发模型事件、类型转换、验证,1000 条就是 1000 次查询 + 开销,容易 OOM 或超时。
- 构造二维数组,键名必须和数据库字段完全一致,比如
'email_verified_at' => now(),不能传字符串'2026-04-17' -
deleted_at字段为 NULL 时,得传null,不是字符串'null',否则 MySQL 报Data truncated for column 'deleted_at' - 时间字段优先用
now()或$this->faker->dateTimeThisYear(),避开微秒精度、时区转换导致的截断问题
唯一字段(如 email)批量冲突?重置 Faker 的 unique 缓存
Faker 的 $this->faker->unique()->safeEmail() 默认只在当前批次内去重,跨批次或多次运行 db:seed 就可能重复。
- 加
true参数启用全局缓存:$this->faker->unique(true)->safeEmail() - 或者每次填充前清空:在 Seeder 开头加
$this->faker->unique(true)->clear(); - 更稳妥的做法是不用 Faker 唯一性,改用
str()->random(10).'@example.com'拼接,彻底规避冲突
真正麻烦的不是写几行 insert(),而是字段类型、NULL 约束、时间精度、外键顺序这些细节——它们不会报语法错误,但会让你在 php artisan db:seed 后对着空表发呆十分钟。


















