PyMySQL mogrify无法处理字典列表参数的问题求助

核心问题出在 mogrify() 和 executemany() 的参数处理逻辑差异上：

为什么executemany()能正常运行？ #

executemany() 是专门为批量执行设计的方法，当传入字典列表时，它会自动遍历每个字典，将字典的键与SQL中的命名占位符（如%(key)s）匹配，逐个解析参数并执行语句。

为什么mogrify()会报错？ #

mogrify() 的默认逻辑是仅处理单组参数，它不会自动遍历参数列表。当你直接传入字典列表时，它会把整个列表当作单组参数解析，自然会抛出dict can not be used as parameter错误——因为它预期的是单个字典/元组这类单组参数，而非包含多个字典的列表。

解决方法：遍历参数列表逐个调用mogrify() #

如果要生成完整的批量INSERT SQL语句，需要手动遍历参数列表，对每个字典单独调用mogrify()，再拼接结果。示例代码如下：

import pymysql

# 数据库连接
conn = pymysql.connect(host='localhost', user='root', password='your_password', db='test_db')
cursor = conn.cursor()

# 示例INSERT语句与字典列表参数
sql = "INSERT INTO users (name, age) VALUES (%(name)s, %(age)s)"
params = [
    {'name': 'Alice', 'age': 25},
    {'name': 'Bob', 'age': 30}
]

# 生成完整批量SQL
sql_segments = [cursor.mogrify(sql, param) for param in params]
full_batch_sql = '; '.join(sql_segments) + ';'

print(full_batch_sql)  # 输出拼接后的完整SQL

# 执行语句（可选，批量执行更推荐用executemany()）
cursor.execute(full_batch_sql)
conn.commit()

# 关闭连接
cursor.close()
conn.close()

补充说明 #

如果使用%s位置占位符而非命名占位符，同样可以用遍历+逐个mogrify()的方式处理。另外，若参数数量极大，拼接后的SQL可能超出数据库的语句长度限制，这种情况仍建议使用executemany()，它会自动处理分批次执行，更安全高效。

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