在 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 数据库编程中最基础也最关键的一步——它简洁、安全、符合官方实践，是构建可靠后端服务的坚实起点。
