Python sqlite3 查询不存在的双引号列名却返回 0

Python 的 sqlite3 查询写错了列名，却没有报 no such column，只返回计数 0。尤其当列名带空格、用双引号包住时，要检查当前连接是否允许把双引号内容当作字符串。

例如表里只有 county 和 status，查询却写成：

SELECT COUNT(*) FROM schools
WHERE "School Type" = 'District';

在启用双引号字符串兼容行为的 SQLite 连接中，"School Type" 找不到对应标识符后，可能被解释成字符串值。条件于是成为两个不同字符串的比较，自然没有匹配行。返回 0 不能证明查询用了正确的列。

这篇文章针对 SQLite 的 DQS 兼容行为。下面的 Python 连接配置示例需要 Python 3.12 或更新版本，以及提供相关配置项的 SQLite 构建；SQLite 的运行时 DQS 开关从 3.29.0 起提供。已经禁用这项兼容行为的环境会直接报错。

在出问题的连接里核对列和运行库

不要只在另一个数据库管理工具里重试。命令行 SQLite、Python 和应用可能使用不同的库及默认配置。SQLite 3.41.0 起，命令行工具默认禁用双引号字符串，但这不等于所有 Python 连接都采用同样默认值。

在发生问题的应用环境中查看版本，并在已有连接 conn 上读取表结构：

import sqlite3
import sys

print(sys.version)
print(sqlite3.sqlite_version)
for column in conn.execute("PRAGMA main.table_xinfo('schools')"):
    print(column)

main 和 schools 应替换为实际数据库名与已确认的表名。不要把不可信输入直接拼进这条结构检查语句。table_xinfo 会列出普通列，也包含生成列和隐藏列；根据返回的列名核对 SQL 拼写、空格和实际表结构。

如果表本来就没有所需业务字段，应回到查询生成逻辑或数据模型确认要用哪个字段，不要仅为消除错误就加一个空列。若列确实存在，也应检查实际查询引用的是不是同一个表或别名，不能把所有空结果都归因于 DQS。

在创建连接时禁用双引号字符串

对新连接尽早配置，放在应用查询或语句缓存建立之前。下面是只使用内存数据库的独立示例，不连接现有数据库文件：

import sqlite3

conn = sqlite3.connect(":memory:")
try:
    conn.setconfig(sqlite3.SQLITE_DBCONFIG_DQS_DML, False)
    print(conn.getconfig(sqlite3.SQLITE_DBCONFIG_DQS_DML))  # 预期 False

    conn.execute("CREATE TABLE schools (county TEXT, status TEXT)")
    conn.execute(
        'SELECT COUNT(*) FROM schools WHERE "School Type" = ?',
        ("District",),
    )  # 预期 sqlite3.OperationalError: no such column: School Type
finally:
    conn.close()

报错是这个示例的验收目标：不存在的列不再悄悄变成字符串。SQLITE_DBCONFIG_DQS_DML 控制 SELECT、INSERT、UPDATE 和 DELETE 中的这项行为；它不是修改数据库文件的永久属性，每个需要严格行为的连接都应配置。连接池应在创建连接的统一入口处理，不能只设置某个临时诊断连接。

如果还要禁止建表、建索引等 DDL 中的双引号字符串，需另行评估，并在应用连接尚未关闭的初始化阶段设置：

conn.setconfig(sqlite3.SQLITE_DBCONFIG_DQS_DDL, False)

这项配置不应被误认为 DML 开关的替代品。旧数据库定义和迁移语句可能依赖兼容写法，扩大到 DDL 前应先检查这些语句。

setconfig()、getconfig() 和相关常量从 Python 3.12 加入，常量是否可用还取决于 Python 编译时使用的 SQLite。若接口或常量不存在，应检查实际 Python 安装与 SQLite 构建，不能捕获 AttributeError 后继续宣称严格模式已启用，也不要把 C 配置项名称当成一条随意拼出的 PRAGMA。

修正查询时，列名和值分开处理

关闭兼容后，合法的双引号标识符仍可使用。以下片段使用应用中已有且尚未关闭的 conn；假设实际字段叫 status，查询可以写成：

rows = conn.execute(
    'SELECT county FROM schools WHERE "status" = ?',
    ("Active",),
).fetchall()

这里双引号引用列，? 绑定数据值。不要把列名改成单引号来绕过错误：单引号内容本来就是字符串。也不要把列名作为 ? 参数传入，那不会让参数变成查询结构。

暂时无法使用连接配置接口时，SQLite 的方括号形式可让一个已确认的列名保持标识符含义，例如 [School Type]。当该列不存在时会报错。它可以帮助核对现有查询，但不要借此批量替换全部 SQL 引号；字符串值继续参数化，动态字段只从允许的字段集合中选择。

检查旧 SQL 的兼容依赖

启用前保存相关连接初始化和查询代码，在隔离数据中分别验证：正确列能返回预期结果，拼错列会失败，包含引号的数据值仍能通过参数绑定查询。还应检查旧代码是否把 "Active" 当字符串使用；严格模式下，这类写法需要改为值参数或合法的单引号字符串。

回退时可恢复连接初始化代码并重新建立相关连接，保留已修正的查询。恢复兼容模式只是临时兼容措施，不表示原来的列名已经正确。这个开关不会补出被遗漏的字段，也不会自动纠正此前按错误筛选条件得到的报表或已提交的写入结果；这些结果需要单独核对。