讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

如何利用Redis GEO实现附近的人搜索_通过GEORADIUS与GEOHASH

夏伟酱_3299

夏伟酱_3299

发布时间:2026-06-16 08:42:22

|

718人浏览过

|

来源于php中文网

原创

GEORADIUS返回空或错误,主因是GEOADD经纬度顺序颠倒、单位缺失、坐标系未转换(如GCJ-02未转WGS84)或坐标越界;其底层依赖GeoHash将经纬度编码为52位整数存于ZSET,通过范围扫描实现高效查询。

如何利用redis geo实现附近的人搜索_通过georadius与geohash

直接用 GEORADIUS 就能查出“附近的人”,但结果不准、为空或性能骤降,八成是 GEOHASH 精度没对上,或者根本没意识到 GEORADIUS 底层靠它干活。

为什么 GEORADIUS 返回空或距离明显错误

这不是 Redis 坏了,而是写入和查询时坐标系/顺序/单位三者中至少有一项没对齐:

  • GEOADD 必须严格按 经度 longitude 在前、纬度 latitude 在后 —— 写反(比如 39.915 116.404)会让北京落到南美洲;
  • 所有查询命令(GEORADIUS、GEORADIUSBYMEMBER)必须显式带单位,如 km 或 m,漏写会导致默认按米解析,5 公里写成 5 就只查了 5 米;
  • 前端地图 SDK(高德、百度)用的是 GCJ-02 坐标系,而 Redis GEO 默认按 WGS84 计算,不转换就存,距离偏差可达 500 米以上;
  • GEORADIUS 不校验坐标合法性,超出 -180~180(经度)或 -85.05112878~85.05112878(纬度)范围会静默失败,返回空数组。

GEORADIUS 和 GEOHASH 是什么关系

GEORADIUS 本身不直接操作经纬度,它实际是在查 GEOHASH 编码后的有序集合(ZSET)。Redis 把每个位置转成一个 52 位整数 score(本质是 GeoHash 的 base32 解码值),再利用 ZSET 的范围扫描能力快速圈出候选点。

这意味着:

Sentinal Redis
Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。

下载
  • GEOHASH 长度决定精度:长度 6 → 约 1.2km × 0.6km 单元格;长度 8 → 约 38m × 19m;业务常用 6–8 位,够用且内存友好;
  • 你不能手动改 ZSET 的 score —— 它由 Redis 自动计算并锁定,强行 ZADD 修改会导致 GEORADIUS 结果错乱;
  • GEOHASH 命令只用于调试,比如查 GEOHASH nearby_users user:1001 看编码是否合理,生产环境不用它做业务逻辑;
  • 没有“设置 GEOHASH 长度”的配置项 —— 精度由输入坐标的浮点精度和 Redis 内部编码固定决定,你只需保证传入的 longitude/latitude 有足够小数位(建议 ≥6 位)。

怎么写出稳定可用的 GEORADIUS 查询

一条能进生产环境的 GEORADIUS 命令,得同时满足可读、可测、可分页、可纠错:

  • 必加修饰符:WITHDIST(返距离)、WITHCOORD(返坐标),否则前端拿不到渲染 Marker 所需数据;
  • 排序必须显式写:ASC(由近到远)或 DESC,不写就是无序,无法保障“最近的 10 人”逻辑;
  • 限制数量用 COUNT n,放在参数末尾,例如 GEORADIUS users 116.404 39.915 5 km WITHDIST WITHCOORD ASC COUNT 20;
  • 响应是交错数组:["user:1001", "0.8245", ["116.40421", "39.91503"], "user:1002", ...],解析时不能硬按每 3 个元素一组拆,要根据是否启用 WITHCOORD/WITHDIST 动态跳位;
  • 如果用 GEORADIUSBYMEMBER,先确保 member 存在 —— 它查不到时不报错,只返回空数组,业务层得靠 strlen($result) === 0 或 empty($result) 判断“用户不存在”还是“附近没人”。

容易被忽略的边界点

最常踩的坑不在命令本身,而在数据生命周期里:

用户下线后位置不该一直留着 —— GEORADIUS 不管数据新旧,过期用户会持续拉低查询效率、污染结果。别依赖 TTL 自动清理,因为 GEO 数据存在 ZSET 里,TTL 对 key 有效,但 ZSET 成员不会自动过期。正确做法是:用户下线时主动 ZREM users:user_id,或用定时任务扫描过期成员(比如 last_active_time 字段 + Sorted Set score 存时间戳做联合索引)。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4989

2023.11.02

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4575

2023.11.14

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

8932

2024.04.02

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

683

2024.04.07

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

776

2024.04.07

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

9342

2024.04.07

redis缓存一般存些什么数据
redis缓存一般存些什么数据

redis缓存中存储的数据类型包括:字符串、哈希、列表、集合、有序集合、位图、地理空间数据和hyperloglog。这些数据类型适用于存储各种数据,从简单信息到复杂对象和地理位置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1200

2024.04.07

redis的8种数据类型有哪些
redis的8种数据类型有哪些

redis 提供 8 种数据类型:字符串(文本、数字、二进制)、哈希(键值对)、列表(有序集合)、集合(无序唯一元素)、有序集合(按分数排序)、地理空间(地理位置)、hyperloglog(估计大数据基数)和位图(位序列存储)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1496

2024.04.07

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go-Zero官方文档
Go-Zero官方文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn