Flask-SQLAlchemy的scoped_session无cursor属性，无法适配pd.read_sql

问题本质 #

pd.read_sql() 不接受SQLAlchemy的scoped_session对象作为连接参数——它需要的是符合DBAPI规范的数据库连接对象，或者SQLAlchemy的Engine实例。而Flask-SQLAlchemy提供的db.session是scoped_session的封装实例，它是SQLAlchemy的会话管理层，并非直接的数据库连接，所以自然没有cursor属性（cursor是底层连接才有的组件）。

其他场景用db.session正常，是因为那些场景调用的都是SQLAlchemy会话本身的API（比如add()、commit()、query()），这些API是针对会话设计的，和pd.read_sql()的底层交互逻辑完全不同。

解决办法 #

有两种可靠的方式解决这个问题：

方式1：直接使用Flask-SQLAlchemy的Engine对象 #

Flask-SQLAlchemy的db.engine就是SQLAlchemy的Engine实例，完全符合pd.read_sql()的要求：

pd.read_sql(your_sql_query, db.engine)

方式2：从当前会话中获取底层连接 #

如果需要复用当前会话的上下文（比如事务状态），可以从db.session中提取底层的DBAPI连接：

pd.read_sql(your_sql_query, db.session.connection())

注意：如果你的pd.read_sql()调用是在Flask的请求上下文之外（比如脚本初始化时），要确保先激活应用上下文，否则db.session可能无法正常获取连接：

with app.app_context():
    pd.read_sql(your_sql_query, db.session.connection())

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