Python中SQLAlchemy查询打印结果返回ResultProxy且抛异常如何解决

• 直接打印查询返回值得到ResultProxy对象是正常现象：这个对象是SQLAlchemy封装的结果集游标，本身不存储实际查询数据，必须调用内置的取值方法才能拿到具体结果，直接打印只会输出对象的类型标识。
• 触发未捕获异常的核心原因是SQL写法不规范、存在语法错误：
  • group是SQL标准保留关键字（对应GROUP BY分组语法），直接作为表名使用时数据库无法正常解析，会抛出语法错误。
  • f-string拼接两行SQL时，第一行末尾的右括号和第二行开头的FROM之间没有留空格，最终拼接出的语句是SELECT COUNT(DISTINCT id)FROM group，在开启严格模式的数据库实例中会直接解析失败。
  • 未用text()包裹原生SQL的写法在SQLAlchemy 2.x及以上版本会直接抛参数类型错误，且直接用f-string拼接SQL存在严重的SQL注入风险。

• 修正SQL语法：对作为表名的保留关键字加对应数据库的转义符（MySQL用反引号、PostgreSQL用双引号、SQLite兼容两种转义符），补全SQL语句里的必要空格。
• 遵循SQLAlchemy执行原生SQL的规范：用text()方法包裹原生SQL语句，单值聚合查询用scalar()方法直接取结果，比first()[0]更简洁鲁棒。

修正后的可运行代码如下：

from sqlalchemy import text

# 以MySQL为例，表名`group`用反引号转义
query = text("""
SELECT COUNT(DISTINCT id)
FROM `group`
""")

result = db.session.execute(query)
# scalar()专门用于获取首行首列的单值结果，适配count、sum这类聚合查询
id_count = result.scalar()
print(id_count)

如果是查询多行多列的结果，调用result.all()即可拿到所有行组成的元组列表，遍历就能拿到每一行的数据。

• 如果项目已经定义了表对应的ORM模型，更推荐用ORM语法做查询，完全规避原生SQL的语法、关键字转义、SQL注入问题，示例代码：

from sqlalchemy import func

# 假设Group是group表对应的ORM模型类
id_count = db.session.query(func.count(Group.id.distinct())).scalar()
print(id_count)

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