LLM 发布了 0.37.3 修复版本,解决最新 Homebrew 软件包中的日志兼容性问题。问题与 Homebrew 随附的 SQLite 3.54.1 有关:该版本修正了 JSON 处理行为,使 LLM 原有日志代码依赖的行为发生变化。
对于关注数据库升级与应用兼容性的开发者,这也是一个适合在写好标智库讨论的技术案例:SQL 没变,嵌套 JSON 的类型却可能发生变化。
同一条 SQL,结果有何不同?
在 SQLite 3.54.0 中,执行:
select json_object('a', (select json_array(1)));
会得到:
{"a":[1]}
但在 SQLite 3.54.1 中,同一条查询会返回:
{"a":"[1]"}
关键区别是:a 的值从 JSON 数组变成了字符串。虽然字符串内容看起来仍像数组,但它在最终 JSON 中的类型已经不同。
为什么会发生变化?
按照 SQLite 的文档语义,(SELECT json_array(...)) 返回的是 SQL 文本,而不是 JSON 值。
因此,SQLite 3.54.1 将这段文本作为字符串传给外层 json_object(),才是符合文档语义的行为;3.54.0 将其直接嵌入为数组的行为属于缺陷。
这次兼容性问题的核心并不是 JSON 内容变化,而是原有代码依赖了此前的类型处理行为。
修复方式:用 json() 显式转换
如果希望保留数组结构,可以在子查询外包一层 json(),明确将返回的文本解释为 JSON:
select json_object('a', json((select json_array(1))));
结果即可保持为:
{"a":[1]}
类似代码应检查什么?
对于使用嵌套 JSON 查询的代码,兼容性检查的重点是:子查询返回的 JSON 文本,是否需要通过 json() 显式转换后,再交给外层 JSON 函数。
检查查询结果时,也要区分“内容看起来相同”和“JSON 类型相同”:[1] 与 "[1]" 分别是数组和字符串,不能视为等价输出。

Top comments (0)