SQLite 3.35.0+ 常见问题：如何启用并使用JSON1扩展？

Question

**问题：** 在 SQLite 3.35.0 及以上版本中，如何启用并使用 JSON1 扩展模块？我在尝试处理 JSON 数据时遇到了函数未定义的问题（如 `json_valid`、`json_extract` 不可用），是否需要手动加载扩展？如果需要，具体应如何操作？此外，在不同平台（如 Linux、Windows、macOS）或不同编程语言接口（如 Python、C/C++）中启用 JSON1 是否有差异？

Answer 1

一、SQLite JSON1 扩展模块概述

从 SQLite 版本 3.9.0 开始，官方引入了 JSON1 扩展模块以支持 JSON 数据的解析与操作。常见的函数包括：json_valid、json_extract、json_object、json_array 等。

然而，在某些环境中（如特定发行版或编程语言接口中），即使使用的是 SQLite 3.35.0 或更高版本，也可能默认未启用 JSON1 扩展，导致出现“函数未定义”的错误。

二、是否需要手动加载扩展？

是的，虽然 JSON1 是官方推荐的标准扩展，但在部分部署方式或接口中，默认并未加载该扩展模块。

例如：

• 在命令行工具中，JSON1 函数默认不可用，除非显式加载。
• Python 的 sqlite3 模块默认不启用 JSON1。
• 在 C/C++ 中编译时，若未启用相关宏定义，则不会包含 JSON1 支持。

三、如何启用 JSON1 扩展模块？

1. 使用命令行方式启用

对于 SQLite 命令行工具，可以使用如下方式加载 JSON1：

.load /usr/local/lib/libsqlitefunctions_json.dylib   # macOS 示例
.load ./libjson1.so                                 # Linux 示例
.load json1                                         # Windows 示例（需正确路径）

2. 在 C/C++ 中启用

在 C/C++ 中使用 JSON1 需要在编译时启用宏定义：

#define SQLITE_ENABLE_JSON1
#include "sqlite3.h"

或者在编译命令中添加：

gcc -DSQLITE_ENABLE_JSON1 -o myapp myapp.c sqlite3.c

3. 在 Python 中启用

Python 标准库中的 sqlite3 模块默认不加载扩展。需通过如下方式启用：

import sqlite3

conn = sqlite3.connect(':memory:')
conn.enable_load_extension(True)
conn.load_extension('json1')  # 路径可能不同，视系统而定
cur = conn.cursor()
cur.execute("SELECT json_valid('{\"a\":1}')")
print(cur.fetchone())  # 输出 (1,)

四、平台差异分析

平台	扩展文件名	加载方式示例
Linux	libjson1.so	.load ./libjson1.so
Windows	json1.dll	.load json1
macOS	libjson1.dylib	.load libjson1.dylib

五、常见问题排查流程图

graph TD
A[遇到函数未定义错误] --> B{是否启用了JSON1?}
B -- 否 --> C[尝试加载扩展]
C --> D{加载成功?}
D -- 是 --> E[继续使用JSON函数]
D -- 否 --> F[检查扩展路径/权限/编译选项]
B -- 是 --> G[确认SQLite版本 >= 3.9.0]
G --> H{版本满足?}
H -- 是 --> I[联系开发者反馈]
H -- 否 --> J[升级SQLite版本]
        

六、总结性建议与实践技巧

为确保 JSON1 功能可用，建议以下几点：

• 始终确认 SQLite 版本是否支持 JSON1（>= 3.9.0）。
• 在开发环境中提前测试扩展加载逻辑。
• 跨平台项目应统一处理扩展加载逻辑，避免因平台差异导致功能缺失。
• 使用虚拟环境或容器化部署可减少依赖冲突。
• 对于生产部署，考虑静态链接或预编译带 JSON1 支持的 SQLite 库。