应先检查migrations表中最新记录是否匹配待执行迁移文件名,再验证对应表是否存在;若表未建但记录已存,则删该记录后重跑migrate;若表已建但记录缺失,则手动插入记录;若表结构不全,则先删表再删记录并重跑。

直接删掉 failed_jobs 表里卡住的记录并不能解决迁移卡住的问题——真正要动的是 migrations 表和对应数据库结构的不一致状态。
确认哪条迁移卡住了
打开 phpMyAdmin,选中 Laravel 项目对应的数据库,点击 migrations 表,按 batch 降序、id 降序排列。最后一条记录就是最新执行的迁移;如果它没对应上你刚运行的 php artisan migrate 命令想执行的文件名(比如 2024_05_20_103000_create_orders_table.php),就说明迁移中途失败并残留了部分状态。
- 检查该行
migration字段值是否匹配你预期执行的文件名前缀(不含.php) - 同时看
batch值:正常情况下,一次migrate会把所有待执行迁移塞进同一个 batch;如果 batch 编号跳变或重复,大概率是上次中断导致的 - 用 SQL 查询验证表是否存在:
SHOW TABLES LIKE 'orders';—— 如果表不存在,但migrations表里已有记录,说明 migration 方法里的up()没跑完,但记录已写入
手动清理迁移记录的三种情况
不要盲目删整条记录。先判断失败点在哪:
-
情况一:表没建成功,但
migrations表已插入记录 → 删除该行,再重跑php artisan migrate -
情况二:表建好了,但
migrations表漏写了记录 → 手动 INSERT 一行,migration填文件名前缀,batch填当前最大 batch 值 + 1(查SELECT MAX(batch) FROM migrations;) -
情况三:表只建了一半(比如字段少加了一个),
migrations表有记录 → 先DROP TABLE orders;,再删migrations表对应行,再重跑
注意:Laravel 不校验 migration 字段内容是否真实存在文件,所以填错名字会导致后续 rollback 失败。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
phpMyAdmin 里操作 migrations 表的注意事项
在 phpMyAdmin 中直接编辑 migrations 表风险较低,但必须避开几个坑:
- 别用「编辑」图标改
batch值:不同迁移应属同一 batch,乱改会导致php artisan migrate:rollback回滚错范围 - 删除记录前,先导出该行数据(点击「导出」→ 选中该行 → 格式选 SQL)作为备份
-
id是自增主键,不要手动改;Laravel 迁移逻辑不依赖它,只用migration+batch定位 - 如果项目启用了多数据库连接,确认你在 phpMyAdmin 里打开的是
DB_DATABASE配置指向的那个库,不是information_schema或其他测试库
修复后务必验证一致性
清理完 migrations 表,别急着开发。执行这两步验证:
- 运行
php artisan migrate:status—— 看输出里有没有R(rolled back)或P(pending)标记异常,尤其是你刚处理过的那条 - 运行
php artisan migrate --pretend—— 它会打印接下来要执行哪些迁移,确认列表干净且顺序正确 - 如果之前用过
--force或绕过环境检查,现在清掉bootstrap/cache/config.php和bootstrap/cache/packages.php,避免缓存干扰
最常被忽略的是:迁移文件里用了 Schema::create('orders', function (Blueprint $table),但实际表名在数据库里是 order(少了个 s)——这种拼写差异不会报错,但会导致模型查询失败,而 phpMyAdmin 里根本看不出问题。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










