SQLAlchemy执行纯文本SQL（不绑定参数）插入特殊字符串报错求助

阿华AIGC实验室

2026-5-21

解决SQLAlchemy插入含特殊字符字符串的参数解析问题

我太懂你这种头疼的感觉了——想用SQLAlchemy往数据库插带特殊字符的字符串，结果这些内容被当成参数解析，折腾半天转义双引号还是报错。别慌，咱一步步来搞定这个问题：

1. 别手动拼接SQL！用SQLAlchemy自带的参数绑定（最推荐）

很多时候手动拼SQL、手动转义字符都是给自己挖坑，不仅容易触发参数解析错误，还可能有SQL注入风险。SQLAlchemy的参数绑定机制会自动帮你处理所有转义逻辑，完全不用你操心特殊字符。

用SQLAlchemy Core的例子

from sqlalchemy import create_engine, text

# 替换成你的数据库连接地址
engine = create_engine("postgresql://user:pass@localhost/dbname")

with engine.connect() as conn:
    # 原封不动写你要插入的字符串，不用加任何转义
    target_content = 'abc, "depth":0,'
    # 用:content作为占位符，把参数放在字典里传进去
    conn.execute(text("INSERT INTO schema.table VALUES (:content)"), {"content": target_content})
    conn.commit()

这样执行后，SQLAlchemy会自动生成正确的SQL语句，数据库能完美接收原字符串内容。

用ORM的例子（更优雅）

如果用的是SQLAlchemy ORM，那就更简单了，直接把字符串赋值给模型字段就行：

from sqlalchemy import create_engine, Column, String
from sqlalchemy.orm import sessionmaker
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

# 对应你的schema.table表结构
class TargetTable(Base):
    __tablename__ = 'table'
    __table_args__ = {'schema': 'schema'}
    content = Column(String, primary_key=True)  # 根据你的实际表结构调整字段

engine = create_engine("postgresql://user:pass@localhost/dbname")
Session = sessionmaker(bind=engine)
session = Session()

# 直接创建实例，赋值原字符串
new_record = TargetTable(content='abc, "depth":0,')
session.add(new_record)
session.commit()
session.close()

ORM会自动处理所有转义和参数绑定，全程不用你碰SQL语句，省心又安全。

2. 如果你非要手动处理转义（不建议，但可以参考）

要是你坚持要自己构造SQL语句（真的不推荐），得注意不同数据库的转义规则：

比如PostgreSQL中，字符串用单引号包裹，内部的单引号需要用两个单引号转义，但双引号在单引号内部是不需要转义的，直接写'abc, "depth":0,'就行。
如果你在Python里写字符串，要注意Python自身的转义，比如你要构造包含双引号的SQL字符串，得写成：
```
sql_str = "INSERT INTO schema.table VALUES ('abc, \"depth\":0,')"
```
但这种方式很容易出错，而且一旦字符串里有单引号，又要额外处理，非常麻烦。