Python sqlite3 转换器优先级：表声明已经选好类型，查询别名为什么还能换一种结果
同一张表、同一个值，普通SELECT返回一种对象，加一个带方括号的列别名却换了另一种结果。打开sqlite3的自动类型检测以后，结果的Python类型不只由建表声明决定；查询可以通过列名类型标记选择转换器，而且在两个检测开关同时启用时拥有优先权。
示例在Linux、CPython 3.12.14与SQLite 3.53.1实跑。保存为demo.py，运行python3 demo.py。数据库仅存在于内存，转换器只在当前演示进程中注册。两个教学类型名称分别表示建表声明和查询输出选择，不安装扩展，不修改已有数据库或系统设置。
AI生成的概念示意图：查询结果上的显式标签选择另一条转换通道，表示列名标记优先于默认声明；不是SQLite执行计划。
完整程序与本次实跑
完整可运行程序
import sqlite3
calls = []
def declared(raw):
assert isinstance(raw, bytes)
calls.append(("declared", raw))
return "declared:" + raw.decode("ascii")
def explicit(raw):
assert isinstance(raw, bytes)
calls.append(("explicit", raw))
return "explicit:" + raw.decode("ascii")
sqlite3.register_converter("DEMO_DECL", declared)
sqlite3.register_converter("DEMO_VIEW", explicit)
flags = sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES
con = sqlite3.connect(":memory:", detect_types=flags)
try:
con.execute("CREATE TABLE sample(value DEMO_DECL)")
con.execute("INSERT INTO sample VALUES (?)", (7,))
normal = con.execute("SELECT value FROM sample").fetchone()[0]
cur = con.execute('SELECT value AS "reading [DEMO_VIEW]" FROM sample')
overridden = cur.fetchone()[0]
print("declared result:", normal)
print("column result:", overridden)
print("reported name:", cur.description[0][0])
print("converter inputs:", calls)
assert normal == "declared:7" and overridden == "explicit:7"
assert calls == [("declared", b"7"), ("explicit", b"7")]
storage = con.execute("SELECT typeof(value) FROM sample").fetchone()[0]
print("SQLite storage type:", storage)
assert storage == "integer"
before = len(calls)
null = con.execute('SELECT NULL AS "reading [DEMO_VIEW]"').fetchone()[0]
assert null is None and len(calls) == before
print("NULL result:", null)
print("NULL converter calls:", len(calls) - before)
finally:
con.close()本次实际输出（以下为结果，不是程序）
declared result: declared:7
column result: explicit:7
reported name: reading
converter inputs: [('declared', b'7'), ('explicit', b'7')]
SQLite storage type: integer
NULL result: None
NULL converter calls: 0注册转换器与开启检测缺一不可
register_converter给类型名称关联回调，connect的detect_types决定何时查找这些回调。程序用按位或同时启用PARSE_DECLTYPES与PARSE_COLNAMES。若只注册而没有在连接上启用相应检测，不能期望所有查询自动套用转换；默认连接关闭这类类型检测。
普通查询没有额外标记，所以按value的声明类型找到declared，得到declared:7。实际项目可以在这里构造领域对象，本文故意返回带来源前缀的字符串，让输出直接显示究竟选中了哪条路径，而不把差异藏在两个长得一样的对象里。
列别名标记优先，不会串联两个回调
第二个查询使用双引号包住reading [DEMO_VIEW]，方括号里放已注册类型名。column result变成explicit:7。calls列表只有两项：普通查询调用declared一次，带标记查询调用explicit一次。它不是先执行声明转换，再把结果交给显式转换器。
reported name只显示reading，类型标记承担转换指示作用，并不会原样出现在返回的列名中。需要依据description构造字典或报表表头时，应以驱动实际报告的名称为准。不要假设SQL文本里写出的整个别名都是最终应用看到的键。
转换器收到字节，不是通常的Python值
converter inputs中的两个参数都是b'7'。即使插入的是整数，回调入口仍按bytes约定提供值，所以代码明确执行ASCII解码。若误以为这里已经是str而直接拼接，或以为一定是int再做数学运算，都会在读取阶段遇到类型错误。
字符解码方式应由存储合同决定。这个固定示例只处理数字的ASCII字节，不能据此替任意文本选择ASCII。若字段保存复杂对象，应规定可验证的序列化格式，并处理损坏数据与范围错误，不要让回调顺手执行来自数据中的代码。
返回形式改变，数据库存储没有改变
SQLite storage type依然是integer。转换器参与的是SQLite结果到Python对象的读取过程，没有把表内值更新成declared:7或explicit:7。这个观察能帮助排错：界面值看起来多了前缀，应先检查读取转换，再判断数据库是不是被某段写入逻辑改坏。
反方向把Python对象送进数据库需要适配器或显式序列化，那是另一项职责。把读取转换器与写入适配器混为一谈，容易出现能读却不能写，或写入后无法往返的问题。本文只验证读取端优先级，不声明任何自动双向映射关系。
NULL和注册范围也需要单独验收
NULL result为None，而且新增回调次数为零。不能把“转换器为每条记录负责填默认值”当成普遍假设；如果业务不允许空值，应在查询、模式约束或结果校验层另行表达。测试里放一个真正NULL，才能看到它与字符串“NULL”或数字零的区别。
转换器注册属于模块级状态，长生命周期应用应集中管理命名，避免不同组件互相覆盖同名回调。本文通过独立进程运行来限定影响范围。集成时至少核对注册名称、连接检测开关、查询别名和回调输入格式四处，才能解释同一列在不同查询中的实际Python结果。
参考资料
官方资料核验于2026年10月2日；上述输出来自本次固定输入实跑，退出码为0。
