本文详解 go 应用中 `*sql.db` 的安全初始化与依赖传递方式，重点解决因 `:=` 导致的变量遮蔽引发的 nil 指针 panic，并推荐符合 go 习惯的依赖注入实践。
在 Go 中管理数据库连接时，一个常见但极易被忽视的陷阱是变量遮蔽（variable shadowing）——它直接导致 *sql.DB 未被正确赋值，进而引发运行时 panic（如 invalid memory address or nil pointer dereference）。你提供的代码中，问题根源正在于此：
func Connect() {
db, dberr := sql.Open("mysql://...", "...") // ❌ 错误：db 是新声明的局部变量！
// 外部包级 var db *sql.DB 未被赋值，仍为 nil
}使用 := 在函数内声明并初始化 db，会创建一个新的局部变量 db，而非为包级变量 db 赋值。因此，后续调用 SaveUser 或 GetUser 时实际操作的是未初始化的 nil 指针，必然 panic。
✅ 正确做法：显式赋值 + 错误处理强化
首先修复遮蔽问题，并完善错误处理：
package mysqlstorage
import (
"database/sql"
"fmt"
"log"
_ "github.com/go-sql-driver/mysql" // 替换为实际驱动
"your-app/types"
)
var DB *sql.DB // 命名建议：大写 DB 更符合 Go 包导出惯例
// Connect 初始化并验证数据库连接
func Connect(connStr string) error {
var err error
DB, err = sql.Open("mysql", connStr) // ✅ 使用 = 赋值给包级变量
if err != nil {
return fmt.Errorf("failed to open SQL connection: %w", err)
}
// 强烈建议：立即执行 Ping 验证连接有效性
if err = DB.Ping(); err != nil {
return fmt.Errorf("failed to ping database: %w", err)
}
// 可选：配置连接池参数（生产环境必备）
DB.SetMaxOpenConns(25)
DB.SetMaxIdleConns(25)
DB.SetConnMaxLifetime(5 * time.Minute)
return nil
}⚠️ 注意：sql.Open 本身不建立物理连接，仅返回准备就绪的连接池对象；DB.Ping() 才真正发起一次握手验证。
? 不推荐：全局单例 + 隐式依赖
虽然上述修复能让代码“跑起来”，但将 DB 设为包级全局变量存在严重设计缺陷：
- 测试困难：无法为单元测试注入 mock 数据库；
- 耦合度高：业务逻辑层（如 services）隐式依赖 mysqlstorage.DB，违反依赖倒置原则；
- 生命周期失控：难以精确控制连接池的关闭时机（DB.Close() 必须在应用退出前调用）。
✅ 推荐：依赖注入（Dependency Injection）
将 *sql.DB 作为依赖项显式传入数据访问层，实现松耦合与可测试性：
// 定义仓储接口（可选，增强抽象性）
type UserStore interface {
SaveUser(u types.User) error
GetUser(id string) (types.User, error)
}
// 具体实现
type MySQLUserStore struct {
db *sql.DB
}
func NewMySQLUserStore(db *sql.DB) *MySQLUserStore {
return &MySQLUserStore{db: db}
}
func (s *MySQLUserStore) SaveUser(u types.User) error {
_, err := s.db.Exec("INSERT INTO users (...) VALUES (...)", u.Name, u.Email)
return err
}
func (s *MySQLUserStore) GetUser(id string) (types.User, error) {
var u types.User
err := s.db.QueryRow("SELECT ... FROM users WHERE id = ?", id).Scan(&u.ID, &u.Name)
return u, err
}在 main.go 中统一初始化并注入：
func main() {
// 1. 初始化数据库连接
db, err := sql.Open("mysql", "user:pass@tcp(127.0.0.1:3306)/mydb")
if err != nil {
log.Fatal(err)
}
if err = db.Ping(); err != nil {
log.Fatal(err)
}
defer db.Close() // 确保应用退出时释放资源
// 2. 构建依赖树
userStore := mysqlstorage.NewMySQLUserStore(db)
userService := services.NewUserService(userStore)
// 3. 启动 HTTP 服务...
}? 关键总结
- 永远警惕 :=：在需修改包级变量时，务必使用 = 显式赋值；
- sql.Open ≠ 连接成功：必须调用 Ping() 验证；
- 连接池即服务：*sql.DB 是线程安全的长期持有对象，应全局复用（但通过 DI 传递，而非全局变量）；
- 显式优于隐式：依赖应通过构造函数或方法参数注入，而非跨包读取全局状态；
- defer db.Close() 是责任：确保在应用生命周期结束时释放底层资源。
遵循以上实践，你的 Go 应用将具备健壮的数据库访问能力、清晰的依赖边界和可持续维护的架构基础。
