gorm 不支持自动加载配置文件，多环境配置需上层框架（如 viper）或手动实现；常见问题包括路径错误、环境变量未兜底、敏感信息硬编码；正确做法是绝对路径加载、环境变量优先覆盖、secret 注入敏感字段。
GORM 本身不读配置文件，所谓“配置文件抽取”本质是项目层封装行为——你得自己选库、定路径、写加载逻辑，再把结果喂给 gorm.Open。 直接依赖 GORM 自带能力做多环境隔离，一定会在上线前夜发现 config-prod.yaml 没生效、DB_HOST 还是 localhost。
为什么不能靠 GORM 自动加载 config-{env}.yaml
GORM V2 的 gorm.Open 接口只接受一个 *sql.DB 或驱动 DSN 字符串，它不解析 YAML/JSON/TOML，也不关心环境变量。所谓“多环境配置”，全是上层框架（如 go-zero、Viper、GoFrame）或你自己写的初始化函数干的活。
- 如果你用
viper，它负责找config.yaml、config.prod.yaml并合并，你得手动调viper.GetString("database.dsn")拿值传给gorm.Open - 如果你用
go-zero的-f参数启动，它会加载指定 YAML 并注入结构体字段，但你要确保结构体 tag 里写了db:或自定义映射，且该结构体最终被用来构造 DSN - 如果你什么都没封装，直接写死
dsn := "user:pass@tcp(...)"，那恭喜，所有环境都用同一套连接串，连隔离的边都没摸到
用 Viper 加载时最常踩的三个路径坑
viper.AddConfigPath("./config") 看似简单，但在不同运行方式下指向完全不同的物理目录：
-
go run main.go：工作目录是项目根目录，./config就是your-project/config/ - 编译后执行
./myapp：工作目录是当前 shell 所在路径，./config可能根本不存在，报错Config File Not Found - Docker 容器内：除非显式
WORKDIR /app并挂载配置目录，否则./config是空的
安全做法是用绝对路径定位配置目录：viper.AddConfigPath(filepath.Join(os.Getenv("APP_HOME"), "config"))，或启动时通过 -c /etc/myapp/config.yaml 显式传入路径，再用 viper.SetConfigFile 绑定。
环境变量兜底必须显式接入，不能只靠 os.Getenv
硬编码 os.Getenv("DB_HOST") 看似直白，但漏掉空值判断、类型转换、默认值 fallback，上线后第一个报错就是 invalid port ":0"。
- 推荐用
github.com/caarlos0/env：结构体 tag 写env:"DB_HOST" default:"localhost"，env.Parse(&cfg)自动处理空值和类型转换 - 测试时可传入
map[string]string{"DB_HOST": "test-db"}覆盖，不用改系统环境变量 - 关键点：环境变量优先级必须高于配置文件——比如生产环境容器注入
DB_PASSWORD，就不能被config-prod.yaml里的明文密码覆盖
敏感字段必须拆离配置文件，走 Secret 注入
哪怕你把 config-prod.yaml 加密了，只要它进 Git，就等于密码进了历史记录。Kubernetes 下必须用 Secret + envFrom 注入，代码里只留占位符：
db:
dsn: "user:${DB_USER}:${DB_PASSWORD}@tcp(${DB_HOST}:${DB_PORT})/mydb"
然后由 Viper 的 viper.AutomaticEnv() 和 viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) 把 db.dsn 映射为 DB_DSN，再让环境变量覆盖。注意：YAML 中的 ${} 不会被 Viper 自动展开，得自己写替换逻辑，或改用 godotenv 的 Parse 函数（但它不适合生产环境）。
真正难的不是“怎么写多个配置文件”，而是确保每次启动时，DB_PASSWORD 来自 Secret、DB_HOST 来自 Service DNS、max_open_conns 在 prod 里是 100 而 dev 里是 10 —— 这些值之间不能有任意一个靠“约定”或“文档说明”来保证一致。
