SQL Server 2016+ 不解析存储过程本身,而是支持传入JSON参数用OPENJSON解析成表,或用FOR JSON返回JSON结果;必须用NVARCHAR(MAX)声明参数、ISJSON()校验、WITH子句定义结构,路径须规范且区分大小写。

SQL Server 2016+ 本身不支持直接“解析存储过程的 JSON”——因为存储过程是 T-SQL 代码对象,不是 JSON 文本。你真正想做的,通常是这两件事之一:从存储过程中返回 JSON 结果,或在存储过程中解析传入的 JSON 参数。下面按真实使用场景拆解。
传入 JSON 字符串参数,用 OPENJSON 解析成表
这是最常见需求:前端或调用方把条件、配置、列表数据以 JSON 形式传进来,你在存储过程中把它展开成行/列处理。
-
OPENJSON是唯一推荐方式,它把 JSON 数组或对象转为临时结果集,支持WITH子句显式定义列名、类型和路径 - 必须确保输入参数是
NVARCHAR(MAX)(不是VARCHAR),否则中文会乱码或截断 - 如果传的是单个 JSON 对象(非数组),需加
AS JSON或在外层包一层数组,否则OPENJSON默认只展开数组项 - 示例:解析
@params NVARCHAR(MAX) = N'{"userId":123,"tags":["a","b"]}'
SELECT userId, tag FROM OPENJSON(@params) WITH (userId INT '$.userId', tags NVARCHAR(MAX) '$.tags' AS JSON) CROSS APPLY OPENJSON(tags) WITH (tag NVARCHAR(50) '$')
存储过程中用 FOR JSON 返回结构化结果
如果你要让存储过程“吐 JSON”,不是靠拼字符串,而是用 FOR JSON 直接生成标准格式输出。
使用 extruct 从原始 HTML 中提取机器可读的元数据,以便代理可以在不依赖脆弱的全页解析的情况下对页面进行分类、去重或丰富。它最适合元数据采集工作流,而不适用于爬取整个网站或渲染 JavaScript 密集型页面。
-
FOR JSON PATH更可控,适合自定义嵌套结构;FOR JSON AUTO依赖 SELECT 表结构,容易出意料之外的嵌套 - 必须加
WITHOUT_ARRAY_WRAPPER才能返回单个对象(如{"count":100}),否则默认总是数组[{...}] - 若结果为空,
FOR JSON返回NULL而不是空数组[],前端可能报错,建议用ISNULL(..., '[]')包裹 - 注意
NVARCHAR(MAX)上限约 2GB,但实际中超过几 MB 就该考虑分页或流式处理
解析嵌套 JSON 时路径写错导致字段为 NULL
这是高频翻车点:你以为路径对了,结果 JSON_VALUE 或 OPENJSON WITH 全是 NULL。
- 路径区分大小写,
'$.Name'和'$.name'不等价 - 数组索引从 0 开始,
'$[0].id'才是第一个元素的 id;误写'$[1].id'就取不到 - 含点号、空格、连字符的 key 必须用双引号包裹路径,如
'$."user-id"'或'$.["first name"]' -
JSON_VALUE只能取标量(string/number/bool/null),不能取对象或数组;要取子对象用JSON_QUERY
需要反复解析同一 JSON?别重复调用 OPENJSON
如果一个 JSON 参数要在多个地方展开(比如先取 header,再取 items,再验证 schema),每次 OPENJSON 都会重新解析全文,性能浪费明显。
- 方案一:用临时表缓存解析结果,
SELECT ... INTO #parsed FROM OPENJSON(...) - 方案二:SQL Server 2025+ 支持
json数据类型,可声明变量DECLARE @j json = @input,后续用JSON_VALUE(@j, '$.x')多次提取,底层复用解析树 - 方案三:老版本可用
JSON_MODIFY配合变量做轻量校验,但不能替代解析
最容易被忽略的是兼容性级别:哪怕你用的是 SQL Server 2019,数据库兼容级别低于 130,OPENJSON 和 FOR JSON 也会直接报错,而不是静默降级。

















