go-zero框架通过内置的core/config模块实现配置文件热加载,核心做法是调用config.loadconf()读取初始配置后,使用config.watch()监听文件变化并触发回调。在回调中重新解析配置并更新全局变量或结构体实例,即可在不重启进程的情况下生效新配置。

config.Watch()如何触发配置重载
该函数接收文件路径和回调函数,底层使用fsnotify监听文件修改事件。当检测到文件变更时,它会立即执行传入的回调函数,开发者需在回调中完成配置的重新加载和状态同步。

package main
import (
"fmt"
"log"
"github.com/zeromicro/go-zero/core/conf"
"github.com/zeromicro/go-zero/core/logx"
)
type Config struct {
Port int `json:"port"`
Name string `json:"name"`
}
var cfg Config
func main() {
// 1. 加载初始配置
err := conf.LoadConf("config.yaml", &cfg)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Initial config: %+v\n", cfg)
// 2. 启动监听
err = conf.Watch("config.yaml", func() {
var newCfg Config
// 3. 在回调中重新加载
err := conf.LoadConf("config.yaml", &newCfg)
if err != nil {
logx.Error("reload failed:", err)
return
}
// 4. 原子性更新全局配置
cfg = newCfg
fmt.Printf("Reloaded config: %+v\n", cfg)
})
if err != nil {
log.Fatal(err)
}
select {}
}
运行上述代码后,修改config.yaml中的port值,控制台会打印新的配置信息,证明热加载生效。注意回调中必须处理错误,否则静默失败会导致配置不一致。
多配置文件场景下的热加载策略
当项目包含多个配置文件(如main.yaml和db.yaml)时,需要分别对每个文件调用conf.Watch()。每个文件的变更都会独立触发其对应的回调逻辑,确保各部分配置能灵活更新。

package main
import (
"fmt"
"log"
"github.com/zeromicro/go-zero/core/conf"
)
type MainConfig struct {
Port int `json:"port"`
}
type DBConfig struct {
DSN string `json:"dsn"`
}
var mainCfg MainConfig
var dbCfg DBConfig
func main() {
// 加载主配置
conf.LoadConf("main.yaml", &mainCfg)
// 加载DB配置
conf.LoadConf("db.yaml", &dbCfg)
// 监听主配置
conf.Watch("main.yaml", func() {
var temp MainConfig
conf.LoadConf("main.yaml", &temp)
mainCfg = temp
fmt.Println("Main config reloaded")
})
// 监听DB配置
conf.Watch("db.yaml", func() {
var temp DBConfig
conf.LoadConf("db.yaml", &temp)
dbCfg = temp
fmt.Println("DB config reloaded")
})
select {}
}
这种模式下,修改db.yaml只影响dbCfg,不会干扰mainCfg。建议将不同维度的配置拆分到不同文件,便于独立管理和热更新。
热加载过程中如何保证并发安全
由于热加载回调可能在任意时刻被触发,而业务代码可能同时读取配置,因此直接赋值全局变量存在竞态条件。应使用sync/atomic或sync.RWMutex保护配置读写,确保读取到的配置是完整且一致的。
package main
import (
"sync"
"fmt"
"log"
"github.com/zeromicro/go-zero/core/conf"
)
type Config struct {
Port int `json:"port"`
}
var (
cfg Config
mu sync.RWMutex
)
func GetConfig() Config {
mu.RLock()
defer mu.RUnlock()
return cfg
}
func main() {
conf.LoadConf("config.yaml", &cfg)
conf.Watch("config.yaml", func() {
var newCfg Config
conf.LoadConf("config.yaml", &newCfg)
mu.Lock()
cfg = newCfg
mu.Unlock()
fmt.Println("Config updated safely")
})
// 模拟业务读取
go func() {
for {
c := GetConfig()
fmt.Printf("Reading: %+v\n", c)
}
}()
select {}
}
通过RWMutex,读操作无锁,写操作加锁,既保证了性能又确保了数据一致性。这是生产环境中推荐的热加载实践方式。











