GORM连接失败需精准识别真实错误类型：须用errors.As()提取驱动原生错误（pq.Error、mysql.MySQLError等），按协议码判断连接异常；DSN特殊字符必须URL编码；配置空值、连接池未设限亦致故障。
连接失败不是“连不上”，而是没识别出真实错误类型
GORM 的 db.Error 多数时候是包装过的抽象错误（比如 gorm.ErrRecordNotFound），根本不会暴露底层驱动的真实连接异常。直接判断 err != nil 就重试或告警，大概率把业务错误当成连接故障处理——比如唯一键冲突、字段超长、权限不足，都会触发 result.Error != nil，但它们和网络断开毫无关系。
真正要捕获的，是驱动原生错误结构体：*pq.Error（PostgreSQL）、*mysql.MySQLError（MySQL）、*mssql.Error（SQL Server）。必须用 errors.As() 或类型断言提取，再按协议规范判断是否属于连接类错误。
- PostgreSQL：检查
pqErr.Code[0:2] == "08"（如"08001"、"08006"） - MySQL：检查
mysqlErr.Number() == 1040 || mysqlErr.Number() == 2002 || mysqlErr.Number() == 2013 - SQL Server：检查
mssqlErr.Number == 10060 || mssqlErr.Number == 10061
DSN 字符串里含特殊字符（@、$、/）必须 URL 编码
密码含 @ 是高频故障点。GORM 解析 DSN 时会把第一个 @ 当作用户名/密码与 host 的分隔符，导致后续部分全被截断。例如 user:pass@word@192.168.1.1:1433 实际只取到 pass 为密码，word@192.168.1.1:1433 被当 host，必然失败。
正确做法是：对用户名、密码单独做 url.QueryEscape()，再拼进 DSN；或者——更推荐——改用参数化连接字符串（尤其 SQL Server）：
connectionString := fmt.Sprintf("server=%s;user id=%s;password=%s;port=%d;database=%s",
server, url.QueryEscape(user), url.QueryEscape(password), port, database)
- PostgreSQL DSN 示例：
host=localhost user=me password=%40my%24ecr3t dbname=test - MySQL DSN 示例：
user:pass%40123@tcp(127.0.0.1:3306)/test - SQL Server 强烈建议不用 URL 格式，直接用参数化字符串避免歧义
配置加载为空导致 DSN 生成非法（如 :@tcp(:)/）
常见于用 Viper、YAML 配置时键名写错、文件未加载、类型不匹配（比如端口配成字符串但代码里当 int 用）。最终生成的 DSN 类似 :@tcp(:)/，底层 net.Dial 报 dial tcp: unknown port tcp/——这不是数据库问题，是程序启动阶段就崩了。
调试关键点：
- 打印完整 DSN 再连接：
log.Printf("DSN: %q", dsn)，确认所有占位符都被替换 - 检查配置键路径是否带多余空格或大小写错误（
db.mysql.host≠db.Mysql.Host） - 对数字型字段（port、max_open_conns）用
v.GetInt()而非v.GetString()后强转
连接池耗尽或网络超时未设限，请求卡死而非报错
默认情况下，database/sql 连接池没有超时控制，一次慢查询或连接卡住，可能让整个服务线程阻塞几十秒。生产环境必须显式设置：
-
sqlDB.SetConnMaxLifetime(1 * time.Hour)：避免长连接因中间设备（如 NAT 网关）静默断连 -
sqlDB.SetMaxIdleConns(10)和sqlDB.SetMaxOpenConns(50)：防止突发流量打爆 DB - 在 DSN 中加超时参数：
connect_timeout=5（PostgreSQL）、timeout=5s（MySQL）、connection timeout=5（SQL Server）
这些设置不解决连接失败本身，但能让失败快速暴露——而不是让调用方无意义等待。
最易忽略的是：连接池参数必须在 gorm.Open() 之后，调用 db.DB() 获取底层 *sql.DB 才能设置。写在 gorm.Config 里无效。
