Laravel迁移中unique()约束未生效问题排查

核心原因 #

你的迁移代码存在链式调用顺序错误，导致unique()约束没有被应用到列上：

• 当调用references('id')->on('myschema.users')后，Laravel迁移构建器会切换到外键约束配置模式，后续的nullable()、unique()方法都是针对外键约束而非列本身操作的。
• 外键约束不支持unique()属性，所以这个调用完全无效，数据库自然不会生成列的唯一约束。
• 同时你重复使用了references()->on()和constrained()，后者会覆盖前者的外键配置，进一步干扰了约束的创建流程。

正确写法 #

调整调用顺序，先设置列的属性（nullable、unique），再配置外键约束，且二选一使用constrained()或手动references()->on()：

方式1：使用constrained()（推荐）

$table->foreignId('child_id')
      ->nullable()
      ->unique()
      ->constrained('myschema.users');

方式2：手动配置外键

$table->foreignId('child_id')
      ->nullable()
      ->unique()
      ->references('id')
      ->on('myschema.users');

验证方法 #

修改迁移代码后，重新执行迁移：

php artisan migrate:refresh

之后在PgAdmin中查看该列的约束，就能看到已生效的唯一约束了。

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