redis hyperloglog统计千万级uv需严守三原则：key必须按业务、时间、实例多维隔离，禁用全局key；pfadd不可在pipeline或事务中重复调用同一key；pfcount返回值为±0.81%误差的估算值，不可用于精确告警或对账。
直接用 PFADD + PFCOUNT 就能跑起来，但线上出问题基本都卡在 key 设计、并发误用和误差认知这三块。
key 必须带业务维度与时间戳，不能裸用一个固定名
常见错误是写成 hll:api:login 这种全局 key，所有实例、所有时间的请求全往里塞，结果 UV 越滚越大，完全不可分析。真实场景要同时支持「按接口 + 按小时/天 + 按服务实例」三个维度隔离：
- 推荐格式：
hll:api:{service}:{endpoint}:{date}，例如hll:api:auth:login:2026-09-03 - 日期必须用 UTC 格式（
time.Now().UTC().Format("2006-01-02")），避免多机房部署时因本地时区不一致导致同一天数据拆到两个 key - 如果要做分钟级监控，把
{date}换成{date}:{hour}:{minute}，但注意 Redis 单 key 的 HLL 结构在高频写入下可能成为热点，QPS 超 3k 时建议加一层分片，比如hll:api:login:2026-09-03:{shard}，其中shard = hash(userID) % 16
别在事务或 pipeline 里对同一 key 多次调用 PFADD
PFADD 是原子操作，但 Redis 在 pipeline 或 MULTI/EXEC 中对同一 key 多次 PFADD，只保留最后一次的效果——不是报错，而是静默丢弃前面的调用。现象是：明明日志显示写了 100 个用户 ID，PFCOUNT 却只返回 1～2 个。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 正确做法：批量提交，一次
PFADD带上最多 100 个userID，例如client.PFAdd(ctx, key, userID1, userID2, ..., userID100) - Go 客户端传参类型必须统一，
userID别混用string和int64，否则哈希结果不同，会被当成两个不同元素重复计数 - 不要为每个请求都建新
context.WithTimeout，共用一个带 500ms 超时的ctx即可，减少 goroutine 开销
PFCOUNT 返回的是估算值，不能当精确数用于告警阈值判断
你看到 PFCOUNT 返回 100234，不代表真实独立数就是这个值，它只是基于概率模型的估算，标准误差 ±0.81%，即真实值大概率落在 99400～101000 区间。更麻烦的是 Redis 内部有缓存机制：连续调用 PFCOUNT 可能返回相同数字，哪怕刚 PFADD 了新 ID。
- 高频轮询（如每秒查一次）时，建议在应用层加内存缓存，例如用
sync.Map存map[string]int64，每分钟定时刷一次PFCOUNT并更新本地值 - 做“单分钟 UV 突破 5000 触发告警”这类逻辑，必须用本地缓存后的值，而不是每次直连 Redis
- 绝对不要拿
PFCOUNT和数据库COUNT(DISTINCT user_id)对账——原理完全不同，数值必然不等，只会引发无意义排查
跨时间窗口聚合要用 PFMERGE，但它不支持差集和交集
比如要算“最近 7 天 UV”，不能只读一个 key，得先构造 7 个日期 key，再合并。但 PFMERGE 是单向合并，且会新建 key，原 key 不变。
- 示例：合并
hll:api:login:2026-08-28到hll:api:login:2026-09-03，命令是PFMERGE hll:api:login:week20260903 hll:api:login:2026-08-28 hll:api:login:2026-08-29 ... hll:api:login:2026-09-03 - 合并后记得用
PFCOUNT读新 key，别去查旧 key - 如果业务需要“7 天内活跃但昨天没访问的用户数”，HLL 无法直接算——它不存明细，也没交集/差集能力，这种需求得切回 Bitmap 或业务侧落库
最易被忽略的一点：HLL 的 12KB 是 per-key 开销，不是全局开销。如果你按分钟建 key（一天 1440 个），又按 100 个接口建，那每天就生成 14 万个 key，Redis 内存碎片和 key 数量压力会快速上升。上线前务必用 INFO memory 和 INFO keyspace 实测压测数据。
