在QtSQL搭配PostgreSQL时捕获未绑定的命名占位符

要解决命名占位符未绑定值时自动插入NULL的问题，你可以通过提取SQL中的所有命名占位符，再和已绑定的参数对比，找出遗漏的项。具体实现步骤如下：

1. 提取SQL语句中的命名占位符 #

PostgreSQL的命名占位符格式为:占位符名称，可以用正则表达式匹配所有符合格式的占位符。注意要排除SQL字符串常量中意外出现的:xxx（比如SELECT * FROM users WHERE note = 'hello:world'里的:world不是占位符），如果业务场景中这类情况很少，可先使用基础正则，有需要再优化。

示例代码：

import re

def extract_named_placeholders(sql):
    # 匹配不在单引号内的:xxx格式占位符
    pattern = r"(?<!'):([a-zA-Z0-9_]+)(?!')"
    matches = re.findall(pattern, sql)
    # 去重，同一占位符多次出现只算一次
    return list(set(matches))

2. 获取QSqlQuery中已绑定的参数 #

使用QSqlQuery.boundValues()方法可获取所有已绑定的参数，返回一个字典，键是不带冒号的占位符名称，值为绑定的内容。

3. 对比找出未绑定的占位符 #

将提取到的占位符列表和已绑定参数的键集合对比，找出不在已绑定集合中的占位符，这些就是未绑定的项。

完整示例：

from PyQt5.QtSql import QSqlQuery
import re

def extract_named_placeholders(sql):
    pattern = r"(?<!'):([a-zA-Z0-9_]+)(?!')"
    matches = re.findall(pattern, sql)
    return list(set(matches))

def check_missing_placeholders(query):
    sql = query.lastQuery()
    all_placeholders = extract_named_placeholders(sql)
    bound_params = query.boundValues().keys()
    # 筛选未绑定的占位符
    missing = [ph for ph in all_placeholders if ph not in bound_params]
    return missing

# 使用示例
query = QSqlQuery()
sql = "INSERT INTO users (name, age, email) VALUES (:name, :age, :email)"
query.prepare(sql)
query.bindValue(":name", "Alice")
query.bindValue(":age", 30)
# 故意不绑定:email

missing = check_missing_placeholders(query)
if missing:
    print(f"未绑定的命名占位符：{', '.join(missing)}")
    # 此处可抛出异常或终止执行
else:
    query.exec_()

注意事项 #

• 若SQL中存在字符串常量包含:xxx的情况，基础正则会误判，可优化正则逻辑，或提前移除所有字符串常量后再匹配。
• 需确保调用check_missing_placeholders前，已执行query.prepare()和所有bindValue()操作，否则无法获取正确的SQL和绑定参数。
• 同一占位符多次出现时，只要绑定一次就会被识别为已绑定，符合Qt的绑定规则。

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