SQL Server查询控制台运行正常，经SQLAlchemy调用却报无返回行错误

数据老陈

2026-10-23

报错核心诱因

前置非查询语句生成干扰结果集
SQL Server 默认开启NOCOUNT OFF配置时，所有CREATE TABLE、INSERT、SELECT INTO类语句执行后，都会主动向客户端返回“操作影响行数”的提示类消息。这类消息在TDS协议中会被标记为独立结果集，但无实际业务列。
SQLAlchemy 执行批处理时，默认仅将首个返回的结果集标记为可读取的业务结果。遇到这类前置的提示类结果集时，会错误将其判定为整个查询的最终返回值。后续调用fetchall()时，当前游标指向的是已经消费完毕、自动关闭的非业务结果集，因此抛出完全和实际场景不符的“无行返回”错误。
这类问题不会在SQL Server控制台出现，是因为SSMS会自动将提示类消息归类到独立的消息面板，不会和业务结果集混淆状态。
长查询超时配置不匹配
15分钟的长查询如果未调整驱动默认的命令超时、连接超时参数，会出现查询尚未执行完成，但驱动端因状态判定错误提前关闭游标通道的问题。这类异常不会直接抛出超时错误，往往以“结果已关闭、无行返回”的形式呈现。
会话特性配置缺失
如果连接未开启MARS（多活动结果集）支持，临时表作为会话级对象，会在多语句执行过程中出现会话状态重置，导致后续查询逻辑执行异常，最终无法生成有效结果集。

对应解决步骤

在查询开头添加无干扰配置
关闭所有DML/DDL语句执行后的行数提示，从根源上消除多余的干扰结果集。修改后的SQL头部添加以下语句：
```
SET NOCOUNT ON;
USE DB_NAME;
-- 其余原有查询逻辑保持不变
```
调整连接引擎配置
为SQL Server连接匹配长查询所需的超时参数，开启必要的会话特性，替换原有连接URI为如下格式：
```
# 以pyodbc驱动为例，替换对应账号、服务器、库名信息
SQLServer_URI = "mssql+pyodbc://用户名:密码@服务器地址/数据库名?driver=ODBC+Driver+17+for+SQL+Server&timeout=0&command timeout=0&MARS_Connection=yes"
engine = create_engine(SQLServer_URI)
```
参数说明：
- timeout=0：关闭长连接的闲置超时
- command timeout=0：关闭单条命令的执行超时，支持15分钟级别的长查询运行
- MARS_Connection=yes：开启多结果集支持，避免多语句执行时的会话状态冲突

优化执行逻辑
执行查询时主动管理结果集状态，跳过所有非业务类提示结果，定位到真正带数据的结果集后再执行取数操作，示例代码如下：

from sqlalchemy import text

with engine.connect() as connection:
    # 调整执行选项，关闭自动提交干扰
    connection = connection.execution_options(autocommit=False)
    # 原始SQL需用text()包裹，兼容SQLAlchemy 1.4+/2.0版本的语法要求
    result = connection.execute(text(huge_query))
    data = []
    # 遍历所有待消费的结果集，跳过无业务行的提示类结果
    while not result.closed:
        if result.returns_rows:
            data = result.fetchall()
            break
        result.close()

注意：使用SQLAlchemy 1.4及以上版本时，直接将原始查询字符串传入execute()方法会触发语法解析错误，必须用text()将原始SQL包裹后再执行，这也是部分场景下出现状态误判的次要原因。

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