GEOPOS 查不到数据主因是 GEOADD 未成功：参数顺序错误（须经度在前）、成员名不一致、或 pipeline/事务中未等命令执行完；返回值为二维数组，含字符串型经纬度及 null，需显式转换且验证存在性。

用 GEOPOS 读取门店坐标前，先确认它真在 Geo 集合里

直接调 GEOPOS 却返回 nil 或空数组？大概率是门店名根本没成功加进 Geo 集合。Redis 的 Geo 命令不报错也不提示“不存在”，只默默返回空——这是最常踩的坑。

• GEOADD 必须严格按 经度 纬度 成员名 顺序传参，反了会导致坐标错乱（比如把北京存成南美洲）
• 成员名（如门店 ID）必须和后续 GEOPOS 查询时用的完全一致，大小写、空格、下划线都不能差
• 用 EXISTS 检查 key 是否存在不够，得用 ZCARD 看集合里有没有元素：ZCARD store:geo

GEOPOS 返回的数组结构怎么解析才不翻车

它返回的是二维数组：每个门店对应一个子数组，子数组里是 [经度, 纬度] 字符串。别直接当浮点数用，也别假设一定有值。

• 如果查询多个门店（GEOPOS store:geo shop_001 shop_002），结果是 [["116.48","39.92"], null] 这种混合类型——第二个 null 表示 shop_002 不在集合中
• 经度纬度都是字符串，需要显式转 float，否则做距离计算会出错（比如 Python 里 "116.48" + "39.92" 是拼接不是相加）
• 精度默认是小数点后 7 位，够用但别误以为是高精度坐标；如果业务要求更高，得自己存原始 double 值到 Hash 里

为什么 GEOPOS 查不到刚 GEOADD 的数据？检查事务和管道

在 pipeline 或 transaction 里执行 GEOADD 后立刻 GEOPOS，可能查不到——命令没真正落地。

• pipeline 中所有命令是批量发给 Redis，但响应也是批量返回；如果没等响应就去查，实际还没写入
• multi/exec 事务里，GEOPOS 不能放在 exec 里查刚 add 的数据，因为事务内命令不立即生效，得等 exec 完再单独查
• 简单验证法：在 GEOADD 后加个 sleep(0.1)（测试环境），或改用 GEODIST 配合已知存在的点交叉验证

替代方案：当 GEOPOS 不够用时，别硬扛

如果要查的不只是经纬度，还要门店名称、营业状态、最后更新时间这些字段，硬塞进 Geo 集合会很别扭。

• Geo 集合只存坐标和成员名，其他字段必须另存（比如用 HSET store:info:shop_001 name "朝阳大悦城" status "open"）
• 不要用 GEORADIUS + WITHCOORD 来代替 GEOPOS 查单点——性能差，语义也不对
• 如果频繁查坐标+详情，建议封装一层：先 GEOPOS 拿坐标，再 HGETALL 拿详情，两次 RTT 比折腾嵌套结构更稳

真实场景里，坐标读取失败八成不是指令写错了，而是前期 GEOADD 的参数顺序、成员名一致性、或者 pipeline 时序没理清。尤其要注意返回值里的 null 和字符串数字——它们不会主动提醒你出错了。