PostgreSQL/psycopg2重复执行UPDATE时rowcount未返回实际变更行数

PostgreSQL 中 UPDATE 语句返回给驱动的行数统计默认规则为：统计所有满足WHERE条件的匹配总行数，而非字段值实际发生变更的行数。
只要行符合WHERE筛选规则，哪怕SET子句设置的新值和行内原有值完全一致、没有产生任何实际数据修改，该行也会被计入统计值，这是数据库层面的默认设计，和psycopg2驱动、Django框架本身没有关系。重复执行同一条值未变化的UPDATE语句时始终返回相同rowcount的现象，完全符合这个默认规则。

核心思路是让数据库仅对确实需要修改值的行执行UPDATE操作，此时返回的rowcount就是实际发生数据变更的行数，无变更时自然返回0。

原生psycopg2场景 #

修改UPDATE语句的WHERE条件，额外增加「字段当前值不等于目标值」的判断：

• 如果更新的字段不存在NULL值，可以直接加 字段 != 目标值 的过滤条件
• 如果更新的字段可能存储NULL值，使用 字段 IS DISTINCT FROM 目标值 语法做不等值判断（该语法可以正确处理NULL值的比较逻辑，不会出现NULL和任意值比较都为UNKNOWN的问题）

修正后的可直接运行的代码示例：

import psycopg2

# 建立数据库连接
conn = psycopg2.connect(
    host="localhost",
    database="test_db",
    user="postgres",
    password="123456"
)
conn.autocommit = True
cursor = conn.cursor()

# 增加值变更判断，仅更新balance不等于11的匹配行
sql = """
UPDATE test_table 
SET balance = 11 
WHERE last_block = '14529343' 
  AND balance IS DISTINCT FROM 11
"""
cursor.execute(sql)
print("实际变更行数 = ", cursor.rowcount)
conn.commit()
conn.close()

Django ORM场景 #

Django ORM的update()方法默认同样返回匹配WHERE条件的行数，要获取实际变更行数，在filter阶段通过exclude排除掉字段值已经等于目标值的记录即可，ORM会自动处理NULL值的比较逻辑，不需要额外编写特殊语法：

# 原写法：返回匹配WHERE条件的总行数，和原生SQL默认行为一致
# update_count = TestTable.objects.filter(last_block='14529343').update(balance=11)

# 修改后写法：返回实际发生值变更的行数，无变更时返回0
update_count = TestTable.objects.filter(
    last_block='14529343'
).exclude(
    balance=11
).update(balance=11)

注意：不要尝试通过修改数据库全局参数调整UPDATE的默认计数规则，这类修改会影响实例上所有运行中的业务逻辑，风险极高。直接在SQL或ORM查询中增加过滤条件，是最稳定、跨环境兼容性最好的方案。

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