如何解决SQLite更新4MB以上大Blob时提示hex literal too big的问题

• 方案1：使用参数化查询（最通用）
  你遇到的hex literal too big错误本质是把Blob内容转成hex字符串拼接进SQL语句导致的，只要用对应语言SQLite驱动的参数化查询接口，直接传递二进制内容即可避开该限制，完全不需要修改SQLite配置。
  参考Python实现示例：

import sqlite3
import json

# 替换为你的GHUB数据库实际路径、字段名、查询条件
GHUB_DB_PATH = "C:/Users/用户名/AppData/Local/Logitech/GHub/settings.db"
TARGET_TABLE = "settings_table"
BLOB_COLUMN = "config_blob"
QUERY_CONDITION = "id = 1"

conn = sqlite3.connect(GHUB_DB_PATH)
cursor = conn.cursor()

# 读取原始Blob并修改
cursor.execute(f"SELECT {BLOB_COLUMN} FROM {TARGET_TABLE} WHERE {QUERY_CONDITION} LIMIT 1")
raw_config = json.loads(cursor.fetchone()[0].decode("utf-8"))
# 此处修改你需要调整的配置项
raw_config["target_config_key"] = "new_value"
new_blob = json.dumps(raw_config, ensure_ascii=False).encode("utf-8")

# 参数化写入，不会触发字面量大小限制
cursor.execute(f"UPDATE {TARGET_TABLE} SET {BLOB_COLUMN} = ? WHERE {QUERY_CONDITION}", (new_blob,))
conn.commit()
conn.close()

所有主流语言的SQLite驱动都支持参数化查询，逻辑和上面的示例一致。

• 方案2：使用SQLite命令行工具（无需写代码）
  如果不想编写脚本，可直接用SQLite官方命令行工具的内置readfile函数完成Blob写入：

1. 将修改后的完整JSON内容保存为单独的文件，例如new_config.json
2. 打开命令行执行以下操作：

# 进入SQLite交互模式，替换为实际数据库路径
sqlite3 你的GHUB数据库路径

-- 执行更新，替换为实际表名、字段名、查询条件
UPDATE 表名 SET 字段名 = readfile('new_config.json') WHERE 查询条件;
.exit

readfile会直接将文件内容以二进制Blob形式写入字段，没有大小限制。

不推荐调整SQLite的MAX_SQL_LENGTH等编译参数解决该问题，不仅需要重新编译SQLite，还可能引入SQL注入等安全风险

这种将完整JSON存入单个Blob的设计是典型的「低开发成本迁移方案」：开发团队不需要针对原有JSON配置的结构拆分数据库表、设计字段和关联关系，业务层不需要修改原有的序列化/反序列化逻辑，后续新增配置项也不需要调整表结构，相当于把SQLite当成了带查询能力的高性能键值存储使用，对于不需要对外暴露修改能力的客户端应用来说，开发和维护成本极低，唯一的缺点就是不适合用户手动修改配置。

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