API响应无法插入PostgreSQL的问题排查及解决求助

错误原因分析 #

1. 第一个语法错误（SyntaxError） #

你用str.format()直接把字典值拼到SQL语句里，生成的SQL会是VALUES{'xxx','xxx'}这种格式——SQL语法要求VALUES后面必须跟圆括号，且字符串类型的数值需要用单引号包裹，直接用大括号会触发语法错误。

2. 第二个列不存在错误（UndefinedColumn） #

改成VALUES(id, name)后，PostgreSQL会把id和name解析为表的列名，而不是你要插入的具体数值。另外你提到表有id和name列，但代码里写的是插入person_id和person_name，这里存在列名不匹配的问题，必须保证代码中的列名和数据库表的列名完全一致。

3. 循环逻辑错误 #

你的代码里遍历dictionary.values()，如果dictionary是单个用户的字典（比如键为person_id、person_name），循环会分别取到每个值，每次只插入一个值，这会导致SQL语句的列数不匹配（表需要两个值，但每次只传一个）。

正确实现代码 #

核心要点： #

• 使用psycopg2的参数化查询（不要用字符串格式化拼SQL），它会自动处理数值类型、引号包裹，还能避免SQL注入。
• 确保代码中的列名和数据库表的列名完全对应。
• 插入后必须提交事务，否则数据不会写入数据库。

# 假设testEns返回的字典结构是：{'person_id': 123, 'person_name': 'John Doe'}
# 如果你的表列是id、name，就把下面的键改成'id'、'name'
dictionary = testEns(idSession)

# 获取对应字段的值
person_id = dictionary['person_id']
person_name = dictionary['person_name']

# 参数化查询，%s是psycopg2的占位符（不是Python的格式化符）
sql2 = '''INSERT INTO PERSONS(person_id, person_name) VALUES (%s, %s);'''

# 执行查询，第二个参数是参数元组，顺序要和占位符对应
cursor.execute(sql2, (person_id, person_name))

# 必须提交事务，否则数据不会持久化到数据库
conn.commit()

如果testEns返回的是多个用户的字典列表（比如[{'person_id':1, ...}, {'person_id':2, ...}]）： #

persons_list = testEns(idSession)  # 假设返回的是字典列表
sql2 = '''INSERT INTO PERSONS(person_id, person_name) VALUES (%s, %s);'''

# 批量插入可以用executemany提升效率
cursor.executemany(sql2, [(p['person_id'], p['person_name']) for p in persons_list])
conn.commit()

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