Go的database/sql只是接口规范，不导入第三方驱动（如import _ "github.com/go-sql-driver/mysql"）会导致sql.Open静默成功但后续操作panic；必须显式调用db.Ping()验证驱动注册、网络连通与认证有效性。
Go 没有内置数据库驱动，database/sql 只是接口规范，真正干活的是第三方驱动 —— 配错包名、漏掉匿名导入、DSN 格式不对，三者任一出问题，sql.Open 就会静默失败或报 "driver: unknown driver mysql (forgotten import?)" 这类错误。
为什么 sql.Open 不报错但 Ping() 失败？
sql.Open 只是初始化连接池配置，并不真正建连；实际校验要靠 db.Ping()。常见误操作包括：
- 忘了加下划线匿名导入驱动：
_ "github.com/go-sql-driver/mysql"缺失 →sql.Open("mysql", dsn)找不到驱动 - DSN 中用户名/密码含特殊字符（如
@、/）未 URL 编码 → 连接被截断，报"invalid DSN: did you forget to escape a param value?" - MySQL 8.0+ 默认用
caching_sha2_password插件，而老版驱动不兼容 → 改用mysql_native_password或升级驱动
gorm.Open 和 sql.Open 的关键区别
GORM 是封装层，sql.Open 是底层原生接口。二者不能混用：
-
sql.Open返回*sql.DB，用于手写 SQL +Query/Exec，轻量、可控，适合简单场景 -
gorm.Open返回*gorm.DB，需额外传入驱动实例（如mysql.Open(dsn)），自带模型映射、预编译、钩子等，适合结构化业务 - 别把
sql.Open的 DSN 直接塞给gorm.Open：前者第一个参数是驱动名字符串（"mysql"），后者第一个参数是驱动实现（mysql.Open(dsn)）
SQLite 驱动在 Windows 上编译失败怎么办？
go get github.com/mattn/go-sqlite3 在 Windows 常因缺少 GCC 或 SQLite DLL 报错，典型错误是 "exec: 'gcc': executable file not found" 或 "undefined reference to sqlite3_*"：
立即学习“go语言免费学习笔记（深入）”；
- 必须安装 TDM-GCC（非 MinGW），且确保其 bin 目录在
PATH中 - 不要用
go install，改用go get -d先下载源码，再go build触发 CGO 编译 - 更稳方案：改用纯 Go 实现的
modernc.org/sqlite（无需 CGO），但注意它不兼容所有 SQLite 语法（如PRAGMA部分指令）
生产环境必须配连接池参数
本地跑通不等于线上可用。*sql.DB 和 *gorm.DB 底层都复用同一套连接池，不显式配置会导致连接耗尽或超时：
-
SetMaxOpenConns(20)：防止突发流量打爆 MySQL 的max_connections -
SetMaxIdleConns(5)：空闲连接太多会占用 MySQL 线程资源 -
SetConnMaxLifetime(3 * time.Hour)：避免连接因网络中间件（如 NAT 超时）被静默断开 - GORM 用户注意：
db.DB()才能拿到底层*sql.DB，直接对*gorm.DB设置无效
驱动不是装上就能用，它卡在“能连上”和“连得稳”之间那层薄薄的配置里 —— DSN 编码、CGO 环境、连接池阈值，每个都是线上故障的潜在入口。
