使用 sync.Once 实现单例懒加载，结合 sync.RWMutex 支持热更新，确保配置只加载一次且并发安全，适用于高并发场景下的配置管理。
在 Golang 开发中，配置加载是每个服务启动的基础环节。为了保证程序性能和一致性，我们需要确保配置只被加载一次，并且在整个应用生命周期中可安全访问——尤其是在并发场景下。这就引出了两个关键问题：如何实现单例模式？如何做到懒加载且线程安全？本文将带你一步步实现一个并发安全的配置加载器，结合 Golang 的单例与懒加载实战技巧。
使用 sync.Once 实现线程安全的单例加载
Go 标准库中的 sync.Once 是实现“只执行一次”逻辑的理想工具，非常适合用于单例初始化。它能保证即使在高并发环境下，初始化函数也仅运行一次。
我们定义一个全局的配置结构体，并用 sync.Once 控制其加载过程：
var once sync.Once
var configInstance *Config
type Config struct {
DatabaseURL string `json:"database_url"`
LogLevel string `json:"log_level"`
Port int `json:"port"`
}
func GetConfig() *Config {
once.Do(func() {
configInstance = loadConfig()
})
return configInstance
}
上面代码中，GetConfig() 是对外暴露的唯一入口。无论多少个 goroutine 同时调用，loadConfig() 都只会执行一次，其余调用会阻塞直到首次加载完成。
立即学习“go语言免费学习笔记（深入）”；
结合懒加载提升启动效率
懒加载意味着配置不会在程序启动时立即读取，而是在第一次被请求时才加载。这种方式可以加快服务启动速度，尤其适用于配置来源较慢（如远程 HTTP 或数据库）的场景。
我们的 GetConfig() 函数天然支持懒加载：只有当业务代码首次调用它时，才会触发 loadConfig() 执行。
下面是一个从 JSON 文件加载配置的示例：
func loadConfig() *Config {
file, err := os.Open("config.json")
if err != nil {
panic(fmt.Sprintf("无法打开配置文件: %v", err))
}
defer file.Close()
decoder := json.NewDecoder(file)
var cfg Config
if err := decoder.Decode(&cfg); err != nil {
panic(fmt.Sprintf("配置解析失败: %v", err))
}
return &cfg
}
这个函数可以在任何需要的地方调用，但由于被包裹在 once.Do 中，实际只会运行一次。
扩展支持热更新与并发读取
虽然单例 + 懒加载解决了初始化问题，但某些场景下你可能希望配置支持动态刷新（比如监听文件变化或拉取远程配置）。此时我们可以引入读写锁 sync.RWMutex 来保护配置实例的读写操作。
var configMu sync.RWMutex
func ReloadConfig() {
newCfg := loadConfig() // 重新加载
configMu.Lock()
configInstance = newCfg
configMu.Unlock()
}
func GetConfig() *Config {
configMu.RLock()
if configInstance != nil {
defer configMu.RUnlock()
return configInstance
}
configMu.RUnlock()
once.Do(func() {
cfg := loadConfig()
configMu.Lock()
configInstance = cfg
configMu.Unlock()
})
configMu.RLock()
defer configMu.RUnlock()
return configInstance
}
这样设计后，读操作使用读锁，性能高；写操作（如重载）使用写锁，确保原子性。多个 goroutine 可以同时读取配置，只有在重载时才会短暂阻塞读取。
基本上就这些。通过 sync.Once 实现单例懒加载，再辅以 sync.RWMutex 支持后续更新，你就拥有了一个高效、并发安全的配置管理模块。这种模式在微服务、中间件开发中非常实用，建议封装成独立包复用。
