使用Psycopg2将变量中JSON数据插入Postgres JSONB列的问题

核心问题分析 #

你碰到的语法错误大概率是f-string引号嵌套冲突，而且直接拼接SQL语句不仅不安全（存在SQL注入风险），还会导致JSON格式解析失败。Psycopg2对Postgres的JSON/JSONB类型有原生支持，不需要手动拼接字符串。

正确实现步骤 #

1. 确保JSON数据格式正确：从PokeAPI拿到的响应如果是字符串，先转成Python字典；如果是requests的响应对象，直接用.json()方法获取字典。
2. 使用参数化查询：用%s作为占位符，把Python字典直接传给Psycopg2，它会自动处理成Postgres能识别的JSONB格式。

完整示例代码 #

import requests
import psycopg2

# 从PokeAPI获取数据
response = requests.get("https://pokeapi.co/api/v2/pokemon/1")
pokemon_data = response.json()  # 直接得到Python字典

# 连接pg4e服务器的Postgres数据库
conn = psycopg2.connect(
    dbname="你的数据库名",
    user="你的用户名",
    password="你的密码",
    host="pg4e服务器地址",
    port="端口号"
)

# 插入数据到JSONB列
try:
    with conn.cursor() as cur:
        # 用%s作为占位符，避免f-string引号冲突
        insert_query = """
            INSERT INTO pokemon (data_column)
            VALUES (%s)
        """
        # 直接传入Python字典，Psycopg2自动转成JSONB格式
        cur.execute(insert_query, (pokemon_data,))
    conn.commit()
finally:
    conn.close()

常见错误规避 #

• 禁止用f-string拼接JSON：比如f"INSERT INTO ... VALUES ('{pokemon_data}')"会因为JSON里的双引号和外层单引号冲突，直接触发SyntaxError。
• 不要手动把字典转成字符串传入：Psycopg2会自动处理Python字典与Postgres JSONB的类型转换，手动转字符串反而会导致存储的是纯文本而非JSONB类型。
• 如果拿到的是JSON字符串，先转成字典：用json.loads(json_str)处理后，再传给execute方法。

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