LLM 修复 SQLite 更新引发的日志故障
LLM 0.37.3 修复了 Homebrew 更新 SQLite 至 3.54.1 后出现的日志问题:子查询返回的 JSON 数组会被外层 json_object 当作普通文本。解决方式是在子查询结果外显式调用 json(),保留嵌套 JSON 结构。
AI 深度解读
LLM 0.37.3 是一次修复版本,主要处理最新 Homebrew 软件包中的日志问题。触发故障的不是模型,而是 SQLite 3.54.1 的一项修正:同一条 SQL,升级后会把嵌套 JSON 数组变成字符串。
这篇短文值得程序员读的地方,在于它展示了一类隐蔽的依赖问题:旧版本恰好返回你想要的结果,不代表代码符合文档约定。数据库修了自己的 bug,应用反而需要跟着修。
为什么 SQLite 修 bug,LLM 的日志却坏了
原文里的 LLM 指软件项目,不是泛指大语言模型。作者说,Homebrew 开始提供最新的 SQLite 3.54.1,而其中一项修复破坏了 LLM 的日志代码。LLM 0.37.3 主要就是为了解决这个问题。
问题可以缩小到一条 SQL。在 SQLite 3.54.0 中,下面的查询会得到一个包含数组的 JSON 对象:
select json_object('a', (select json_array(1)))
要看的是 (select json_array(1)) 这一段:它通过子查询,把结果交给外层的 json_object()。
SQLite 3.54.0 返回 {"a":[1]},但 SQLite 3.54.1 对同一查询返回 {"a":"[1]"}。
差别只有一对引号,数据类型却变了。前者的 a 是数组,后者的 a 是字符串,字符串的内容恰好长得像数组。消费这份日志的代码如果按数组处理,就可能出问题。不过,原文没有展开 LLM 日志具体在哪一步失败,也没有提供错误堆栈。
看起来是 JSON,不代表 SQL 会按 JSON 处理
按照作者引用的 D. Richard Hipp 的解释,SQLite 3.54.1 的行为才符合文档:(SELECT json_array(...)) 返回的是 SQL 文本,而不是 JSON。
这也是这次变化容易让人困惑的地方。内层调用了 json_array(),开发者很容易认为,外层拿到的自然还是 JSON 数组。但经过这里的子查询后,外层接收到的是文本,因此把它放进 JSON 对象时,会把它编码成字符串。
SQLite 3.54.0 给出了预期结果,却掩盖了代码对返回类型的错误假设。
原文给出的绕过办法,是在子查询外显式加一层 json():
select json_object('a', json((select json_array(1))))
关键是新增的 json(...):让外层按 JSON 处理子查询返回的文本,避免把 [1] 当作普通字符串写入对象。
这里不需要更换整套日志方案。针对这条查询,修复点就是把原先隐含的类型期待写清楚。
我的判断
我认同这个修复方向。既然维护者明确说明新行为符合文档,应用就应该调整查询,继续依赖旧结果只会把问题推迟到下一次升级。
但这篇文章提供的证据范围很小:一条 SQL、两个 SQLite 版本的不同输出,以及一个绕过写法。它没有给出 LLM 日志模块的完整修改,也没有兼容性矩阵或性能对照。我们可以据此理解故障原因,不能据此推断所有 JSON 子查询都会发生同样的变化。
临时回退依赖版本或许能恢复旧行为,但从文中信息看,显式使用 json() 更贴合文档约定。至于一般团队该不该立即升级,还需要检查自己实际使用的查询和数据消费方式,原文没有提供足够信息替所有项目做决定。
能拿来做什么
- 如果你的本地脚本或 Node 工具使用 SQLite 生成嵌套 JSON,可以检查类似查询,确认结果里的字段确实是数组或对象,而不是内容相似的字符串。
- 排查升级后的日志异常时,可以先抽出最小 SQL,在升级前后的 SQLite 上比较返回结构。这篇文章里的查询就展示了如何把应用问题缩小到数据库行为。
- 用 AI 修改数据库代码时,可以要求它解释子查询的返回类型,并核对最终 JSON 的字段类型。仅凭输出看着像 JSON,还不足以确认数据结构正确。