Python SQLite多列同名时绑定参数执行UPDATE无效果问题排查

我有如下UPDATE查询语句：

UPDATE table1 SET name = ?, surname = ?, birth_date = ?, sex = ? WHERE name = ? AND surname = ?

我通过Python的sqlite3包执行该查询，使用的方法如下：

def _connect_and_execute(query, data=None):
    conn = None
    try:
        conn = sqlite3.connect(DB_FILE_PATH)
        cur = conn.cursor()
        if data is None:
            cur.execute(query)
        else:
            cur.execute(query, data)
        conn.commit()
    except sqlite3.Error as e:
        logging.error(e)
        raise e
    finally:
        if conn:
            conn.close()

DB_FILE_PATH是存储SQLite数据库文件路径的常量。调用该方法时，传入上述查询语句作为query参数，传入列表["John", "Johnson", "01/01/2000", "M", "John", "Johnson"]作为data参数。

查询执行无报错，但数据库中的对应记录并未更新（已通过数据库工具和SELECT语句确认该记录存在）。我猜测问题在于name和surname列两次被用于绑定参数。根据SQLite官方文档，理论上可以通过索引绑定参数，于是我将查询语句修改为：

UPDATE table1 SET name = ?1, surname = ?2, birth_date = ?3, sex = ?4 WHERE name = ?5 AND surname = ?6

但问题依旧存在。请问是否支持对同一列两次绑定参数？这是否是导致问题的原因？若为是，可行的解决方案是什么？

是否支持同一列两次绑定参数？ #

SQLite完全支持同一列多次绑定参数，不管是使用匿名占位符?还是带索引的?N格式，这都不是你遇到的问题根源。

问题的可能原因 #

1. 日期格式不兼容：SQLite对日期类型的列通常默认识别YYYY-MM-DD格式，你传入的01/01/2000属于MM/DD/YYYY格式，虽然不会触发报错，但可能导致数据写入异常；另外也可能是你操作的数据库文件和验证的不是同一个。
2. 数据库路径不匹配：DB_FILE_PATH指向的文件可能和你用数据库工具打开的不是同一个，导致你误以为记录没更新。
3. 字符串匹配问题：name或surname存在大小写、前后空格等差异，比如数据库中记录是john，你传入的是John，SQLite默认区分大小写，导致WHERE条件未匹配到记录。

可行解决方案 #

• 统一日期格式：将传入的日期转换为YYYY-MM-DD格式，比如修改数据列表为["John", "Johnson", "2000-01-01", "M", "John", "Johnson"]，也可以用Python的datetime模块做格式转换：

  from datetime import datetime
  raw_date = "01/01/2000"
  formatted_date = datetime.strptime(raw_date, "%m/%d/%Y").strftime("%Y-%m-%d")
  data = ["John", "Johnson", formatted_date, "M", "John", "Johnson"]
  

• 验证数据库路径：打印DB_FILE_PATH的具体值，确认和数据库工具打开的文件路径完全一致。
• 添加调试输出：在执行UPDATE后打印cur.rowcount，查看实际更新的行数。如果结果为0，说明WHERE条件未匹配，需要检查字符串的大小写、空格等细节：

  cur.execute(query, data)
  print(f"实际更新行数: {cur.rowcount}")
  conn.commit()
  

• 改用主键匹配：如果table1有主键（如id），优先用主键作为WHERE条件，既能避免字符串匹配问题，又能提升执行效率。

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