如何在Laravel迁移中为PostgreSQL唯一索引新增字段？

使用Laravel 12和PostgreSQL 17开发应用，现有posts表通过如下迁移创建，其中action_id和number字段设置了唯一索引：

Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->foreignId('action_id')->constrained('actions')->cascadeOnDelete();
    $table->unsignedSmallInteger('number');
    $table->string('name');
    $table->timestamps();

    $table->unique(['action_id', 'number']);
});

现在需要新增type字段并将其加入该唯一索引，编写了如下迁移代码尝试实现：

public function up(): void
{
    Schema::table('posts', function (Blueprint $table) {

        if($this->hasIndex("posts", 'posts_action_id_number_unique')) {
            echo '::TRY DELETE::'. "<br>";
            $table->dropIndex('posts_action_id_number_unique');
        }
        $table->unique(['action_id', 'type', 'number']);
    });
}

private function hasIndex(string $table, string $column): bool
{
    $indexes = Schema::getIndexes($table);
    echo count($indexes).'::$indexes::'.print_r($indexes,true);

    foreach ($indexes as $index) {
        if ($column === $index['name']) {
            return true;
        }
    }
    return false;
}

public function down(): void
{
    Schema::table('posts', function (Blueprint $table) {
        $table->dropIndex(['action_id', 'type', 'number']);
    });
}

执行时出现错误：

SQLSTATE[2BP01]: Dependent objects still exist: 7 ERROR:  cannot drop index posts_action_id_number_unique because constraint posts_action_id_number_unique on table posts requires it
HINT:  You can drop constraint posts_action_id_number_unique on table posts instead.

错误原因 #

在PostgreSQL中，通过$table->unique()创建的唯一约束会自动生成同名索引，该索引是依赖唯一约束存在的，因此不能直接删除索引，必须先删除对应的唯一约束。

修正后的迁移代码 #

public function up(): void
{
    Schema::table('posts', function (Blueprint $table) {
        // 1. 新增type字段（可根据实际需求调整字段类型、是否可空等属性）
        $table->string('type')->nullable();

        // 2. 删除原有的唯一约束（而非索引）
        $table->dropUnique(['action_id', 'number']);

        // 3. 创建包含type字段的新唯一约束
        $table->unique(['action_id', 'type', 'number']);
    });
}

public function down(): void
{
    Schema::table('posts', function (Blueprint $table) {
        // 1. 删除新增的唯一约束
        $table->dropUnique(['action_id', 'type', 'number']);

        // 2. 恢复原来的唯一约束
        $table->unique(['action_id', 'number']);

        // 3. 删除新增的type字段
        $table->dropColumn('type');
    });
}

关键说明 #

• 无需自定义索引检查方法：Laravel的Schema构建器会自动处理约束存在性校验，直接调用dropUnique即可，避免手动判断的冗余。
• 操作顺序不可颠倒：必须先新增type字段，否则创建新唯一约束时会因字段不存在报错。
• 回滚逻辑要完整：down方法需按逆序执行操作，保证回滚后表结构与迁移前完全一致。

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