Redis Lua脚本返回的是JSON字符串而非嵌套Map，需先JSON.parse()转为JS对象才能使用.map()、flatMap()等方法；直接操作会报TypeError；推荐用RedisJSON模块替代手动序列化。
Redis Lua脚本返回的不是嵌套Map，而是JSON字符串
Redis原生不支持嵌套数据结构，EVAL或EVALSHA返回的所谓“嵌套Map”，实际是Lua表（table）经cjson.encode()序列化后的string。客户端收到的是一个JSON字符串，不是JavaScript里的Object或Map。直接尝试用.map()或.flat()处理会报TypeError: xxx.map is not a function。
常见错误现象：redis.call("EVAL", script, 0, ...)返回值在Node.js里打印为"{\"users\":[{\"id\":1},{\"id\":2}]}"，但代码里写res.users.map(...)就崩了。
- 必须先用
JSON.parse()转成JS对象，再操作 - Lua端若没做
cjson.encode()，返回可能是nil、number或string混合，类型不可控 - Redis Stack启用
redis.json模块后，推荐用JSON.GET代替Lua拼JSON，避免手写序列化漏洞
flatMap() 在客户端解析多层JSON响应时容易误用
当Lua脚本返回类似{"results": [{"data": [1,2]}, {"data": [3,4]}]}这种结构，想提取所有data数组并合并成一维，有人会下意识写res.results.flatMap(x => x.data)——这能跑通，但前提是res已是JS对象。如果忘了JSON.parse()，res.results是undefined，整个表达式直接报错。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 正确链路：接收字符串 →
JSON.parse()→ 校验results存在且为数组 → 再.flatMap() - 别在
flatMap回调里对x.data做|| []兜底——它本就是数组，空值应来自Lua逻辑缺陷，该修脚本而非客户端补丁 - 若Lua返回的是
[[1,2], [3,4]]（二维数组），直接res.flat()即可，不用flatMap；只有需要“先取字段再合并”时才轮到flatMap
用 flat(Infinity) 处理Lua返回的任意深度嵌套数组
有些Lua脚本为兼容旧客户端，会把结果包三层：[[[1]], [[2,3]], [4]]。此时.flat(1)只剥一层，得[[1], [2,3], 4]；.flat(2)得[1, 2, 3, 4]——但你无法预知嵌套层数。
- 直接上
res.flat(Infinity)最省心，尤其当Lua构造逻辑不透明时 - 注意：
flat(Infinity)对含非数组项的混合结构无效，比如[1, [2, [3]], "hello"]中"hello"不会被过滤，也不会报错，它就原样留在结果里 - 如果Lua返回
null或undefined（经cjson.encode()后变成"null"字符串），JSON.parse()后是null，调.flat()会抛TypeError，务必前置判空
别让客户端承担本该由Lua或RedisJSON完成的扁平化
真正的问题不在“怎么用flatMap”，而在于为什么Lua脚本要返回需要客户端扁平化的结构？这通常意味着设计失衡：
- 若业务只需最终的ID列表，Lua脚本应直接
return cjson.encode({ids = {1,2,3}})，而不是返回带包装的嵌套结构 - 若用的是Redis Stack，优先用
JSON.SET key $.items [1,2,3]+JSON.GET key $.items，天然支持路径提取，无需客户端二次处理 - 高频调用场景下，每次
JSON.parse()+.flatMap()都是额外开销；把扁平逻辑下沉到Lua里（table.concat或循环table.insert）更高效
客户端flatMap和flat是应急手段，不是架构选择。当发现超过三处代码都在对同一类Redis响应做相同.flatMap(x => x.data)时，该重构Lua脚本或换用redis.json了。
