valkey需加载redisbloom.so模块才支持布隆过滤器；bf.add报错因未加载模块，module list应显示name:bf；容量与误差率须预估准确，bf.exists为false时可安全跳过查询，true时需二次校验。
Valkey 里没有原生布隆过滤器，得装 redisbloom 模块
Valkey（原 Redis 兼容分支）默认不带布隆过滤器功能。直接调 BF.ADD 会报 ERR unknown command。必须手动加载 redisbloom 动态模块——注意不是 redis-bloom npm 包，那是客户端库。
- 下载对应 Valkey 版本的
redisbloom.so（推荐从 valkey-modules 官方仓库 release 页面找） - 启动时加参数：
valkey-server --loadmodule /path/to/redisbloom.so - 或配置文件写：
loadmodule /path/to/redisbloom.so - 验证是否加载成功：
MODULE LIST应看到name:bf
Golang 客户端要用 github.com/go-redis/redis/v9 + redisbloom-go
别用老版 github.com/go-redis/redis（v8 及以前），它不支持自定义命令透传；redisbloom-go 是专为 redisbloom 设计的封装，但底层仍依赖 redis/v9 的 Cmdable 接口。
- 安装：
go get github.com/go-redis/redis/v9和go get github.com/RedisBloom/redisbloom-go - 初始化客户端后，用
redisbloom.NewClient(rdb)包一层，再调BFAdd、BFExists - 注意：
redisbloom-go不处理连接池复用，要确保传入的*redis.Client已正确配置PoolSize和超时
BF.RESERVE 的 error_rate 和 capacity 必须预估准确
布隆过滤器一旦创建就不能改容量或误差率。大文件防穿透场景下，如果预估的总键数（capacity）偏低，后期 BF.ADD 会开始返回 false（实际是满载拒绝），导致漏判；误差率（error_rate）设太高，假阳性率上升，失去“防穿透”意义。
- 典型误配：
capacity=10000却往里塞 50 万条路径，BF.Exists返回true的概率飙升 - 经验公式：若预计存 N 条，希望误差率 ≤ 1%，
capacity至少取N * 1.2，error_rate设0.01 - 大文件名通常有规律（如
/files/{uuid}.zip），可按前缀 + 时间窗口预估总量，别拍脑袋填
穿透防护链路里，BF.Exists 失败不能直接回错
布隆过滤器返回 false 表示“肯定不存在”，这是安全的；但返回 true 只是“可能存在”，必须查后端存储二次确认。很多开发者把 BF.Exists == false 当作“请求非法”直接 404，结果缓存击穿没防住，反而把合法新路径拦掉了。
- 正确流程：先
BF.Exists(key)→ 若false，跳过 DB 查询，直接走下游逻辑（如返回空或触发异步生成） - 若
true，再查 DB 或对象存储；命中则返回，未命中才BF.ADD并缓存结果 - 特别注意：
BF.ADD要幂等，重复添加没问题，但别在BF.Exists == true时还调一次，纯属浪费
Valkey 布隆过滤器真正难的不是接入，而是容量预估和与业务逻辑的耦合点设计——比如文件上传完成时要不要立刻 BF.ADD，还是等首次访问再懒加载，这取决于你能否接受短暂的穿透窗口。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
