Redis GEOSEARCHSTORE 怎么保存附近对象结果

如果一次附近搜索的结果还要被分页、二次排序或交给后续任务处理，直接使用 GEOSEARCH 返回列表就不够了。GEOSEARCHSTORE 会把筛选结果写入一个新的有序集合：源键继续保留完整地理索引，目标键只保存本次命中的成员。

官方文档：https://redis.io/docs/latest/commands/geosearchstore/

一、先分清 source 与 destination

假设门店位置已存放在 store:geo，现在要把某个配送中心 5 千米内的门店保存为临时结果。命令的前两个键不能写反：

# 先准备一个带地理坐标的源索引；经度在前，纬度在后
GEOADD store:geo 116.3974 39.9093 "store-beijing"
GEOADD store:geo 116.4074 39.9143 "store-east"

# destination 在前，source 在后；返回值是写入目标集合的成员数量
GEOSEARCHSTORE store:nearby store:geo FROMLONLAT 116.3974 39.9093 BYRADIUS 5 KM ASC COUNT 20

这里 store:geo 是被查询的地理索引，store:nearby 是新结果集。把两者顺序写反，轻则查不到预期结果，重则覆盖原始索引，排查时应先用 TYPE 和 ZRANGE 确认键的职责。

二、用搜索形状和排序限制结果

中心点可以来自坐标，也可以来自源集合中的成员。圆形查询使用 BYRADIUS 半径 单位，矩形查询使用 BYBOX 宽 高 单位；两者互斥。需要最近的对象排在前面时使用 ASC，只想限制数量时加 COUNT。

# 以已有门店为中心，筛选 2 千米内最多 10 个对象
# FROMMEMBER 省去再次传坐标，但 member 必须存在于 source
GEOSEARCHSTORE store:nearby store:geo FROMMEMBER "store-beijing" BYRADIUS 2 KM ASC COUNT 10

# 用矩形覆盖仓储区域；width 和 height 使用同一个距离单位
GEOSEARCHSTORE warehouse:nearby store:geo FROMLONLAT 116.3974 39.9093 BYBOX 4 2 KM DESC

COUNT n ANY 可以更早停止寻找结果，但命中成员未必按距离有序；如果业务要展示“离我最近”的列表，不要把 ANY 和稳定排序混用。目标集合每次执行都会按本次查询重建，若要保留历史批次，应使用带批次号的目标键。

三、按用途决定是否使用 STOREDIST

不加 STOREDIST 时，目标仍是带地理编码信息的有序集合，适合继续进行地理查询。加入它以后，目标集合的 score 改成中心点到成员的距离，单位与查询形状一致，更适合直接用 ZRANGE 读取距离排序结果。

# 把距离保存为 score，单位沿用这里的 KM
# 返回值用于判断本次到底写入了多少个命中成员
GEOSEARCHSTORE store:distance store:geo FROMLONLAT 116.3974 39.9093 BYRADIUS 5 KM ASC COUNT 20 STOREDIST

# WITHSCORES 读取成员和距离；不要把这个目标键当作原始地理索引使用
ZRANGE store:distance 0 -1 WITHSCORES

选择规则可以压缩成一张表：

四、核对返回值与集群边界

命令返回写入目标集合的元素数量，而不是成员详情。发布到应用前，至少检查数量、目标键类型和实际顺序：

# 先看目标键是否存在以及类型是否仍为 zset
EXISTS store:distance
TYPE store:distance
ZRANGE store:distance 0 -1 WITHSCORES

# Redis Cluster 中让两个业务键共享 hash tag，避免跨槽写操作
GEOSEARCHSTORE store:{nearby}:distance store:{nearby}:geo FROMLONLAT 116.3974 39.9093 BYRADIUS 5 KM ASC STOREDIST

GEOSEARCHSTORE 同时读 source、写 destination，在 Redis Cluster 中属于需要单槽的多键写命令。生产环境不要只给一个键加标签；要让参与命令的键使用相同的花括号片段，并在客户端报错时区分 CROSSSLOT 与“结果数量为 0”。

相关问题

目标键已经存在会追加结果吗？

不会把本次命中简单追加到旧结果；应把目标键视为本次查询的结果快照。需要历史结果时使用不同批次键，或在应用层另行归档。

BYRADIUS 和 BYBOX 怎么选？

配送半径、附近门店等以中心点为圆的场景选 BYRADIUS；地图视窗或规则仓储区域更适合 BYBOX。

为什么 STOREDIST 后不能继续 GEOSEARCH？

因为目标集合的 score 已变成距离而不是地理编码。把它当普通 zset 读取，或重新对原始 source 执行地理命令。