Conda与Python官方环境中SQLite3 json_tree函数兼容性问题

核心原因 #

报错no such table: json_tree的本质是两个Python环境绑定的SQLite版本不一致：

• json_tree是SQLite 3.38.0（2022-02-22）才正式引入的JSON递归查询函数
• Conda提供的Python 3.8.10绑定了更高版本的SQLite，支持该函数；而python.org官方发布的同版本Python，在Windows平台绑定的SQLite版本大概率低于3.38.0，因此不支持json_tree

排查步骤 #

1. 验证SQLite版本
   在两个Python环境分别执行以下代码，对比输出的版本号：

   import sqlite3
   print(sqlite3.sqlite_version)
   

   官方环境的版本会低于3.38.0，而Conda环境的版本≥3.38.0。

2. 确认函数支持性
   可以直接在SQLite命令行测试：

   • 官方Python绑定的SQLite：执行SELECT json_tree('{"a":"b"}');会报错
   • Conda或SQLiteStudio使用的SQLite：执行该语句会正常返回结果

解决办法 #

方案1：升级Python版本

python.org官方Python 3.10及以上版本绑定的SQLite版本都≥3.38.0，直接升级Python即可解决函数支持问题。

方案2：替换SQLite动态链接库（Windows平台）

1. 从SQLite官方下载对应位数（32位）的最新版sqlite3.dll
2. 找到官方Python 3.8.10的安装目录，替换其中的sqlite3.dll文件（注意备份原文件）
3. 重启Python环境，再次验证版本即可

方案3：修改SQL语句兼容低版本SQLite

如果无法升级或替换库，可以用json_each结合递归逻辑替代json_tree，但需要根据JSON结构调整语句。例如针对tos字段（可能是对象或数组），可以改为：

SELECT m_mail_info.id
FROM m_mail_info, json_each(m_mail_info.tos)
WHERE json_each.value LIKE '%name%' AND json_each.type = 'text'
-- 若存在嵌套对象，需要额外处理，比如遍历嵌套层级
UNION
SELECT m_mail_info.id
FROM m_mail_info, json_each(m_mail_info.tos)
WHERE json_each.type = 'object'
AND EXISTS (
    SELECT 1 FROM json_each(json_each.value)
    WHERE json_each.value LIKE '%name%' AND json_each.type = 'text'
)

这种方式需要根据实际JSON结构调整，复杂度较高，仅作为临时兼容方案。

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