Golang 实现基于 Redis 的布隆过滤器存储-Golang-PHP中文网

必须确认redis服务端已加载redisbloom模块，否则bf.add等命令报err unknown command；可通过module list命令或do("module list")验证是否存在name:bf；docker推荐redislabs/redismod镜像；go-redis/v9需用do()调用原生命令，注意参数类型、redis.nil处理及bf.reserve显式初始化防误判率失控。

直接结论：别用客户端封装的 bloomfilter，必须确认 redis 服务端已加载 redisbloom 模块，再用 do() 调用原生命令；否则会报 err unknown command `bf.add`。

如何确认 Redis 服务端支持 BF 命令

布隆过滤器不是 Redis 内置功能，而是通过 redisbloom 模块提供。很多线上 Redis 实例压根没装它，BF.ADD 直接报错就是第一信号。

登录 Redis CLI 执行 MODULE LIST，检查输出中是否有 name:bf 或 name:RedisBloom
Go 中可发命令验证：rdb.Do(ctx, "MODULE LIST").Val()，遍历结果找 map[string]interface{}{"name":"bf"}
Docker 开发环境推荐用 redislabs/redismod 镜像，它预装了 redisbloom、redisearch 等模块
自己编译 Redis 时，启动参数要带 --loadmodule /path/to/redisbloom.so，且日志里得出现 Module 'bf' loaded

用 `go-redis/v9` 正确调用 `BF.ADD` 和 `BF.EXISTS`

go-redis/v9（即 github.com/redis/go-redis/v9）是当前主流客户端，它支持 Do() 发送任意命令，无需额外封装库——但参数类型和空值处理极易出错。

BF.ADD 返回 int64：1 表示新增成功，0 表示已存在（不是布尔值）
BF.EXISTS 返回 int64，但 key 不存在时返回 redis.Nil，直接调 .Bool() 会 panic；必须先判 err == redis.Nil
所有参数必须是字符串：item 不能是 struct 或 []byte，得显式转成 string 或 fmt.Sprintf("%v", item)
示例关键片段：

ctx := context.Background()
key := "bloom:email"
item := "user@example.com"

// 添加
res, err := rdb.Do(ctx, "BF.ADD", key, item).Result()
if err == redis.Nil {
    // key 不存在，BF.ADD 会自动创建，默认 error_rate=0.01, capacity=100
} else if err != nil {
    log.Printf("BF.ADD failed: %v", err)
} else if n, ok := res.(int64); ok {
    if n == 1 {
        // 新增
    } else {
        // 已存在
    }
}

// 查询
val, err := rdb.Do(ctx, "BF.EXISTS", key, item).Result()
if err == redis.Nil {
    // key 未初始化，等价于“肯定没加过”
    return false, nil
}
if err != nil {
    return false, err
}
if exists, ok := val.(int64); ok {
    return exists == 1, nil
}

什么时候必须用 `BF.RESERVE`，以及如何避免并发创建失败

默认 BF.ADD 自动建 key 的容量只有 100、误判率 1%，稍大点的数据量就会让误判率失控。生产环境必须显式调用 BF.RESERVE 控制精度，但它在 key 已存在时会报 ERR not enough memory or key already exists。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

BF.RESERVE key 0.001 1000000 表示：期望误判率 0.1%，初始容量 100 万
不要用“先 BF.EXISTS 再 BF.RESERVE”——竞态下多个实例同时判断、同时创建，必有一部分失败
正确做法：直接执行 BF.RESERVE，捕获 redis.Nil（key 不存在）和 ERR key already exists 两种错误，其余异常才真正失败
更稳妥的策略是：由初始化脚本或配置中心统一创建，业务代码只读不写