Buffalo 框架无官方 Redis 缓存连接器，需直接使用 github.com/redis/go-redis/v9 官方客户端；在 app.go 中全局初始化 *redis.Client 并 Ping 校验，设置超时，避免 lazy-init 导致并发连接失控。
Buffalo 框架没有叫 “Redis 缓存连接器” 的官方组件，你不需要安装任何 Buffalo 专属的 Redis 插件。 它不提供开箱即用的缓存中间件，也不封装 redis.Client。你要做的是直接集成标准 Go Redis 客户端，并手动管理连接生命周期。
为什么不能 go get github.com/gobuffalo/buffalo-redis
这个包不存在——Buffalo 官方生态里没有维护名为 buffalo-redis 或类似名称的缓存连接器。网上搜到的第三方同名项目往往过时、无维护、不兼容 v9，甚至混用老版 github.com/go-redis/redis（已弃用）。依赖这类包会导致：
- 编译失败：导入路径冲突或类型不匹配
- context 支持缺失：无法响应请求取消，HTTP 请求可能永久卡死
- 连接泄漏：未正确 Close() 或复用连接，进程内存持续上涨
应该 go get 什么：只装 redis/v9 官方客户端
你唯一需要安装的是 Redis 官方 Go 客户端：github.com/redis/go-redis/v9。它支持 context、原子操作、Pipeline、健康检查，是当前事实标准。
执行命令：
go get github.com/redis/go-redis/v9
注意：
- 不要加
-u参数，v9 版本语义化严格，升级需手动验证 - 别装
github.com/go-redis/redis（v8 及更早），它不支持context.Context透传 - 如果项目已用其他 Redis 库（如
redigo），必须统一替换，避免连接池混用
app.go 里怎么初始化 RDB 全局变量
在 app.go 的顶层声明并初始化 *redis.Client，确保整个应用共享单例连接池：
import "github.com/redis/go-redis/v9"
<p>var RDB *redis.Client</p><p>func app() <em>buffalo.App {
if app == nil {
// ... 其他初始化
RDB = redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // 无密码留空
DB: 0,
ReadTimeout: 5 </em> time.Second,
WriteTimeout: 5 * time.Second,
})</p><pre class='brush:php;toolbar:false;'> ctx := context.Background()
if _, err := RDB.Ping(ctx).Result(); err != nil {
log.Fatal("failed to connect to Redis:", err)
}
}
return app}
关键点：
-
RDB是全局变量，不是每次请求 new 出来的，避免连接爆炸 - 必须调用
Ping()，否则首次Get()或Set()才报错，启动时难发现 -
ReadTimeout/WriteTimeout不可省略，生产环境网络抖动时防止 goroutine 积压 - 别把
RDB塞进c.Value()或中间件参数里传递——多此一举且易出错
真正容易被忽略的是：Redis 连接初始化时机必须早于任何 action 调用；如果你在某个 handler 里才 lazy-init RDB，并发请求下可能触发多次 NewClient，导致连接数失控或 Ping 校验遗漏。
