PostgreSQL ON CONFLICT列引用歧义如何指定表列解决？

报错原因说明 #

1. 加表名前缀报错：ON CONFLICT 后的冲突目标语法仅支持传入列名、唯一约束名或索引表达式，不允许携带表名前缀，因此你写 ON CONFLICT (accesstoken.submission_id) 不符合语法规则。
2. 歧义报错原因：PL/pgSQL 解析 SQL 语句时默认遵循「变量优先级高于表列名」的规则，解析器会先扫描当前函数作用域内是否有匹配的参数/变量，哪怕你确认没有定义submission_id的变量，部分PostgreSQL版本的前置校验逻辑也会抛出歧义提示。

两种修复方案 #

方案1：给列名加双引号强制识别为表字段 #

双引号包裹的标识符会被强制识别为SQL对象（这里就是表列名），不会进入变量匹配逻辑，修改后的代码如下：

INSERT INTO assistant.accesstoken
(
    submission_id,
    token,
    expires
)
VALUES
(
    v_submission_id,
    assistant.pseudo_encrypt(v_submission_id),
    CURRENT_TIMESTAMP + v_token_duration
)
ON CONFLICT ("submission_id")
DO UPDATE SET
    expires = CURRENT_TIMESTAMP + v_token_duration
RETURNING token
INTO v_accesstoken;

这个方案改动最小，适合只需要解决单条语句歧义的场景。

方案2：配置函数级标识符解析规则 #

在函数定义时添加配置项 plpgsql.variable_conflict = use_column，指定当前函数内所有SQL语句遇到标识符歧义时，优先使用表列名，示例如下：

CREATE OR REPLACE FUNCTION assistant.evaluation_begin(in_param1 varchar, in_param2 varchar)
RETURNS varchar AS $$
DECLARE
    v_submission_id int;
    v_token_duration interval;
    v_accesstoken varchar;
BEGIN
    -- 原有函数逻辑
    -- 你的INSERT语句无需修改即可正常执行
END;
$$ LANGUAGE plpgsql
SET plpgsql.variable_conflict = use_column;

这个方案适合函数内有多条类似歧义语句的场景。

1. 为什么INSERT的冲突判定会参考PL/pgSQL变量？
   PL/pgSQL的标识符解析规则是全局生效的，不会针对语句类型做特殊处理，所有嵌入PL/pgSQL的SQL语句都会先扫描匹配当前作用域的参数、局部变量，匹配不到才会识别为表列名。ON CONFLICT后的冲突目标虽然只能是表的索引相关字段，但解析器不会跳过前置的变量匹配步骤，因此会触发歧义校验。

2. 该报错是否是PostgreSQL校验规则过于严格导致？
   这个规则不是过度严格，而是为了避免隐性逻辑错误：如果后续维护过程中有人不小心定义了不带前缀的submission_id变量，没有该校验的话，语句会优先使用变量值而不是列名，导致业务逻辑出错且难以排查。你当前使用的变量前缀命名规范已经非常规范，只需要用上面两种方案之一绕过校验即可。

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