如何在 Go 项目中安全、高效地共享 MySQL 数据库连接

本文介绍一种符合 Go 语言惯用法的数据库连接共享方案：通过封装 *sql.DB 并利用结构体嵌入实现全局可复用、线程安全且易于管理的数据库实例，避免重复初始化和资源泄漏。 本文介绍一种符合 go 语言惯用法的数据库连接共享方案：通过封装 `*sql.db` 并利用结构体嵌入实现全局可复用、线程安全且易于管理的数据库实例，避免重复初始化和资源泄漏。在 Go 应用开发中，将数据库连接（如 *sql.DB）作为全局或包级变量共享是常见需求，但必须兼顾安全性、可维护性与生命周期管理。原始代码存在多个关键问题：dbType.DbConnect() 返回了新实例却未被接收；DbClose() 中误用 defer 导致延迟关闭失效；GetDb() 在未连接时返回 nil，引发运行时 panic；且包名 Database 不符合 Go 小写首字母命名规范。以下是推荐的工程化实践方案：? 正确做法：封装 + 嵌入 + 单例初始化首先，创建一个标准化的数据访问包（例如 datastore），*直接嵌入 `sql.DB**，使其自动继承所有sql.DB方法（如Exec、Query、Ping、Close` 等），无需手动代理：// datastore/db.gopackage datastoreimport ( "database/sql" _ "github.com/go-sql-driver/mysql")// DB 封装 *sql.DB，支持直接调用其全部方法type DB struct { *sql.DB}// NewDB 创建并初始化数据库连接，返回 *DB 实例func NewDB(dsn string) (*DB, error) { db, err := sql.Open("mysql", dsn) if err != nil { return nil, err } // 强制验证连接可用性（可选，但强烈建议） if err = db.Ping(); err != nil { db.Close() // 避免泄漏 return nil, err } return &DB{db}, nil}? 提示：sql.Open 本身不建立实际连接，Ping() 才触发首次连接校验，这对早期发现配置错误至关重要。 唱鸭 音乐创作全流程的AI自动作曲工具，集 AI 辅助作词、AI 自动作曲、编曲、混音于一体