Redis操作JSON总出错，是我用法不对还是配置问题啊？

Redis操作JSON总出错，是我用法不对还是配置问题啊？这个问题可太常见了，很多刚开始用Redis处理JSON的朋友都会一头雾水，别急着怀疑自己，这通常不是单一原因造成的，咱们来一起捋一捋，大概率是用法上的一些小细节没注意到，偶尔也可能和配置或环境有关。

最核心的一点：你用的真的是支持JSON操作的Redis吗？

这听起来像句废话，但很重要，原生的Redis并不直接支持JSON数据类型和命令，我们所说的“Redis操作JSON”，实际上指的是 Redis Stack 或者你手动加载了 RedisJSON 模块 的Redis。（来源：Redis官方文档）你得先确认你的Redis服务器是不是这个“增强版”的，你可以在Redis命令行里输入 MODULE LIST 命令看看返回结果里有没有“ReJSON”字样，如果没有，那你就没法使用像 JSON.SET, JSON.GET 这样的专属命令，自然怎么操作都会报错，这就好比你想用微波炉的烧烤功能，但买的是基础款只有微波功能,那按烧烤键肯定没反应。

排除了环境问题，接下来99%的坑都集中在“用法”上。

第一大类错误：命令格式和路径没搞对。

RedisJSON的命令和传统的Redis命令有点不一样，它有一套自己的语法规则,特别容易踩坑。

1. 忘记写文档路径（Path）： 这是最最常见的错误！传统SET key value是把整个key对应到一个值，但JSON.SET是针对JSON文档内部的某个位置进行操作，你必须告诉Redis你要把这个JSON值设置到文档的哪个路径下。根路径是点号（.）。（来源：RedisJSON命令文档）

   • 错误示范： JSON.SET myDoc '{"name": "Alice"}' —— 这会直接报错,因为它缺少了路径参数。
   • 正确示范： JSON.SET myDoc . '{"name": "Alice"}' —— 这个点号（.）代表根路径，意思是将整个JSON对象设置到myDoc这个键上。

2. 路径写错了： JSON路径类似于文件系统路径或者URL路径，如果你想操作嵌套结构里的值,路径必须写全。

   • 比如你有一个文档：{"user": {"profile": {"age": 30}}}
   • 你想修改年龄，命令应该是：JSON.SET userKey '.user.profile.age' '40'
   • 如果你不小心写成了 '.user.age'，Redis会在user对象下找一个叫age的字段，结果发现没有,可能就会返回一个错误或者达不到你想要的效果。

3. 不理解路径代表的含义： 路径不仅可以指向最终的值,还可以指向一个数组或对象。

   • 指向数组： JSON.GET myArray . 会获取整个数组。
   • 指向数组的某个元素： JSON.GET myArray '[0]' 获取索引为0的第一个元素。
   • 指向对象某个字段： JSON.GET myObj '.name' 获取name字段的值。 如果把路径弄混了，比如试图给一个数组索引位置设置一个字符串对象，或者给一个字符串值下面再设置子字段,都会出错。

第二大类错误：数据格式不符合JSON标准。

RedisJSON要求你存入的值是合法的JSON,这一点非常严格。

1. 字符串忘了加双引号： JSON要求所有的字符串必须用双引号括起来,单引号是不行的！

   • 错误示范： JSON.SET product . '{name: "Phone", price: 999}' —— 这里的name和price作为key没有用双引号,这不是合法的JSON。
   • 正确示范： JSON.SET product . '{"name": "Phone", "price": 999}'

2. 尾随逗号： 在JSON中,对象或数组的最后一个元素后面是不能有逗号的。

   • 错误示范： {"a": 1, "b": 2, } 或 [1, 2, ]
   • 这种写法在JavaScript里可能允许，但在严格的JSON解析器里会报错,RedisJSON也会拒绝它。

3. 使用了不兼容的数据类型： 虽然JSON支持null, true, false，但如果你试图存入一个JavaScript中的undefined或者函数，那肯定是不行的,确保你通过客户端库传入的就是一个标准的JSON对象。

第三大类错误：客户端库的使用问题。

我们通常不会直接打命令行，而是用编程语言客户端（比如NodeRedis、Jedis等）来操作Redis,这里也可能出问题。

1. 库是否支持RedisJSON？ 有些老版本的客户端库可能没有封装RedisJSON的命令，你需要使用较新版本的库,并查看其文档确认支持模块命令。

2. 序列化/反序列化问题： 当你用客户端库时，它可能会“自作主张”地帮你把对象转换成字符串，比如在Node.js中,你可能会这样写：

   • client.json.set('key', '.', {name: 'Alice'}); 这看起来没问题，但有些库的默认配置可能会先把你给的JavaScript对象转成一个字符串（相当于执行了JSON.stringify），然后再发给Redis，而RedisJSON期望接收的是一个已经是字符串形式的JSON文本，这就可能导致双重序列化，最终存进去的是一个被转义的字符串，而不是结构化的JSON，你需要仔细阅读客户端库的文档，看它处理JSON命令时的具体行为,可能需要显式地自己先把对象转换成JSON字符串再传入。

怎么排查呢？

1. 从简单开始： 先别搞复杂的嵌套结构，就用最简单的命令测试：JSON.SET test . '{"hello": "world"}'，然后JSON.GET test .，如果这都失败,那就是环境或最基础的连接问题。
2. 仔细阅读错误信息： Redis返回的错误信息通常很直白，(error) ERR path does not exist”意味着路径不存在，“(error) ERR invalid JSON”意味着你的JSON格式不对,根据错误信息去调整。
3. 检查你的JSON： 把准备写入的JSON字符串复制出来，贴到一个在线的JSON校验工具里（比如JSONLint）,看看它是不是合法的。
4. 查阅文档： RedisJSON的官方文档永远是你最可靠的朋友,里面有每个命令最详细的说明和例子。

Redis操作JSON出错，绝大多数情况是用法问题，特别是路径书写和JSON格式这两大“杀手”，配置问题相对少见，主要就是确认RedisJSON模块已加载，耐心点，从最简单的例子开始实践，逐步排查,你一定能搞定它！