SIGUSR1更适合配置热加载，因SIGUSR2在systemd等环境中被约定为平滑重启信号，易引发运维冲突；而SIGUSR1是POSIX标准自定义信号，macOS兼容性好，且仅触发配置重载不中断连接。
为什么 SIGUSR1 比 SIGUSR2 更适合配置热加载
因为 SIGUSR2 在多数生产环境（尤其是 systemd 管理的进程）中已被约定为“平滑重启”信号，若用它做配置重载，容易和运维脚本、supervisord 或 k8s liveness probe 的 reload 逻辑冲突。SIGUSR1 才是 POSIX 标准里明确留给用户自定义用途的信号，且 macOS 也支持（不像 SIGUSR2 在 macOS 上会报 operation not permitted）。
常见错误是直接复用重启信号逻辑：监听 SIGUSR2 后调 srv.Shutdown()，结果配置没变，服务却闪退。热加载不需要关 listener，更不该碰连接生命周期——它只该触发 loadConfig() 和内部状态刷新。
- 必须在程序启动早期注册，比如
main()开头就signal.Notify(sigChan, syscall.SIGUSR1) - 避免在 handler 里做阻塞操作：不要同步读文件、不要直连数据库、不要调未设 timeout 的
http.Client.Do - 推荐用原子值或
sync.RWMutex保护配置变量，确保多 goroutine 并发读写安全
如何让 config reload 不影响正在处理的 HTTP 请求
关键不是“停服务”，而是“不中断运行中的 handler”。Go 的 http.ServeMux 和中间件本身不感知配置变更，所以 reload 必须是无侵入的：新配置仅影响后续请求的路由判断、日志级别、限流阈值等，已进入 handler.ServeHTTP 的请求仍用旧配置执行到底。
典型踩坑是把配置存在全局指针里，reload 时直接替换指针，但某些 handler 正在用旧配置做鉴权或构造响应，导致 panic 或逻辑错乱。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
atomic.Value存 config 结构体，Store()和Load()都是原子操作 - 所有 handler 内部通过
cfg := config.Load().(*Config)获取当前快照，而非引用全局变量 - 如果配置含函数字段（如自定义验证器），确保它们是纯函数、无闭包捕获、不依赖外部状态
reload 失败时怎么防止配置半生效
失败场景很常见：配置文件语法错误、远程配置中心超时、TLS 证书路径不存在……一旦 loadConfig() 返回 error，就不能覆盖旧配置，否则服务可能直接瘫痪。必须保证“要么全量生效，要么维持原状”。
很多人忽略校验环节，直接 json.Unmarshal 后就 config.Store()，结果新配置里某个 TimeoutSec int 是负数，下游 http.Client 初始化 panic。
- reload 流程必须包含：解析 → 校验（如
Validate() error方法）→ 原子替换 - 校验失败时，记录 error 日志，但不修改
atomic.Value，也不返回 error 给 signal handler（避免 channel 堵塞） - 加个简单健康检查端点，比如
/health?verbose=1，返回当前配置哈希和最后成功 reload 时间戳，方便排查
为什么 reload 日志里总看到 “config unchanged” 却还是触发了
因为信号本身无法携带 payload，SIGUSR1 就是一个“请检查”的通知，不是“请加载这个内容”。程序每次收到信号都得重新读磁盘或拉远端，哪怕文件没变，也会走一遍解析和比较流程。
容易被忽略的是文件 mtime 检查逻辑：如果用 os.Stat() 对比时间戳，NFS 或容器挂载卷可能导致精度丢失，误判为变更；而全量 MD5 对比又太重。折中做法是只对关键字段（如 LogLevel, RateLimit）做浅层 diff。
- 建议加一层缓存：用
sync.Once初始化一个lastHash [32]byte，每次 reload 前先算新文件 SHA256，相同则跳过后续步骤 - 别依赖
syscall.Stat()的ModTime做唯一判断，尤其在 CI/CD 自动推送配置的场景下，mtime 可能被覆盖 - 日志里打印
config hash changed: old=xxx new=yyy而非笼统的 “reloaded”，便于审计回溯
