gorm v2 连 mysql 失败主因是 dsn 拼接错误：host/port 必须共存且 port 为字符串，user/pass 为空时需显式写 :，必须校验配置非空、加 parsetime=true&loc=local、charset=utf8mb4 及超时参数，并用 db.db().ping() 健康检查。
直接用 gorm.Open 连 MySQL，但 90% 的连接失败不是驱动或网络问题，而是 DSN 字符串拼错了——尤其是从配置文件读取参数时，v.GetString("db.mysql.host") 返回空字符串却没校验，结果生成了 :@tcp(:)/ 这种非法地址。
DSN 字符串必须严格按格式拼接
MySQL 的 DSN 格式是固定的：user:pass@tcp(host:port)/dbname?param1=value1¶m2=value2。少一个冒号、多一个空格、端口传成整数而非字符串，都会让 mysql.Open 解析失败。
-
host和port必须一起出现，且port必须是字符串（哪怕值是"3306"），不能是3306整数 -
user和pass允许为空，但不能留空字段：比如密码为空，写成root:@tcp(...)；如果连用户名都空，就会变成:@tcp(...)，直接 panic - 查询参数中
charset=utf8mb4比utf8更安全（支持 emoji），parseTime=True和loc=Local建议始终带上，否则 time 类型字段会变成字符串 - 超时参数要显式加：
timeout=10s&readTimeout=30s&writeTimeout=60s，否则默认无限制，出问题时卡死难排查
配置加载后必须做非空校验
用 viper、koanf 或其他配置库读取时，v.GetString 在 key 不存在或为空时一律返回 ""，不会报错。这意味着你可能在完全不知情的情况下拼出一个无效 DSN。
- 校验项至少包括：
host、port、user、dbname；pass可选但建议也校验（空密码是明确意图，不是缺失） - 不要只判断
== ""，还要检查是否全空白（strings.TrimSpace） - 校验失败应
return fmt.Errorf("missing required config: db.mysql.%s", key)，而不是默默继续 - 开发期可加一行日志打印脱敏后的 DSN 前缀，如
log.Printf("dsn prefix: %s:***@tcp(%s:%s)/", user, host, port)
gorm.Open 后必须 Ping 数据库
gorm.Open 只初始化连接池，并不真正拨号。很多服务启动后看似成功，一查库就报 dial tcp: lookup xxx: no such host 或 connection refused，就是因为跳过了健康检查。
- 调用
db.Exec("SELECT 1").Error或更标准的sqlDB, err := db.DB(); err = sqlDB.Ping() - 如果
Ping()失败，说明网络、认证或权限有问题，此时应立刻退出，不要让服务带病运行 - 注意：GORM v2 的
*gorm.DB不再暴露Ping方法，必须先用db.DB()获取底层*sql.DB - 别把
Ping放进重试循环里——它本就是同步阻塞调用，重试逻辑应由上层控制（如启动脚本或 k8s liveness probe）
最常被忽略的是：配置键名写错（比如 db.mysql.host 写成 db.mysql.hostname），导致所有字段为空，但程序仍能编译通过、启动成功，直到第一次查库才崩。这种静默失败比明显报错更危险。
