gorm 延迟建连，需调用 db.db().ping() 主动验证；dsn 必含 username:password@tcp(host:port)/dbname，host 与绑定地址一致，charset=utf8mb4，parsetime=true 与 loc=local 配对，密码特殊字符需 url 编码，并设置连接池参数及 timeout 类参数。
GORM 不会在调用 gorm.Open 时立即连上数据库，而是延迟到第一次执行查询（如 db.First、db.Find）才真正建连 —— 这意味着连接失败错误往往不会在初始化时抛出，而是在业务逻辑里突然冒出来。
DSN 字符串必须包含哪些关键参数
MySQL 的 DSN 是连接成败的起点，漏掉或写错任意一个基础字段都会导致 dial tcp: lookup xxx: no such host 或 access denied 类错误。
-
username:password@tcp(host:port)/dbname是固定骨架，host不能写成localhost而实际 MySQL 绑定的是127.0.0.1（反之亦然），尤其在 Docker 容器间通信时常见 -
charset=utf8mb4必须用utf8mb4，不是utf8；后者在 MySQL 8+ 中已被弃用，且不支持 emoji -
parseTime=True和loc=Local要配对使用：前者让 GORM 把DATETIME解析为time.Time，后者避免时区错乱（比如存进去是 CST，查出来变 UTC） - 密码含特殊字符（如
@、/、:）必须 URL 编码，否则 DSN 解析直接断裂 —— 用url.QueryEscape(password)包一层再拼接
gorm.Open 返回后要立刻检查底层连接池
gorm.Open 只返回一个 *gorm.DB 实例，它内部包装的是 *sql.DB 连接池，但这个池子默认是懒加载的，不主动探测连通性。
- 调用
db.DB()获取底层*sql.DB，然后执行sqlDB.Ping()主动验证连接是否可达（建议放在 init 阶段或服务启动时） - 务必设置连接池参数，否则默认最大打开连接数是 0（即无上限），高并发下可能耗尽 MySQL 的
max_connections：sqlDB.SetMaxOpenConns(50)、sqlDB.SetMaxIdleConns(10)、sqlDB.SetConnMaxLifetime(1h) - 别忽略
timeout、readTimeout、writeTimeout这三个 DSN 参数 —— 它们控制的是 TCP 层超时，和context.WithTimeout不是一回事，漏设会导致连接卡死在net.Conn.Read上
不同数据库驱动的导入和 DSN 格式差异
GORM 的多数据库支持靠的是 driver 包 + DSN 语法切换，换库不只是改字符串，还要换导入路径和 Open 方式。
- MySQL：
import "gorm.io/driver/mysql"，DSN 用user:pass@tcp(host:port)/name?...，注意mysql.Open(dsn)是函数调用，不是字符串 - PostgreSQL：
import "gorm.io/driver/postgres"，DSN 是 key=value 形式：host=localhost port=5432 user=user password=pass dbname=test sslmode=disable - SQLite：
import "gorm.io/driver/sqlite"，DSN 就是文件路径：test.db?_foreign_keys=1，无需 host/port - 别混用旧版驱动（如
github.com/jinzhu/gorm）和新版（gorm.io/gorm），它们的 DSN 解析逻辑和错误提示完全不同
最常被跳过的一步是：没对 *sql.DB 调用 Ping() 就上线了，结果第一个用户请求就触发连接失败 panic。GORM 的懒连接设计本意是减少冷启动开销，但也把故障暴露时机往后推了一层 —— 你得自己把它拉回启动阶段来兜底。
