PostgreSQL+PHP中INSERT ON CONFLICT报错：id列引用歧义排查

首先看你的错误信息：SQLSTATE[42702]: Ambiguous column: 7 ERROR: column reference "id" is ambiguous，问题出在ON CONFLICT DO UPDATE子句里的WHERE id = '".$var_id."'这部分——PostgreSQL无法判断这里的id是来自你要插入的新数据，还是目标表species里的现有数据，所以抛出了歧义错误。

两种修复方案： #

方案1：明确指定列所属的表

把WHERE子句里的id改成species.id，让数据库清楚你指的是目标表的id：

$sql = "INSERT INTO species (id, match, full_name) 
        VALUES ('".$var_id."','".$var_match."','".$var_full_name."')
        ON CONFLICT (id) DO UPDATE 
        SET match = '".$var_match."', full_name = '".$var_full_name."' 
        WHERE species.id = '".$var_id."'";

方案2：去掉多余的WHERE子句（更推荐）

其实在ON CONFLICT (id)已经指定了冲突的唯一列是id，PostgreSQL会自动定位到冲突的那一行进行更新，完全不需要额外加WHERE子句。这样写更简洁，也从根源上避免了列歧义：

$sql = "INSERT INTO species (id, match, full_name) 
        VALUES ('".$var_id."','".$var_match."','".$var_full_name."')
        ON CONFLICT (id) DO UPDATE 
        SET match = '".$var_match."', full_name = '".$var_full_name."'";

额外重要提醒：防范SQL注入 #

你现在直接把变量拼接到SQL语句里的做法非常危险，很容易遭受SQL注入攻击。建议改用PDO的预处理语句，通过参数绑定来传递变量：

$sql = "INSERT INTO species (id, match, full_name) 
        VALUES (:id, :match, :full_name)
        ON CONFLICT (id) DO UPDATE 
        SET match = :match, full_name = :full_name";

$stmt = $pdo->prepare($sql);
$stmt->execute([
    'id' => $var_id,
    'match' => $var_match,
    'full_name' => $var_full_name
]);

这样既安全，又能避免手动处理引号转义的问题，代码也更易维护。

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