先查 migrations 表定位迁移文件名，再检查其 up() 中 Schema::table()/create() 的字段定义顺序、foreignId 使用及类名匹配性，并确认 defaultStringLength 是否在 AppServiceProvider boot() 中正确设置。
报错信息里找不到迁移文件名？先查 migrations 表
执行 php artisan migrate 报 SQL 语法错误（比如 SQLSTATE[42000]: Syntax error or access violation: 1064）但终端没显示具体是哪个迁移文件出问题，说明错误发生在 SQL 层，Laravel 框架还没来得及打印上下文。这时候别急着翻代码，先连数据库查 migrations 表：
-
SELECT * FROM migrations ORDER BY id DESC LIMIT 5;—— 看最后几条记录的migration字段值，它就是刚执行（或试图执行）的迁移文件名 - 把查到的文件名（如
2023_05_10_142300_add_status_to_posts.php）直接去database/migrations/下打开，重点盯up()方法里的Schema::table()或Schema::create()块 - 如果该文件在
migrations表里有记录，但对应表/字段在数据库中并不存在，大概率是up()执行到一半失败了，而 Laravel 已写入记录 —— 这种情况要结合下一条判断
“CREATE TABLE `xxx` ()” 空括号错误？检查中间表字段定义顺序
错误信息里出现类似 CREATE TABLE `movie_actor` () 这种空括号，基本锁定为中间表（pivot table）迁移写法错误。根本原因是：你调用了 $table->foreign('user_id')，但前面没定义 user_id 这个列。
- 错误写法：
$table->foreign('user_id')->references('id')->on('users');——foreign()只声明外键约束，不创建字段 - 正确写法（推荐 Laravel 8+）：
$table->foreignId('user_id')->constrained();—— 一行自动建列 + 加外键 - 兼容写法（需手动配对）：
$table->unsignedBigInteger('user_id'); $table->foreign('user_id')->references('id')->on('users'); - 注意：所有中间表迁移都必须先定义列（
unsignedBigInteger、bigIncrements等），再加外键；顺序颠倒必报 1064
Migration 类名和文件名不匹配？PHP 解析器会静默跳过
终端显示 Nothing to migrate，但你明明刚加了迁移文件，或者某次报错后重试始终不生效 —— 很可能是类名与文件名不一致，导致 Autoloader 根本没加载这个类，Laravel 就当它不存在。
- 文件名是
2024_08_17_103000_create_listings_table.php，那类名必须是CreateListingsTable - 大小写敏感：Linux/macOS 下
createlistingstable和CreateListingsTable是两个类，后者才被识别 - 命名含下划线：文件名里
add_avatar_to_users→ 类名应为AddAvatarToUsers，不是Add_avatar_to_users - 验证方法：运行
composer dump-autoload后，再执行php artisan migrate --pretend，看输出里是否列出你的文件；没列出来就是类名/命名空间问题
报错指向 migrations 表本身？说明 defaultStringLength 没生效
错误如 SQLSTATE[22001]: String data, right truncated: 1406 Data too long for column 'migration' at row 1，这和你的业务表无关，是 Laravel 自己的 migrations 表字段长度不够 —— 它由框架首次运行时自动生成，且无法用普通迁移修改。
- 核心原因：
Schema::defaultStringLength(191)没在AppServiceProvider::boot()中设置，或设置位置不对（比如写在register()里） - 必须确保该行代码在
boot()方法内，且在任何Schema::create()调用之前执行 - 已出错时不能只改代码：先删掉
migrations表（开发环境），再跑php artisan migrate:fresh，否则旧表结构残留，新配置无效 - 这个坑容易被忽略，因为错误看起来像数据问题，实际是初始化阶段的字符集适配没做对
