Python向PostgreSQL同表多列插入同一值时参数转换错误求助

这个错误的核心原因是SQL语句中的占位符数量和你传入的参数数量不匹配——哪怕是同一个值，每一列的占位符都需要对应一个参数。下面直接给你错误示例和修复方案：

错误代码示例（你可能踩的坑） #

import psycopg2
from decimal import Decimal

# 连接数据库
conn = psycopg2.connect("dbname=test_db user=your_user password=your_pass host=localhost")
cur = conn.cursor()

test_value = Decimal('99.99')
# 问题：3个占位符，但只传了1个参数，导致参数不匹配
cur.execute("INSERT INTO test_node (col_a, col_b, col_c) VALUES (%s, %s, %s)", (test_value,))

conn.commit()
cur.close()
conn.close()

修复方案1：直接重复传入参数 #

针对单条插入，给每个占位符都传入同一个值即可：

import psycopg2
from decimal import Decimal

conn = psycopg2.connect("dbname=test_db user=your_user password=your_pass host=localhost")
cur = conn.cursor()

test_value = Decimal('99.99')
# 每个占位符对应一个参数，重复传递同一个值
cur.execute("INSERT INTO test_node (col_a, col_b, col_c) VALUES (%s, %s, %s)", 
            (test_value, test_value, test_value))

conn.commit()
cur.close()
conn.close()

修复方案2：批量插入多行（如果需要生成大量测试数据） #

如果要插入多行测试数据，每行的多列都是同一个值，用psycopg2.extras.execute_values更高效：

import psycopg2
from psycopg2.extras import execute_values
from decimal import Decimal

conn = psycopg2.connect("dbname=test_db user=your_user password=your_pass host=localhost")
cur = conn.cursor()

test_value = Decimal('99.99')
# 生成100条测试数据，每条的三个列都是同一个值
batch_rows = [(test_value, test_value, test_value) for _ in range(100)]
# 批量插入，VALUES后面用%s接收批量数据
execute_values(cur, "INSERT INTO test_node (col_a, col_b, col_c) VALUES %s", batch_rows)

conn.commit()
cur.close()
conn.close()

额外注意事项 #

• 确保test_node表的目标列（col_a、col_b、col_c）确实是numeric或decimal类型，和你传入的Decimal对象类型匹配
• 绝对不要手动拼接SQL字符串（比如f"VALUES ({test_value}, {test_value})"），参数化查询不仅能避免SQL注入，还能自动处理类型转换
• 如果使用其他PostgreSQL驱动（比如asyncpg），占位符格式是$1、$2这类，要对应调整占位符写法

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