本文详解如何在 sqlite 中安全、高效地向存储为 json 的评论数组末尾添加新元素，解决因误用 `json_set` 导致的 `sqlite_range` 错误，并提供可直接运行的修复代码与关键注意事项。
在 SQLite 中操作 JSON 数据时，JSON_SET() 和 JSON_INSERT() 行为有本质区别：JSON_SET() 仅用于更新已有路径的值，若指定路径不存在（例如数组索引超出当前长度），它不会自动扩容，而是静默失败或引发错误；而 JSON_INSERT() 则支持在指定路径插入新值，且当路径为 $[#]（即“数组末尾”）时，会自动将新元素追加到数组最右端——这正是动态添加评论所需的语义。
因此，原代码中使用 JSON_SET(comments, '$[JSON_ARRAY_LENGTH(comments)]', "?") 是错误的：一方面，SQLite 不支持在 JSON 路径表达式中嵌套函数调用（JSON_ARRAY_LENGTH(comments) 无法在 $[...] 内动态求值）；另一方面，即使语法合法，JSON_SET 对越界索引也无追加能力。
✅ 正确做法是使用 JSON_INSERT() 配合特殊索引符号 #：
app.post("/add-comment", (req, res) => {
const id = req.body.id;
const newComment = req.body.comment;
console.log("Adding comment: '%s' to articleID: %d", newComment, id);
global.db.run(
`UPDATE articles
SET comments = JSON_INSERT(comments, '$[#]', ?)
WHERE article_id = ?`,
[newComment, id],
function (err) {
if (err) {
console.error("Failed to add comment:", err.message);
return res.status(500).json({ error: "Database update failed" });
}
res.json({ success: true, message: "Comment added successfully" });
}
);
});? 关键说明：
- $[#] 是 SQLite JSON1 扩展定义的专用追加语法，等价于“数组最后一个位置之后”，无需预先计算长度；
- 参数绑定使用 ? 占位符（非字符串拼接），既防止 SQL 注入，又避免 JSON 字符串转义问题；
- 若 comments 列初始为 NULL，JSON_INSERT(NULL, '$[#]', 'text') 将返回 ["text"]，天然支持空数组初始化；
- 确保数据库已启用 JSON1 扩展（SQLite 3.38+ 默认启用；旧版本需编译时开启）。
⚠️ 注意事项：
- 不要尝试用 JSON_SET 模拟追加（如 $[0], $[1] 等硬编码索引），易引发竞态或越界；
- 前端提交的 comment 值应做基础校验（非空、长度限制、XSS 过滤），后端不可完全信任；
- 高并发场景下，若需强一致性（如评论计数同步），建议结合 UPDATE ... RETURNING（SQLite 3.35+）或事务重试机制。
通过这一修正，你的评论系统即可稳定、安全地扩展 JSON 数组，无需手动解析/序列化，真正发挥 SQLite 内置 JSON 函数的简洁优势。
