使用SQLAlchemy插入数据库时出现语法错误求助

嗨，我来帮你搞定这个问题！你遇到的报错是因为没有用SQLAlchemy的text()函数包裹原生SQL语句，导致数据库驱动无法识别你用的命名参数格式。

问题根源 #

你直接把原始SQL字符串传给connection.execute()，但PostgreSQL的驱动（psycopg2）默认只认%s这种位置占位符，不认:username这种命名占位符。而SQLAlchemy的text()函数是专门用来处理原生SQL的，它能帮你统一参数绑定的语法，不管用哪种数据库都能顺畅使用命名参数。

修复后的代码 #

先记得导入text函数，然后把你的SQL语句用它包裹起来就行：

from sqlalchemy import text  # 别忘了加这行导入

@app.route("/")
def index():
    id = "Vishal"
    p = "vishal94"
    # 用text()包裹SQL，让SQLAlchemy解析命名参数
    connection.execute(text("INSERT INTO books (username , password) VALUES(:username , :password)"), {"username":id, "password":p})
    # 查询语句也同样用text()包裹
    dat = connection.execute(text("select * from books"))
    return render_template("data.html", dat=dat)

为什么CS50里的代码能直接用？ #

CS50课程里可能做了特殊的环境配置，或者用了SQLAlchemy的高层封装（比如Flask-SQLAlchemy的简化写法），但标准SQLAlchemy执行原生SQL时，必须用text()来包裹才能识别命名参数。

另一种可选写法 #

如果你不想用命名参数，也可以直接用psycopg2支持的位置占位符，代码会变成这样：

connection.execute("INSERT INTO books (username , password) VALUES(%s , %s)", (id, p))

不过用text()+命名参数的方式更清晰，尤其是在复杂SQL语句里，可读性会高很多。

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