beego.loadappconfig 默认不加载自定义配置段（如[mysql]），需显式调用并指定段名和文件路径，且必须在beego.run()前执行；嵌套配置应使用独立yaml/json文件配合第三方解析器手动注入；环境变量覆盖需主动读取并调用set设置；热重载需自行监听文件变更并谨慎处理一致性问题。
beego.LoadAppConfig 为什么读不到自定义配置段？
默认只加载 app.conf 中的 [app]、[log]、[web] 等内置段，自定义段（如 [mysql]、[redis]）不会自动注入到全局配置对象里。
解决办法是显式调用 beego.LoadAppConfig 并传入段名和文件路径：
beego.LoadAppConfig("mysql", "conf/app.conf")
beego.LoadAppConfig("redis", "conf/app.conf")
注意两点：
- 必须在
beego.Run()之前调用，否则无效 - 第二次加载同名段会覆盖前一次，不支持合并
- 如果配置文件路径不是默认的
conf/app.conf，需写全路径（相对路径以可执行文件所在目录为基准）
如何安全读取嵌套结构配置（比如 JSON/YAML）？
Beego 原生 app.conf 不支持嵌套语法（如 db.urls = ["127.0.0.1:3306", "10.0.0.2:3306"]），强行写会导致解析失败或截断为字符串。
推荐方案：用独立配置文件 + 第三方解析器，再手动注入到 beego 配置中：
cfg, _ := config.ParseYamlFile("conf/database.yaml")
beego.AppConfig.Set("mysql.host", cfg.GetString("mysql.host"))
beego.AppConfig.Set("mysql.port", strconv.Itoa(cfg.GetInt("mysql.port")))
关键点：
- 避免直接用
beego.AppConfig.String("mysql.urls")试图解析数组——它只会返回原始字符串 - YAML/JSON 文件建议放在
conf/下，和app.conf分离，降低耦合 - 若用
config.ParseJsonFile，注意字段名大小写匹配（JSON 默认小写，Go struct tag 要对齐）
环境变量优先级怎么覆盖 app.conf？
Beego 默认不启用环境变量覆盖。要实现 MYSQL_HOST=10.10.10.10 beego run 这类行为，必须主动启用：
beego.BConfig.RunMode = beego.GetBConfig().RunMode
beego.AppConfig = &config.FileConfig{Path: "conf/app.conf"}
beego.AppConfig.Load()
beego.AppConfig.Set("mysql.host", os.Getenv("MYSQL_HOST")) // 手动覆盖
更稳妥的做法是封装一个初始化函数：
func loadConfig() {
beego.LoadAppConfig("app", "conf/app.conf")
if host := os.Getenv("MYSQL_HOST"); host != "" {
beego.AppConfig.Set("mysql.host", host)
}
}
常见陷阱：
-
os.Getenv返回空字符串不等于未设置，要检查len(host) > 0或用os.LookupEnv - 不能在
init()函数里调用os.Getenv后立即设值——此时beego.AppConfig可能还没初始化 - 环境变量名和配置 key 名最好保持一致（如
REDIS_PORT→redis.port），减少映射逻辑
热重载配置是否可行？
Beego 没有内置配置热重载机制。beego.AppConfig 是只读快照，修改文件后不触发重新加载。
如需运行时更新，得自己监听文件变更并重建配置：
fsnotify.Watch("conf/app.conf", func(e fsnotify.Event) {
if e.Op&fsnotify.Write != 0 {
beego.LoadAppConfig("mysql", "conf/app.conf") // 仅重载需要的部分
log.Println("mysql config reloaded")
}
})
但要注意：
- 重载期间可能读到中间状态（旧值 vs 新值混用），业务代码需加锁或双缓冲
- 不要 reload 全局
[app]段——有些字段（如runmode）改了会导致框架行为异常 - 生产环境慎用；多数场景更适合滚动重启 + 配置中心（如 Nacos、Consul）
真正难处理的是跨 goroutine 的配置一致性——哪怕 reload 成功，已启动的 service 实例仍持有旧配置指针。
