使用SQLAlchemy Session.execute时位置参数报错求助

你遇到的ArgumentError: List argument must consist only of tuples or dictionaries错误，核心原因是SQLAlchemy的execute方法对位置参数的格式要求：它期望接收包含行数据的元组序列（哪怕只有一行），或者字典（命名参数）。直接传递单个元组(1,2,3)会被解析成多个独立参数，而非一行的字段值。

以下是两种符合你需求（不用字典/命名参数）的正确写法：

方法1：使用MySQL原生%s占位符，传递嵌套元组 #

MySQL的DBAPI驱动（如pymysql）原生使用%s作为位置占位符，配合嵌套元组传递单条数据：

from sqlalchemy import text

query = "insert into test values(%s, %s, %s)"
values = (1, 2, 3)

# 把单条数据元组再包一层，变成元组的元组
result = session.execute(text(query), (values,))
# 或者用connection执行
# result = connection.execute(text(query), (values,))

如果是批量插入多条数据，直接传递元组列表即可：

values_list = [(1,2,3), (4,5,6)]
result = session.execute(text(query), values_list)

方法2：使用SQLAlchemy的索引式位置占位符 #

用:1、:2这种索引占位符，直接传递普通元组即可：

query = "insert into test values(:1, :2, :3)"
values = (1, 2, 3)
result = session.execute(text(query), values)

为什么之前的写法报错？ #

• 直接传values：(1,2,3)会被SQLAlchemy拆解成3个独立参数，与语句中的占位符数量匹配但格式不符合要求（需要行数据的容器）。
• 用*values：同样是传递3个独立参数，而execute对于text语句的位置参数，要么接收字典，要么接收行数据序列，因此报错。
• 用?占位符：MySQL驱动不原生支持?，需要SQLAlchemy做转换，不如直接用%s适配性更好。

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