Laravel迁移与Seeder使用技巧

Laravel的Seeder看似简单，实则暗藏诸多易踩坑点：表为空往往不是代码写错，而是迁移未执行、唯一索引冲突导致静默失败，或Laravel 10+中调用方式变更（必须new实例调用run()）、工厂函数误用等；安全重跑需手动truncate并处理外键约束；批量插入切忌循环create，应改用DB::table()->insert()或分批处理以提升性能；更易被忽视的是默认事务行为——手动开启嵌套事务可能破坏回滚机制。掌握这些关键细节，才能让数据填充真正可靠、高效、可维护。

Seeder 不会自动建表，也不会清空旧数据；跑完 php artisan db:seed 表还是空的，八成是迁移没跑、表不存在，或者唯一索引冲突卡住了插入。

为什么 db:seed 后表里没数据

最常见原因不是代码写错了，而是执行前提没满足：

• php artisan migrate 没执行过 → 表根本不存在，UserSeeder 插入时静默失败（Laravel 9+ 默认不抛异常）
• 表存在但已有数据 → email 字段设了 unique()，而 Seeder 又插重复邮箱，整批插入中断，且无提示
• Seeder 类名拼错或命名空间没引入 → $this->call(UserSeeder::class) 中类不存在，artisan 直接跳过，不报错
• Laravel 10+ 中误用 factory() 函数 → 已移除，必须改用 fake()->email() 等，否则报 Call to undefined function factory()

如何安全地重跑 Seeder（清空 + 填充）

--force 参数不会自动 truncate 表，它只是绕过环境检查，真要“重来一遍”，得自己动手清理：

• 在 Seeder 的 run() 开头加：DB::table('users')->truncate();（推荐，快且跨引擎兼容）
• 或用原生语句：DB::statement('TRUNCATE TABLE users');（MySQL 下更快，但 SQLite 不支持）
• 避免用 Model::query()->delete() → 会触发模型事件、软删除判断，慢且可能意外跳过
• 如果表有外键约束，先关外键检查：DB::statement('SET FOREIGN_KEY_CHECKS=0');，再 truncate，最后恢复

DatabaseSeeder 怎么正确调用子 Seeder（Laravel 10+）

新版不再支持 $this->call(UserSeeder::class)，必须用 new 实例化并显式调用 run()：

• 先 use Database\Seeders\UserSeeder;（路径按实际文件位置写）
• 在 DatabaseSeeder::run() 中写：(new UserSeeder())->run();
• 别传字符串 'UserSeeder' 或 UserSeeder::class → Laravel 找不到类，报 Class "UserSeeder" does not exist
• 子 Seeder 里别写 DB 插入逻辑 → 它只负责一张表，调度交给 DatabaseSeeder，否则后续没法单独跑某个 Seeder

批量插入太慢？别用循环 create()

10 条数据用 User::create() 没问题，1000 条就会明显卡顿，因为每条都走模型生命周期、验证、事件、单条 SQL：

• 提速首选：DB::table('users')->insert($data);（$data 是二维数组，字段名必须和数据库列名完全一致）
• 想保留模型逻辑（比如触发 creating）？先 User::unguard(); 关闭批量赋值保护，再用 User::insert($data);
• 数据超 500 条建议分批：collect($data)->chunk(500)->each(fn ($chunk) => DB::table('users')->insert($chunk));，防内存溢出
• 用 fake()->unique()->email() 时小心：重复次数超限会抛 Maximum retries of unique generator reached，小批量可用，大批量建议手动去重或换策略

Seeder 最容易被忽略的点是：它默认在事务里运行，出错自动回滚 —— 这挺好，但如果你在 run() 里手动加了 DB::beginTransaction()，就可能套叠事务，导致 rollback 失效或锁表。真要控制事务边界，优先用 DB::transaction(fn () => { ... }) 包裹整块逻辑。

到这里，我们也就讲完了《Laravel迁移与Seeder使用技巧》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Laravel的知识点！