Laravel Upsert在MySQL正常但PostgreSQL报错问题求助

Laravel的upsert方法底层会根据数据库类型生成不同SQL语法：

• MySQL用ON DUPLICATE KEY UPDATE，允许在更新子句中直接使用具体值；
• PostgreSQL用ON CONFLICT ... DO UPDATE，要求引用待插入的新值时必须通过EXCLUDED前缀（代表冲突时原本要插入的行数据）。

你的代码在MySQL正常但PostgreSQL报错，核心原因是更新参数传入了具体值而非列引用，Laravel生成的SQL会把这些值当成列名——比如生成类似ON CONFLICT (transaction_id) DO UPDATE SET amount = 100的语句，PostgreSQL会将100识别为列名，从而抛出「Undefined column」异常。

1. 确保唯一约束存在 #

先确认mobile_money_statements表中，upsert第二个参数指定的列（比如transaction_id）已创建唯一约束，PostgreSQL要求ON CONFLICT子句必须针对带唯一约束的列：

// 迁移文件中添加唯一索引
$table->unique('transaction_id');

2. 正确编写更新逻辑 #

针对PostgreSQL，更新部分需通过EXCLUDED前缀引用待插入的新值，有两种可行写法：

写法一：用DB::raw显式引用EXCLUDED

use Illuminate\Support\Facades\DB;

MobileMoneyStatement::upsert(
    $transactionData, // 待插入/更新的数据集
    ['transaction_id'], // 唯一约束列
    [
        'amount' => DB::raw('EXCLUDED.amount'),
        'status' => DB::raw('EXCLUDED.status'),
        'updated_at' => now()
    ]
);

写法二：Laravel 9+ 简洁写法（直接传列名数组）

Laravel 9及以上版本支持直接传入需要更新的列名数组，框架会自动转换为EXCLUDED引用：

MobileMoneyStatement::upsert(
    $transactionData,
    ['transaction_id'],
    ['amount', 'status', 'updated_at']
);

3. 硬编码固定值的处理 #

如果更新时需要设置固定值，必须用DB::raw包裹，避免被PostgreSQL识别为列名：

['status' => DB::raw("'completed'")]

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