gorm.Open连PostgreSQL会panic，主因是DSN格式错误（缺host/port/user/password/dbname或未设sslmode=disable）或驱动未注册（漏掉_ "gorm.io/driver/postgres"导入），导致postgres.Open返回nil。
gorm.Open 连 PostgreSQL 为什么会 panic？
直接调用 gorm.Open 连 PostgreSQL 报错或崩溃，90% 是 DSN 格式错误或驱动未注册。GORM v2 不再自动注册驱动，必须显式导入：_ "gorm.io/driver/postgres"。漏掉下划线导入，postgres.Open 返回 nil，gorm.Open 就会 panic。
常见错误现象包括：
failed to connect database: failed to initialize database, got error unsupported driver: postgres- 空指针 panic（比如
panic: runtime error: invalid memory address）
检查点列表：
- 确认已执行
go get gorm.io/driver/postgres - 确保
main.go或初始化文件里有_ "gorm.io/driver/postgres"导入 - DSN 必须包含
host、port、user、password、dbname全部五项，缺一不可 - 本地开发务必加
sslmode=disable；否则默认走sslmode=require，连接会卡住或超时 - 推荐加上
TimeZone=Asia/Shanghai，避免时间字段写入/查询偏差
PostgreSQL DSN 字符串怎么拼才安全？
别手拼字符串，容易漏空格、少等号、错引号。用 url.URL 构建再转成字符串更可靠，尤其在读取环境变量时。
示例（推荐写法）：
import (
"net/url"
"os"
)
func buildPostgresDSN() string {
u := &url.URL{
Scheme: "postgres",
User: url.UserPassword(
os.Getenv("DB_USER"),
os.Getenv("DB_PASSWORD"),
),
Host: os.Getenv("DB_HOST") + ":" + os.Getenv("DB_PORT"),
Path: "/" + os.Getenv("DB_NAME"),
RawQuery: url.Values{
"sslmode": []string{"disable"},
"TimeZone": []string{"Asia/Shanghai"},
"search_path": []string{"public"},
}.Encode(),
}
return u.String()
}
关键细节：
-
search_path=public显式指定 schema，避免跨 schema 查询失败 - 密码含特殊字符（如
@、/）时，url.UserPassword会自动做 URL 编码，手拼极易出错 - 不要把
DB_PASSWORD硬编码进代码，一律走os.Getenv或viper配置中心
AutoMigrate 为什么没建表、也没报错？
AutoMigrate 不是“同步结构”，它只做最小可行创建：表不存在就建，字段缺失就加，但绝不会删字段、改类型、补索引。如果你改了 struct 但表已存在，它什么都不会做。
典型失效场景：
- Go struct 字段名首字母小写（如
name string）→ GORM 无法导出，该字段被忽略 - 主键没叫
ID（大写），也没加gorm:"primaryKey"→ GORM 默认找id字段，而 PostgreSQL 表列名是id，但映射逻辑错位 - 想用
jsonb类型却只写Tags []string→ 必须显式加gorm:"type:jsonb" - 想加唯一约束却只靠字段名猜（如
Email）→ 得写gorm:"uniqueIndex"或gorm:"unique"
调试建议：
- 启动时加日志：
&gorm.Config{Logger: logger.Default.LogMode(logger.Info)}，看 GORM 实际执行的 SQL - 手动连 psql，查
\d table_name确认字段是否真存在、类型是否匹配
事务没提交，接口卡住或锁表怎么办？
GORM 的事务不是自动提交的。db.Begin() 返回一个新 *gorm.DB 实例，后续所有操作（Create、Save、First）都必须在这个实例上调用，且最后必须显式 Commit() 或 Rollback()。漏掉任一环节，连接不释放，事务挂起，可能锁表或拖垮并发。
正确模式（带错误兜底）：
tx := db.Begin()
defer func() {
if r := recover(); r != nil {
tx.Rollback()
}
}()
if err := tx.Create(&user).Error; err != nil {
tx.Rollback()
return err
}
return tx.Commit().Error
注意点：
- 不能混用
db和tx：在tx上操作后，又用db.First去查——这查的是非事务上下文，可能读到旧数据 - 嵌套事务不被原生支持；GORM 的
Session或SavePoint是模拟，慎用于强一致性场景 - PostgreSQL 对长时间未提交的事务会阻塞 vacuum，影响数据库健康度
最易被忽略的是：事务失败后忘记 Rollback()，导致连接池耗尽、后续请求全部 hang 住。线上一定要配监控（如 pg_stat_activity 查 idle in transaction 状态）。
