如何在 Go 中正确声明和使用全局数据库连接变量-Golang

在 go 中，`sql.db` 是数据库操作的核心类型，需通过 `database/sql` 包显式限定为 `*sql.db` 才能正确声明全局连接变量；直接使用 `*db` 会因未指定包名而报错。

Go 的标准库 database/sql 提供了抽象的数据库接口，而具体驱动（如 github.com/go-sql-driver/mysql）仅负责实现底层协议。因此，*所有数据库连接操作都应基于 `sql.DB类型，而非驱动包中的任意内部类型（如driver.Conn）**。sql.DB` 并非单个连接，而是一个线程安全的连接池管理器，可被多 goroutine 并发复用——这正是将其声明为全局变量的合理前提。

正确声明与初始化全局 *sql.DB

package main

import (
    "database/sql"
    "fmt"
    "log"
    _ "github.com/go-sql-driver/mysql" // 注意：仅需导入驱动（空白导入），无需使用其导出符号
)

var db *sql.DB // ✅ 正确：使用 sql.DB 类型，由 database/sql 包提供

func init() {
    var err error
    // 使用 = 赋值，避免 := 声明新局部变量覆盖全局 db
    db, err = sql.Open("mysql", "root:password@/Tracker")
    if err != nil {
        log.Fatal("Failed to open database:", err)
    }

    // 推荐：验证连接是否可用（测试一次真实连接）
    if err = db.Ping(); err != nil {
        log.Fatal("Failed to ping database:", err)
    }

    // 可选：设置连接池参数（生产环境建议配置）
    db.SetMaxOpenConns(25)
    db.SetMaxIdleConns(25)
    db.SetConnMaxLifetime(5 * time.Minute)
}

关键注意事项

• ❌ 不要尝试使用 *DB、driver.Conn 或反射推断类型——sql.DB 是唯一对外暴露且保证稳定的接口类型；
• ❌ 不要使用 := 在全局作用域初始化（Go 不允许），应在 init() 函数或 main() 中用 = 赋值；
• ✅ 驱动包必须以 _ 空白导入，使其 init() 函数注册到 database/sql，否则 sql.Open(“mysql”, …) 会返回 “unknown driver” 错误；
• ✅ *sql.DB 是并发安全的，Web 应用中可放心作为全局变量注入至 HTTP handler、服务层等各处；
• ⚠️ 全局变量虽便捷，但不利于单元测试（难以 mock）。中大型项目建议结合依赖注入（如使用 wire 或构造函数传参）提升可测试性与可维护性。

总之，var db *sql.DB 是 Go 数据库编程中最基础也最关键的一步——它简洁、安全、符合官方实践，是构建可靠后端服务的坚实起点。