Go服务热更新本质是配置重载而非容器重启，通过fsnotify监听配置文件变更，用sync.RWMutex保护配置结构体，校验新配置后安全重载并触发回调。
热更新在 Go 服务中本质是配置重载，不是 Docker 容器重启
Go 程序本身不支持“容器级热更新”——Docker 容器一旦启动，其进程 PID 和内存空间就固定了。所谓“热更新配置”，实际是指：Go 进程在不重启的前提下，监听配置变更（如文件修改、Consul/KV 变更、HTTP 接口触发），重新加载 config.yaml 或 env 并刷新内部变量、连接池、路由规则等。Docker 层面只需确保配置文件可被挂载且可被 inotify 监控（例如用 docker run -v /host/config:/app/config:ro）。
用 fsnotify 监听配置文件变化并安全重载
fsnotify 是最轻量、最可控的文件监听方案，适合 YAML/TOML/JSON 配置。关键点不是“监听到就立刻 reload”，而是避免并发冲突和中间态错误：
- 使用
sync.RWMutex保护全局配置结构体，Load()时写锁，业务读取时只读锁 - 监听
fsnotify.WriteEvent和fsnotify.CreateEvent，但忽略编辑器临时文件（如*~、.swp） - 重载前先
validate()新配置，失败则跳过并记录警告，不覆盖旧配置 - 重载后触发回调（如
updateDBConn()、reloadRouter()），而非直接改字段
package main
import (
"log"
"os"
"sync"
"syscall"
"gopkg.in/yaml.v3"
"github.com/fsnotify/fsnotify"
)
type Config struct {
Port int `yaml:"port"`
DB struct {
Addr string `yaml:"addr"`
} `yaml:"db"`
}
var (
config Config
configLock sync.RWMutex
watcher *fsnotify.Watcher
)
func loadConfig(path string) error {
data, err := os.ReadFile(path)
if err != nil {
return err
}
return yaml.Unmarshal(data, &config)
}
func watchConfig(path string) {
var err error
watcher, err = fsnotify.NewWatcher()
if err != nil {
log.Fatal(err)
}
defer watcher.Close()
err = watcher.Add(path)
if err != nil {
log.Fatal(err)
}
for {
select {
case event, ok := <-watcher.Events:
if !ok {
return
}
if (event.Op&fsnotify.Write == fsnotify.Write || event.Op&fsnotify.Create == fsnotify.Create) &&
!isTempFile(event.Name) {
if err := reload(path); err != nil {
log.Printf("reload config failed: %v", err)
}
}
case err, ok := <-watcher.Errors:
if !ok {
return
}
log.Printf("watcher error: %v", err)
}
}
}
func reload(path string) error {
var newCfg Config
if err := loadConfig(path); err != nil {
return err
}
// validate before swap
if newCfg.Port <= 0 {
return fmt.Errorf("invalid port: %d", newCfg.Port)
}
configLock.Lock()
config = newCfg
configLock.Unlock()
return nil
}
func isTempFile(name string) bool {
return strings.HasSuffix(name, "~") ||
strings.HasSuffix(name, ".swp") ||
strings.HasPrefix(name, ".")
}
if err := reload(path); err != nil {
log.Printf("reload config failed: %v", err)
}
}
case err, ok := <-watcher.Errors:
if !ok {
return
}
log.Printf("watcher error: %v", err)
}
}
}
func reload(path string) error {
var newCfg Config
if err := loadConfig(path); err != nil {
return err
}
// validate before swap
if newCfg.Port <= 0 {
return fmt.Errorf("invalid port: %d", newCfg.Port)
}
configLock.Lock()
config = newCfg
configLock.Unlock()
return nil
}
func isTempFile(name string) bool {
return strings.HasSuffix(name, "~") ||
strings.HasSuffix(name, ".swp") ||
strings.HasPrefix(name, ".")
}环境变量配置无法热更新，必须配合外部信号或启动参数
Go 程序启动后，os.Getenv() 返回的是进程启动时快照，后续修改系统环境变量对运行中进程完全无效。若你依赖 CONFIG_ENV=prod 控制行为，热更新只能靠以下方式之一：
- 改用配置文件 +
fsnotify（推荐） - 接收
SIGHUP信号，由外部脚本kill -SIGHUP $PID触发重载逻辑 - 暴露 HTTP 管理端点（如
POST /admin/reload），用 token 鉴权后执行reload() - 用
github.com/mitchellh/go-homedir+os.UserHomeDir()动态查路径，但本质仍是文件驱动
注意：os.Setenv() 只影响当前进程后续调用，不能改变已初始化的组件（比如 GORM 的 gorm.Open() 已用旧 DB_URL 建连，不会自动切换）。
Docker 中挂载配置需避开常见陷阱
即使 Go 代码支持热重载，Docker 挂载方式不对也会导致监听失效或权限拒绝：
- Linux 主机上，用
bind mount（-v）而非named volume，因为fsnotify在 volume 内部无法可靠触发 inotify 事件 - 确保挂载路径有读权限，且容器内用户能访问该路径（例如用
--user 1001:1001时，宿主机文件 uid/gid 需匹配） - 不要挂载整个目录（如
/etc/myapp）再监听/etc/myapp/config.yaml，而应只挂载单个文件（-v $(pwd)/config.yaml:/app/config.yaml:ro），否则 inotify 可能因路径遍历失败静默丢事件 - Kubernetes 中，用
ConfigMap+subPath挂载单个键，避免整个 volume 被 kubelet 更新时触发多次无意义事件
真正容易被忽略的是：某些 CI/CD 流水线用 sed -i 替换配置值，这会创建新 inode，fsnotify 默认监听的是文件路径而非 inode，此时需要监听目录并过滤文件名，或改用 inotifywait --monitor --format '%w%f' -e modify,move 做兜底。
