json_value返回null的主因是输入非合法json或路径错误；须先用isjson()校验，路径必须以$开头且指向标量，对象或数组需改用json_query，缺失键与null值无法区分。
JSON_VALUE 返回 NULL 的常见原因
当 JSON_VALUE 返回 NULL，大概率不是数据没找到，而是输入不是合法 JSON 字符串，或者路径语法写错。SQL Server 不会报错，只会静默返回 NULL —— 这是最容易误判的点。
必须先确认字段内容确实是 JSON 格式，且是对象或数组（不能是纯字符串或数字）。可用 ISJSON() 验证：
SELECT data, ISJSON(data) AS is_json_valid, JSON_VALUE(data, '$.name') AS name FROM your_table;
-
ISJSON()返回 0？说明字段里存的是普通字符串（比如带多余空格、单引号、未转义的换行），不是 JSON - 路径中用了单引号（
'$.name'）？SQL Server 要求路径必须是双引号字符串，但 T-SQL 字符串本身用单引号包裹，所以写成'$.name'是对的；真正错误的是路径里漏了$或大小写不匹配（JSON 键名严格区分大小写） - 路径指向一个对象或数组（如
'$.address'是个对象），而你用JSON_VALUE提取——它只接受标量（string/number/true/false/null），此时必须改用JSON_QUERY
处理缺失键和嵌套空值的防御写法
即使 JSON 合法、路径正确，JSON_VALUE 对缺失键、null 值、空字符串都统一返回 NULL，无法区分“字段不存在”和“字段值为 null”。若业务需要区分，得靠组合判断：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
SELECT
CASE
WHEN JSON_VALUE(data, '$.status') IS NULL
AND JSON_VALUE(data, '$.status') IS NOT NULL THEN 'explicit_null'
WHEN JSON_VALUE(data, '$.status') IS NULL
AND JSON_PATH_EXISTS(data, '$.status') = 0 THEN 'key_missing'
ELSE JSON_VALUE(data, '$.status')
END AS status_safe
FROM your_table;
-
JSON_PATH_EXISTS()是 SQL Server 2016+ 提供的辅助函数，能明确判断路径是否存在（哪怕值为null） - 注意：
JSON_VALUE(data, '$.status')在键不存在时也返回NULL，所以不能单靠 IS NULL 判断是否“有这个键” - 如果字段可能为空（
data IS NULL），JSON_VALUE(NULL, '$.x')仍返回NULL，不会报错，但逻辑上应提前过滤或用COALESCE补默认值
性能与索引注意事项
JSON_VALUE 是运行时解析，无法利用常规列索引。若高频按 JSON 内字段查询，别依赖 WHERE JSON_VALUE(col, '$.id') = '123' —— 全表扫描不可避免。
- SQL Server 支持在 JSON 字段上建“计算列 + 索引”：先用
JSON_VALUE定义持久化计算列，再对其建索引 - 例如：
ALTER TABLE T ADD id AS JSON_VALUE(data, '$.id') PERSISTED;，然后CREATE INDEX IX_T_id ON T(id); - 路径表达式必须是确定性的（不能含变量、函数调用），否则无法设为
PERSISTED - 计算列类型需显式转换，比如
JSON_VALUE(data, '$.age')返回nvarchar(4000)，若想按整数查，得写CAST(JSON_VALUE(data, '$.age') AS int)
字符串值里的引号和特殊字符怎么逃逸
JSON 路径本身不处理字符串内容逃逸；真正要小心的是 JSON 原文里未正确转义的双引号、反斜杠或控制字符——它们会让 ISJSON() 返回 0，导致 JSON_VALUE 总是 NULL。
- 插入前务必用
FOR JSON生成，或手动确保双引号写成"、反斜杠写成\ - 从外部系统导入时，常见错误是把 JavaScript 风格的单引号 JSON（
{'name': 'Alice'}）直接塞进 SQL Server，这不符合 JSON 规范，ISJSON()直接失败 - 调试技巧：用
SELECT STRING_ESCAPE(JSON_VALUE(data, '$.notes'), 'json')查看原始值是否含非法字符（仅 SQL Server 2016+）
ISJSON() 验证源头数据是否真 JSON，以及混淆了 JSON_VALUE 和 JSON_QUERY 的适用边界。
