GORM连接PostgreSQL需用postgres.Open(dsn)传DSN（如"host=localhost user=postgres password=... sslmode=disable TimeZone=Asia/Shanghai"），必须显式关闭SSL、设置时区、校验环境变量、全局复用DB并配置连接池。
如何在Fiber中正确初始化gorm连接PostgreSQL
直接用gorm.Open传裸字符串会出错——PostgreSQL连接URL必须带sslmode参数，否则gorm默认启用SSL，而本地开发环境通常没配证书，导致连接拒绝。
推荐写法是显式构造DSN，并强制关闭SSL（开发阶段）：
import (
"gorm.io/driver/postgres"
"gorm.io/gorm"
)
dsn := "host=localhost user=postgres password=password dbname=mydb port=5432 sslmode=disable TimeZone=Asia/Shanghai"
db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
-
sslmode=disable是关键，不加就卡在dial tcp: i/o timeout或server doesn't support SSL -
TimeZone=Asia/Shanghai避免时间字段写入时区偏移错误（尤其配合time.Time字段） - 密码含特殊字符（如
@、/）必须用url.QueryEscape编码，否则解析失败
为什么DB_HOST等环境变量要从.env加载而非硬编码
硬编码数据库地址在Git提交后等于公开生产凭据；更隐蔽的问题是：Fiber启动时若os.Getenv取不到值，gorm.Open会用空字符串拼接DSN，最终报invalid port number或missing "=" after "host" in connection info string这类模糊错误。
安全做法是用godotenv加载.env，并做必要校验：
import "github.com/joho/godotenv"
err := godotenv.Load()
if err != nil {
log.Fatal("failed to load .env")
}
dsn := fmt.Sprintf(
"host=%s user=%s password=%s dbname=%s port=%s sslmode=disable",
os.Getenv("DB_HOST"),
os.Getenv("DB_USER"),
os.Getenv("DB_PASSWORD"),
os.Getenv("DB_NAME"),
os.Getenv("DB_PORT"),
)
- 确保
.env文件位于main.go同级目录，否则godotenv.Load()找不到 - 所有
os.Getenv调用前建议加非空判断，比如if os.Getenv("DB_PORT") == ""就提前panic
fiber.App启动前必须完成db.AutoMigrate
很多人把AutoMigrate放在HTTP handler里，结果第一次请求才建表——这会导致并发请求时多个goroutine同时执行迁移，触发duplicate key violates unique constraint或relation already exists错误。
正确时机是在app := fiber.New()之后、app.Listen()之前：
app := fiber.New()
// 初始化db后立即迁移
if err := db.AutoMigrate(&User{}, &Post{}); err != nil {
log.Fatal("migrate failed:", err)
}
app.Listen(":3000")
-
AutoMigrate不是“每次启动都重置表”，它只新增缺失字段或索引，不会删数据（但会改列类型，慎用于生产） - 如果模型结构变更频繁，建议搭配
db.Migrator().DropColumn等手动操作，而非依赖AutoMigrate
连接池配置不当会导致too many connections
PostgreSQL默认最大连接数是100，而Fiber默认不限制goroutine数量。若每个请求都新建*gorm.DB实例（而不是复用单例），几秒内就能打满连接池。
必须全局复用一个*gorm.DB，并通过SetMaxOpenConns和SetMaxIdleConns节流：
sqlDB, err := db.DB()
if err != nil {
log.Fatal(err)
}
sqlDB.SetMaxOpenConns(20) // 同时最多20个活跃连接
sqlDB.SetMaxIdleConns(10) // 空闲连接池保持10个
sqlDB.SetConnMaxLifetime(time.Hour)
-
SetMaxOpenConns设太高，PostgreSQL服务端扛不住；设太低，高并发时请求排队，表现为延迟陡增 -
SetConnMaxLifetime防止连接因网络中断或服务重启后变成僵尸连接
sslmode和连接池参数——前者让本地跑不通，后者让压测时突然全链路超时。这两处不调好，其他逻辑再完善也白搭。 
