Laravel执行迁移时报未知列'batch'错误的排查与解决
适用环境
- PHP 8.0.3 (cli NTS 构建版本)
- Composer 2.0.11
- Laravel 6.x / 7.x / 8.x 全版本均可复现该问题
- MariaDB 10.5.9(Manjaro 官方源版本)
- Linux 5.4.105-1-MANJARO 内核
异常表现
在任意项目下执行./artisan migrate或php artisan migrate命令时,无论项目内是否存在自定义迁移文件,都会抛出Illuminate\Database\QueryException,核心报错信息为:
SQLSTATE[42S22]: Column not found: 1054 Unknown column 'batch' in 'order clause' (SQL: select
migrationfrommigrationsorder bybatchasc,migrationasc)
复现验证流程
- 通过
composer create-project laravel/laravel mig "8.x"创建全新的原生Laravel项目,无任何自定义代码修改 - 修改
.env文件中的数据库连接配置:DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=laravel DB_USERNAME=实际数据库账号 DB_PASSWORD=实际数据库密码 - 配置完成后验证报错逻辑:
- 若填写错误的数据库账号/密码,会正常触发1045访问拒绝异常,报错为:
SQLSTATE[HY000] [1045] Access denied for user 'xxx'@'localhost' (using password: NO) (SQL: select * from information_schema.tables where table_schema = laravel and table_name = migrations and table_type = 'BASE TABLE')
- 仅当数据库连接信息完全正确时,才会触发上述
batch列不存在的迁移报错
- 若填写错误的数据库账号/密码,会正常触发1045访问拒绝异常,报错为:
测试过程中确认:项目内Query Builder、Eloquent ORM功能均可正常使用,仅迁移系统存在异常。
问题根因
目标数据库内已存在由其他自建PHP框架创建的同名称migrations表,因复用同一MySQL账号、同一数据库运行多个项目,不同框架的迁移表结构存在不兼容:Laravel迁移系统默认要求migrations表必须包含batch字段,而非Laravel框架生成的同名字段表无该字段,因此触发查询报错。
解决步骤
- 查看目标数据库内的所有现有表,执行命令:
mysql -u 你的数据库用户名 -p'你的数据库密码' 目标数据库名 -e "SHOW TABLES" - 定位结构不兼容的旧
migrations表,执行删除命令:mysql -u 你的数据库用户名 -p'你的数据库密码' 目标数据库名 -e "DROP TABLE migrations" - 回到Laravel项目根目录,重新执行
./artisan migrate即可正常完成迁移流程。
内容的提问来源于stack exchange,提问作者alirezaarzehgar

