Redis布隆过滤器必须通过redisbloom模块启用，原生Redis不支持；需用MODULE LIST验证是否加载bf模块，BF.RESERVE必须显式指定error_rate和capacity且不可修改，参数顺序错误或未加载模块会导致ERR unknown command。

Redis 布隆过滤器必须通过 redisbloom 模块启用，原生 Redis（包括 7.x）不自带布隆功能；误判率和容量必须在初始化时用 BF.RESERVE 显式指定，后续无法修改。

如何验证 redisbloom 模块已正确加载

模块未加载是配置失败最常见的原因，直接导致 BF.RESERVE 报错 (error) ERR unknown command `bf.reserve`。

• 连接 Redis 后执行 MODULE LIST，确认输出中包含 "name" "bf" 和对应版本号（如 20409 表示 v2.4.9）
• 若为空，检查 redis.conf 中是否写了 loadmodule /path/to/redisbloom.so，路径必须绝对且文件可读
• Docker 用户应使用官方镜像 redislabs/rebloom:latest，避免自行挂载错误版本的 .so 文件

BF.RESERVE 的参数必须按顺序传入且不可省略

命令格式为 BF.RESERVE key error_rate capacity [EXPANSION expansion] [NONSCALING]，其中前三个参数强制要求，顺序错或类型错都会报错。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

• error_rate 是十进制小数，不是百分比：写 0.001 表示 0.1%，写 0.1 是 10% —— 后者在生产环境基本不可用
• capacity 是预估总条目数，不是当前数据量；设太小会触发子过滤器扩容，查询性能下降；设太大浪费内存（位数组按 1.2–2 倍冗余分配）
• 若确定数据量稳定、不允许扩容，加 NONSCALING；否则建议用默认行为，但需监控 BF.INFO 中的 Number of filters 字段，超过 1 就说明已在降级

初始化后不能动态调整误判率或容量

布隆过滤器一旦创建，error_rate 和 capacity 就固化在位数组结构里，没有 BF.ALTER 或类似命令。

• 想改参数？只能删掉重建：DEL filter_key → 重新 BF.RESERVE → 重放所有历史数据（这在大流量系统中几乎不可行）
• 所以首次配置必须足够保守：比如预估 500 万用户 ID，按 1.5 倍即 750 万设 capacity，误判率选 0.001 而非 0.01
• 真正容易被忽略的是：BF.ADD 不校验是否超容，它会静默触发扩容逻辑；而 BF.MADD 批量添加时，部分成功部分失败也不会报错，需自己检查返回数组里的 1/0

最麻烦的点在于——你永远没法在运行时“试错”调参。一次配错，要么扛着高误判率上线，要么停服重建，没有中间态。