在长期运行的 go 服务中（如监听 sigterm 的 redis 客户端），需确保程序优雅退出时可靠释放连接；关键在于将 defer conn.close() 置于主生命周期作用域（如 main() 函数末尾），而非单次操作函数内。
在长期运行的 go 服务中（如监听 sigterm 的 redis 客户端），需确保程序优雅退出时可靠释放连接；关键在于将 defer conn.close() 置于主生命周期作用域（如 main() 函数末尾），而非单次操作函数内。
在构建高可用后端服务时，Redis 连接通常作为全局、复用的持久资源被初始化一次，并在整个应用生命周期中被多次读写。此时一个常见误区是：为避免重复建连而选择“长连接”，却忽略了连接释放的时机——若将 defer client.Close() 错误地放在某个业务方法（如 GetUser()）中，该 defer 将随函数返回立即执行，导致连接过早关闭，后续请求失败。
✅ 正确做法是：将连接初始化与 defer 绑定在同一作用域，且该作用域覆盖整个服务运行期。典型模式如下：
func main() {
// 初始化 Redis 客户端（推荐使用 github.com/redis/go-redis/v9）
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "",
DB: 0,
})
// ✅ 关键：defer 放在 main 函数顶层，确保进程退出前执行
defer func() {
if err := rdb.Close(); err != nil {
log.Printf("failed to close Redis client: %v", err)
}
}()
// 启动 HTTP 服务或消息监听器
srv := &http.Server{Addr: ":8080", Handler: setupRouter(rdb)}
// 监听 SIGTERM/SIGINT 实现优雅关闭
sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, syscall.SIGTERM, syscall.SIGINT)
go func() {
<-sigChan
log.Println("received shutdown signal, shutting down server...")
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Printf("server shutdown error: %v", err)
}
}()
log.Println("server started on :8080")
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatalf("server failed: %v", err)
}
}⚠️ 注意事项：
- defer 不保证一定执行：仅当所在函数正常返回（包括 panic 后被 recover）时触发；若进程被 os.Exit() 强制终止，所有 defer 均被跳过。因此，必须配合信号处理（如 SIGTERM）实现可控退出，避免 kill -9。
- 不要依赖 defer 在 goroutine 中关闭共享连接：每个 goroutine 的 defer 作用域独立，无法替代主流程的资源清理。
- 生产环境建议使用带上下文的 Close()（如 rdb.Close() 已支持 context），并在 Shutdown() 阶段主动等待连接空闲后再关闭，提升可靠性。
- 若使用连接池（如 redis.Pool 或现代客户端内置池），Close() 会释放全部底层连接并停止新连接创建，无需手动遍历清理。
总结：持久连接的生命周期应与应用程序主流程对齐。通过“顶层初始化 + 顶层 defer + 信号驱动优雅退出”三步组合，即可在保障性能的同时，确保资源 100% 可靠释放。
