Go语言实现简单配置热更新_Golang项目进阶实战_技术教程

Go程序热更新配置的关键在于安全触发重载与切换：viper.WatchConfig()仅触发回调，需手动ReadInConfig和Unmarshal；推荐用atomic.Value原子替换配置指针，避免锁竞争；环境变量不可热更，HTTP服务中连接池、日志等依赖需主动重建。

Go 程序无法原生热更新配置，所谓“热更新”本质是运行时重新加载配置并通知业务逻辑响应变化——关键不在 reload 本身，而在如何安全、低侵入地触发重载与切换。

用 `viper.WatchConfig()` 监听文件变更但别直接信它自动生效

viper 的 WatchConfig() 确实能监听 yaml/json 文件改动，但它只负责调用你注册的回调函数，**不自动合并新旧配置、不保证线程安全、也不帮你重建依赖对象**。

必须手动调用 viper.Unmarshal() 或 viper.Get() 读取新值，否则回调里看到的仍是旧快照
回调在 goroutine 中执行，若配置被多处并发读取（如 HTTP handler），需用 sync.RWMutex 或原子指针替换（atomic.StorePointer）
避免在回调里做耗时操作（如重连数据库），应发信号到主逻辑协程处理

func initConfig() {
	v := viper.New()
	v.SetConfigName("config")
	v.AddConfigPath("./conf")
	v.AutomaticEnv()
	v.ReadInConfig()
	v.WatchConfig()
	v.OnConfigChange(func(e fsnotify.Event) {
		log.Printf("Config changed: %s", e.Name)
		// 必须显式重载，否则 Get() 还是旧值
		if err := v.ReadInConfig(); err != nil {
			log.Printf("Failed to reload config: %v", err)
			return
		}
		// 安全发布新配置实例（假设 Config 是结构体）
		newConf := &Config{}
		if err := v.Unmarshal(newConf); err != nil {
			log.Printf("Failed to unmarshal new config: %v", err)
			return
		}
		atomic.StorePointer(&globalConf, unsafe.Pointer(newConf))
	})
}

用 `atomic.Value` 替换全局配置指针比加锁更轻量

当配置结构体较大或读多写少时，sync.RWMutex 会成为瓶颈；atomic.Value 允许无锁读取最新配置快照，写入时仅需一次指针原子替换。

atomic.Value 只支持 interface{}，需包装配置结构体指针，不能直接存结构体值（否则每次读都复制）
写入前必须确保新配置已
校验通过（如端口范围、URL 格式），否则下游可能拿到非法状态
HTTP handler 中用 conf := globalConf.Load().(*Config) 读取，无需 defer unlock

var globalConf atomic.Value

// 初始化时存默认配置指针
globalConf.Store(&defaultConfig)

// 热更新回调中
newConf := &Config{}
if err := v.Unmarshal(newConf); err == nil && newConf.IsValid() {
	globalConf.Store(newConf) // 原子替换
}