使用SQLAlchemy on_conflict_do_update时遭遇ProgrammingError求助

咱们一步步来拆解你遇到的问题，PostgreSQL的ON CONFLICT逻辑虽然好用，但细节上容易踩坑，结合你给出的表结构，我整理了几个最可能的原因和对应的解决方案：

1. 确认insert_statement的完整写法是否正确 #

你提到修改了插入语句但没给出完整代码，大概率是on_conflict_do_update的参数配置出了问题。比如必须明确指定冲突的目标（主键或唯一约束），并且更新列时要正确引用excluded对象（PostgreSQL用来指代插入行的虚拟表）。

给你一个符合你表结构的完整示例：

from sqlalchemy import *
from sqlalchemy.dialects import postgresql
from datetime import date

metadata = MetaData()
idTagTable = Table('id_tag', metadata,
    Column('id', String(255), primary_key = True),
    Column('category', String(20), nullable = False),
    Column('createddate', Date, nullable = False),
    Column('updatedon', Date, nullable = False)
)

# 构建插入语句
insert_stmt = postgresql.insert(idTagTable).values(
    id="sample-id",
    category="demo",
    createddate=date.today(),
    updatedon=date.today()
)

# 配置冲突更新逻辑
update_stmt = insert_stmt.on_conflict_do_update(
    # 指定冲突目标：这里用主键id
    index_elements=['id'],
    # 或者用主键约束名：constraint='id_tag_pkey'（默认主键约束名是表名+_pkey）
    set_={
        # 更新category为插入的值
        "category": insert_stmt.excluded.category,
        # 更新updatedon为插入的时间
        "updatedon": insert_stmt.excluded.updatedon
        # createddate建议不更新，除非你的业务逻辑需要覆盖创建时间
    }
)

# 执行语句（假设你已经创建了engine）
with engine.connect() as conn:
    conn.execute(update_stmt)
    conn.commit()

2. 检查PostgreSQL版本是否支持ON CONFLICT #

ON CONFLICT是PostgreSQL 9.5及以上版本才支持的特性，如果你的数据库版本低于9.5，必然会报语法错误。可以执行这条SQL确认版本：

SELECT version();

3. 确认冲突目标的约束是否存在 #

如果你的错误提示是“constraint does not exist”，那可能是你指定的冲突约束名不对。比如你用constraint='some_wrong_name'，而实际表的主键约束名是id_tag_pkey（默认生成的）。可以通过这条SQL查看表的约束：

SELECT conname FROM pg_constraint WHERE conrelid = 'id_tag'::regclass;

4. 检查列的赋值是否符合约束 #

比如createddate和updatedon是NOT NULL的，你在插入或更新时有没有确保这些列都有值？如果excluded.createddate是空的，也会触发错误（不过一般插入时会传值，所以这条概率低，但也要排查）。

最后，别忘了看ProgrammingError的具体错误信息，比如是语法错误、约束不存在还是列名错误，这些信息能帮你更快定位问题。

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