PostgreSQL下Laravel迁移禁用外键校验失败问题求助

切换到PostgreSQL后，在Laravel迁移中尝试禁用外键校验以添加外键时，出现“relation [表名] does not exist”错误，已尝试以下方法均无效：

• 使用Laravel内置方法：

Schema::disableForeignKeyConstraints();
//...
Schema::enableForeignKeyConstraints();

• 设置会话复制角色：

\DB::statement('SET session_replication_role = \'replica\';');
//...
\DB::statement('SET session_replication_role = \'origin\';');

• 禁用/启用表触发器：

\DB::statement('ALTER TABLE tenants DISABLE TRIGGER ALL;');
//..
\DB::statement('ALTER TABLE tenants Enable TRIGGER ALL;');

环境配置：

• Postgres v15
• PHP v8.2.5
• Laravel v10
• Windows 11下的WAMP

迁移代码示例：

Schema::create('tenants', function (Blueprint $table) {
    $table->string('id')->primary();
    $table->integer('is_trial')->unsigned()->nullable()->default(0);
    
    $table->unsignedBigInteger('plan_id')->nullable()->index('plan_id');
    $table->timestamps();
    $table->json('data')->nullable();
});


\DB::statement('ALTER TABLE tenants DISABLE TRIGGER ALL;');

Schema::table('tenants',function (Blueprint $table) {
    
    $table->foreign('plan_id')->references('id')->on('plans')->deferrable(true); //->onDelete('cascade');
    
});

\DB::statement('ALTER TABLE tenants Enable TRIGGER ALL;');

1. 检查迁移执行顺序 #

Laravel按迁移文件名的时间戳顺序执行脚本。如果plans表的迁移文件时间戳晚于当前tenants的迁移文件，执行到添加外键的代码时，plans表还未创建，必然触发“relation does not exist”错误。

解决方法：调整迁移文件的时间戳前缀，确保创建plans表的迁移文件时间戳更早，让它先执行。

2. 确认表名大小写匹配 #

PostgreSQL默认会将未加引号的表名转换为小写存储。如果你的plans表实际创建时使用了大写（比如Plans），而迁移中用小写plans引用，就会找不到表。

确保所有迁移中引用的表名和实际创建的表名完全一致（建议统一使用小写）。

3. 调整迁移逻辑（同文件内创建依赖表） #

如果必须在同一个迁移文件中完成操作，需要先创建plans表，再创建tenants并添加外键：

// 先创建plans表
Schema::create('plans', function (Blueprint $table) {
    $table->unsignedBigInteger('id')->primary();
    // 其他字段...
});

// 再创建tenants表并添加外键
Schema::create('tenants', function (Blueprint $table) {
    $table->string('id')->primary();
    $table->integer('is_trial')->unsigned()->nullable()->default(0);
    
    $table->unsignedBigInteger('plan_id')->nullable()->index('plan_id');
    $table->timestamps();
    $table->json('data')->nullable();
    
    // 直接在创建表时定义外键
    $table->foreign('plan_id')->references('id')->on('plans')->deferrable(true);
});

4. 正确的外键禁用方式（针对表已存在但需修改的场景） #

如果plans表确实已存在，仍出现错误，可尝试在事务中执行迁移，并使用PostgreSQL原生命令禁用外键约束：

DB::beginTransaction();

try {
    // 禁用当前会话的外键约束检查
    DB::statement('SET CONSTRAINTS ALL DEFERRED;');
    
    Schema::table('tenants', function (Blueprint $table) {
        $table->foreign('plan_id')->references('id')->on('plans')->deferrable(true);
    });
    
    DB::commit();
} catch (\Exception $e) {
    DB::rollBack();
    throw $e;
}

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