使用psycopg2批量插入数据时遇TypeError：参数未全部转换为字符串

这个错误几乎都是SQL语句中的占位符数量和传入的参数数量不匹配，或者参数的结构不符合psycopg2的要求导致的。结合你给出的代码片段，我帮你梳理下常见的问题点和解决方法：

1. 先确认SQL语句的占位符是否和参数数量对应 #

psycopg2用%s作为参数占位符（注意这和Python的字符串格式化不是一回事，只是占位标记），你需要保证VALUES后的占位符数量和你要插入的列数完全一致。

比如你从record.keys()拿到了列名，那对应的SQL应该这样构造：

cols = list(record.keys())
# 把列名拼接成逗号分隔的字符串，比如"col1, col2, col3"
col_names = ", ".join(cols)
# 生成和列数相同的占位符，比如"%s, %s, %s"
placeholders = ", ".join(["%s"] * len(cols))
# 最终的INSERT语句
SQL = f"INSERT INTO your_table_name ({col_names}) VALUES ({placeholders})"

2. 检查参数ins的结构是否正确 #

你传入的ins必须是一维的元组或列表，每个元素对应一个占位符的值，顺序要和列名的顺序完全匹配。

正确的参数构造方式：

# 按列名的顺序提取record里的值，生成参数列表
ins = [record[col] for col in cols]
# 或者用元组：ins = tuple(record[col] for col in cols)

⚠️ 不要直接传record字典，也不要传嵌套的列表（比如[[val1, val2]]），psycopg2无法识别这种结构。

完整的修正代码示例 #

把这些整合到你的putTicket函数里：

data = response.json()
record = data[0]  # 表头行
cols = list(record.keys())

def putTicket(conn):
    cur = conn.cursor()
    # 构造SQL语句
    col_names = ", ".join(cols)
    placeholders = ", ".join(["%s"] * len(cols))
    SQL = f"INSERT INTO your_table ({col_names}) VALUES ({placeholders})"
    # 构造参数
    ins = [record[col] for col in cols]
    # 执行语句
    try:
        cur.execute(SQL, ins)
        conn.commit()
    except Exception as e:
        conn.rollback()
        raise e
    finally:
        cur.close()

额外注意点 #

• 如果你的列值里包含特殊字符或者SQL关键字，最好用psycopg2.sql模块来构造SQL，避免SQL注入风险：

  from psycopg2 import sql
  
  SQL = sql.SQL("INSERT INTO {} ({}) VALUES ({})").format(
      sql.Identifier("your_table"),
      sql.SQL(', ').join(map(sql.Identifier, cols)),
      sql.SQL(', ').join(sql.Placeholder() * len(cols))
  )
  

  这种方式会自动处理列名和表名的转义，更安全。

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