Laravel 8迁移添加外键报错（errno: 150 "Foreign key constraint is incorrectly formed"）求助

你遇到的这个错误：

SQLSTATE[HY000]: General error: 1005 Can't create table myDatabase.users (errno: 150 "Foreign key constraint is incorrectly formed") (SQL: alter table users add constraint users_profile_id_foreign foreign key (profile_id) references profile (id))

确实不是数据类型的问题——你说得对，profile.id（$table->id()生成的unsigned bigint）和users.profile_id（foreignId()生成的同类型字段）数据类型是完全一致的。问题出在两个容易被忽略的细节上：

1. 迁移文件的执行顺序搞反了 #

Laravel的迁移是严格按照文件名开头的时间戳排序执行的。你的users表需要依赖profile表的存在才能创建外键，但如果users的迁移文件时间戳比profile的更早，系统会先尝试创建users表，这时候profile表还没被创建，外键约束自然无法生效，就会抛出这个错误。

怎么修复：

• 打开database/migrations目录，检查两个迁移文件的文件名：比如2024_05_20_100000_create_profile_table.php必须比2024_05_20_100001_create_users_table.php的时间戳更早
• 如果顺序反了，你可以手动修改文件名的时间戳部分，或者先回滚已执行的迁移（php artisan migrate:rollback），调整顺序后再重新执行php artisan migrate

2. 表名的约定问题（次要但值得注意） #

Laravel Eloquent默认使用复数表名，虽然你在foreignId('profile_id')->constrained('profile')里明确指定了关联的单数表名，这部分没问题，但如果后续要在模型里建立关联，记得在Profile模型中显式指定表名，避免Eloquent自动查找复数表：

class Profile extends Model
{
    protected $table = 'profile';
}

快速验证的小技巧 #

你可以先单独执行profile表的迁移，再执行users的迁移，来确认问题是否解决：

# 先执行profile迁移
php artisan migrate --path=database/migrations/[你的profile迁移文件名].php

# 再执行users迁移
php artisan migrate --path=database/migrations/[你的users迁移文件名].php

另外提个小建议：你的profile表没有添加$table->timestamps();，虽然这不会影响外键，但如果需要记录数据的创建和更新时间，建议加上这个字段。

内容的提问来源于stack exchange，提问作者SomeRandomCode