json_modify无法直接更新数组中某元素的字段，只能替换整个数组项；正确做法是用openjson展开、修改后通过for json重建数组。
JSON_MODIFY 无法直接修改数组中某个索引的值
SQL Server 的 JSON_MODIFY 不支持类似 $.items[0].name 这种带动态索引或嵌套路径的「就地更新」——它只接受字面量路径，且对数组元素的写入本质是「替换整个数组项」，而非「更新某字段」。如果你试图用 JSON_MODIFY(@json, '$.items[0].name', 'new')，SQL Server 会报错：JSON path is not valid，因为 [0].name 被视为非法路径（不支持点号后接方括号组合）。
正确做法：先提取、再构造、最后替换整个数组项
要更新 JSON 数组中第 n 个对象的某个字段，必须分三步走：用 JSON_VALUE 或 OPENJSON 提取原数组 → 在 T-SQL 中拼出新对象 → 用 JSON_MODIFY 替换整个数组项（路径形如 $.items[0]）。关键限制是：路径中的索引必须是常量，不能是变量表达式。
- ✅ 允许：
JSON_MODIFY(@json, '$.items[0]', '{"id":1,"name":"new"}') - ❌ 不允许：
JSON_MODIFY(@json, '$.items[' + CAST(@i AS VARCHAR) + ']', @newObj)（语法错误，路径不能拼接） - ⚠️ 注意：
$.items[0]是合法路径，但$.items[0].name不是；你只能替换[0]整个节点
实用示例：更新 users 数组中 id=123 的用户邮箱
假设你有一个 JSON 字符串 @json，其中 users 是数组，你想把 id 为 123 的用户的 email 改成 'new@ex.com'。不能一步到位，得借助临时表或变量：
DECLARE @targetId INT = 123;
DECLARE @newEmail NVARCHAR(100) = 'new@ex.com';
<p>-- 1. 提取匹配的用户对象（用 OPENJSON 展开并筛选）
DECLARE @userObj NVARCHAR(MAX) = (
SELECT TOP 1
JSON_QUERY('{"id":' + CAST([key] AS VARCHAR) + ',"name":"' + ISNULL([name], '') + '","email":"' + @newEmail + '"}')
FROM OPENJSON(@json, '$.users')
WITH (id INT '$.id', [name] NVARCHAR(50) '$.name')
WHERE id = @targetId
);</p><p>-- 2. 找到该用户在原数组中的位置（假设已知是索引 2）
-- ⚠️ 真实场景需先查出索引，例如：
DECLARE @idx INT = (
SELECT TOP 1 CAST([key] AS INT)
FROM OPENJSON(@json, '$.users')
WITH (id INT '$.id')
WHERE id = @targetId
);</p><p>-- 3. 替换整个数组项（路径必须硬编码索引，或用动态 SQL 拼接完整语句）
SET @json = JSON_MODIFY(@json, CONCAT('$.users[', @idx, ']'), @userObj);</p>
注意：CONCAT 生成的是字符串，所以第 3 步实际执行的是动态路径拼接——但 JSON_MODIFY 本身不接受变量路径，因此这行代码只有在使用 EXEC sp_executesql 包裹时才有效。更稳妥的做法是：用 STRING_AGG + OPENJSON 重构整个 users 数组，而不是依赖索引替换。
替代方案：用 STRING_AGG + OPENJSON 重建整个数组（推荐）
当你要按条件更新数组内对象时，最可靠、可读性最强的方式是「全量重建」：用 OPENJSON 展开数组 → CASE WHEN 修改目标字段 → FOR JSON 重新聚合。这样完全避开索引路径限制，也避免动态 SQL 的安全与调试成本。
SELECT @json = JSON_MODIFY(
@json,
'$.users',
(
SELECT
id,
name,
CASE WHEN id = 123 THEN 'new@ex.com' ELSE email END AS email
FROM OPENJSON(@json, '$.users')
WITH (id INT '$.id', name NVARCHAR(50) '$.name', email NVARCHAR(100) '$.email')
FOR JSON AUTO
)
);
这个方法不关心原始顺序或索引，只要逻辑清晰，就能稳定更新。真正容易被忽略的是：很多人卡在「想用单条 JSON_MODIFY 完成嵌套更新」，却没意识到 SQL Server 的 JSON 函数设计上就是「原子级数组项操作」，不是 JavaScript 那种灵活路径。绕过它，用展开-转换-聚合，反而更简单、更可控。
