根本原因是Laravel默认索引名过长导致MySQL 5.7以下版本报错，解决方法是在AppServiceProvider中通过setIndexNameGenerator自定义短索引名生成逻辑，并配合显式命名、清缓存及验证环境。
MySQL 5.7 以下版本迁移报错 SQLSTATE[42000]: Syntax error or access violation
根本原因是 Laravel 默认生成的索引名太长（比如 users_email_verified_at_index 拼上表前缀后超 64 字符），而旧版 MySQL 对索引名长度限制严格。Laravel 9+ 默认用 innodb_large_prefix=ON 假设环境支持，但很多生产环境仍是 MySQL 5.6 或阿里云 RDS 默认关着这个选项。
- 别急着改 MySQL 配置——很多共享主机或老 RDS 实例根本没法开
innodb_large_prefix - 真正可控的解法是让 Laravel 生成更短的索引名，不是靠数据库妥协
- 关键不在迁移文件里写什么，而在
App\Providers\AppServiceProvider里重写命名逻辑
覆盖 Illuminate\Database\Schema\Builder 的默认索引命名规则
Laravel 不提供配置项直接改索引前缀，但允许你替换底层的命名策略类。核心是把默认的 createIndexName 方法换成自己控制长度的版本。
- 在
App\Providers\AppServiceProvider::boot()里加：use Illuminate\Database\Schema\Builder;<br>Builder::defaultStringLength(191); // 先确保 varchar 索引能建（常被忽略）<br>Builder::setIndexNameGenerator(function ($table, $column, $type) {<br> $index = strtolower($type . '_' . str_replace(['-', '_'], '', $table));<br> $index = substr($index, 0, 48) . '_' . md5($table . $column . $type)[0, 8];<br> return $index;<br>}); - 注意：这个回调必须在所有迁移执行前注册，否则已有迁移不会生效
-
md5(...)[0, 8]是 PHP 8.0+ 语法；若用低版本，改用substr(md5(...), 0, 8)
迁移中手动指定索引名比依赖默认更可靠
自动命名省事但不可控，尤其当字段名含下划线、表名本身很长（如 tenant_organization_user_permissions）时，再短的策略也容易撞上限。显式命名才是稳定方案。
- 建索引时直接传字符串名：
$table->index('email', 'idx_users_email'); - 联合索引也一样：
$table->index(['user_id', 'status'], 'idx_user_status');
- 删除时也得对应上：
$table->dropIndex('idx_users_email'); - 别用
dropPrimary()或dropUnique()这类“智能”方法——它们内部仍会拼名字，照样可能超长
部署时 php artisan migrate 仍失败？检查缓存和旧迁移记录
即使改了命名策略，已存在的迁移如果之前失败过，migrations 表里可能残留半截记录，下次跑会跳过或冲突；另外 Laravel 会缓存 schema，导致新策略不生效。
- 先清缓存：
php artisan config:clear && php artisan cache:clear
- 删掉
migrations表里最后几条失败记录（别全清！只清最近一两条） - 如果之前迁移已部分执行成功（比如建了表但没建索引），手动补上索引再删掉那行迁移记录，避免重复执行
- 本地测试务必用跟生产一致的 MySQL 版本，Docker 可配
mysql:5.7镜像验证
setIndexNameGenerator 最好一开始就加进模板项目里。 
