执行 php artisan migrate --seed 时因 modules 表缺失导致 SQL 错误，根本原因通常是迁移记录残留而实际表未创建，本文提供安全、可复现的清理与重迁方案。
执行 `php artisan migrate --seed` 时因 `modules` 表缺失导致 sql 错误，根本原因通常是迁移记录残留而实际表未创建，本文提供安全、可复现的清理与重迁方案。
在 Laravel 开发中，php artisan migrate --seed 命令会先执行所有未运行的迁移（migrate），再调用数据库填充器（seeder）。但当出现类似以下错误：
SQLSTATE[42S02]: Base table or view not found: 1146 Table 'naryn.modules' doesn't exist (SQL: select * from `modules` where `module` = admin/backup_v2 limit 1)
这表明：Seeder 已启动，但依赖的 modules 表尚未存在——迁移阶段实际未成功创建该表。
? 根本原因分析
最常见的情形是：
- 你曾手动删除过数据库表（如 DROP TABLE modules;），但未清空 migrations 表；
- Laravel 认为 create_modules_table 迁移“已执行”（因其记录仍在 migrations 表中），因此跳过该迁移；
- 随后 Seeder 尝试查询 modules 表时直接报错。
⚠️ 注意：Laravel 的迁移机制仅依赖 migrations 表中的 migration 字段（如 2023_05_10_120000_create_modules_table.php）判断是否执行，不校验物理表是否存在。
Laravel Cloud下载Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
✅ 推荐解决方案（开发环境适用）
步骤 1：彻底重置数据库
# ① 清空当前数据库（确保无重要数据！） php artisan db:wipe --force # ② 重新运行全部迁移 + 填充（等价于首次安装） php artisan migrate --seed
? db:wipe 命令会删除所有表（含 migrations 和 failed_jobs 等系统表），并重置迁移状态，是最干净的起点。
替代方案（需保留部分数据？谨慎使用）
若需选择性修复（例如仅重建 modules 表）：
# 查看哪些迁移已标记为完成
php artisan migrate:status
# 手动删除 modules 相关迁移记录（假设文件名为 ...create_modules_table.php）
DB::table('migrations')->where('migration', 'like', '%create_modules_table%')->delete();
# 再次运行迁移（此时会补上 modules 表）
php artisan migrate
# 最后单独运行 Seeder（避免重复填充）
php artisan db:seed --class=ModuleSeeder
? 关键注意事项
- ✅ 仅在开发/测试环境使用 db:wipe；生产环境必须使用增量迁移（php artisan make:migration fix_missing_modules_table）并编写回滚逻辑。
- ✅ 运行前确认 config/database.php 中的数据库连接配置正确，且用户拥有 DROP 权限。
- ✅ 若使用 SQLite，直接删除 database/database.sqlite 文件即可重置。
- ✅ 建议将核心迁移与 Seeder 解耦：Seeder 中增加表存在性检查（非必需，但更健壮）：
if (Schema::hasTable('modules')) { DB::table('modules')->insert([...]); }
通过以上步骤，可快速定位并根治“表不存在却跳过迁移”的典型陷阱，确保 migrate --seed 流程可靠执行。
