Node.js中Redis JSON包如何用独立路径批量更新异构键？

核心结论 #

Redis JSON的JSON.SET命令（以及对应的Node.js redis包的json.set方法）不支持一次性传入多个独立路径列表，同时为多个异构键设置同一值并启用NX选项。

原因说明 #

1. 原生Redis JSON.SET命令语法限制：
   原生命令仅接受单个路径参数（可以是JsonPath模式，比如$..a），无法同时传入多个离散路径（如$.key_1, $.key_2）。你提到的JsonPath模式批量更新，本质是通过路径匹配多个同构节点，无法指定完全独立的异构路径。
   原生命令格式示例：

   JSON.SET <key> <path> <value> [NX | XX]
   

2. Node.js redis包的json.set方法参数限制：
   该方法的第二个参数仅支持单个字符串路径，而非数组。你示例中传入数组的写法不会被客户端正确解析，最终会报错或不符合预期。

可行替代方案 #

若需实现“为多个异构键赋值同一值，且仅当键不存在时执行”的需求，可采用以下两种方式：

方案1：通过事务批量执行单个JSON.SET命令 #

利用Redis事务将多个带NX选项的JSON.SET命令打包执行，保证操作原子性：

const pipeline = self.redisClient.multi();
["$.key_1", "$.key_2", "$.key_3"].forEach(path => {
  pipeline.json.set(redisKey, path, valueToAssign, { NX: true });
});
await pipeline.exec();

此方式会依次执行每个JSON.SET命令，每个命令都遵循NX规则（仅对应路径节点不存在时赋值），且事务保证所有命令要么全部执行，要么全部不执行。

方案2：先校验路径存在性，再批量赋值 #

若无需严格原子性，可先通过JSON.EXISTS检查所有目标路径是否存在，再决定是否执行赋值：

// 检查所有目标路径是否均不存在
const existsResults = await Promise.all(
  ["$.key_1", "$.key_2", "$.key_3"].map(path => 
    self.redisClient.json.exists(redisKey, path)
  )
);
const allNotExists = existsResults.every(result => result === 0);

if (allNotExists) {
  const pipeline = self.redisClient.multi();
  ["$.key_1", "$.key_2", "$.key_3"].forEach(path => {
    pipeline.json.set(redisKey, path, valueToAssign);
  });
  await pipeline.exec();
}

注意：该方式存在竞态条件——在检查与赋值之间，可能有其他客户端修改数据，适合低并发场景。

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