如何在 Go 应用中安全共享主函数初始化的运行时配置实例-Golang-PHP中文网

如何在 Go 应用中安全共享主函数初始化的运行时配置实例

通过单例模式封装运行时配置，避免全局变量，实现跨文件安全访问数据库连接等依赖实例。

通过单例模式封装运行时配置，避免全局变量，实现跨文件安全访问数据库连接等依赖实例。

在 Go 应用开发中，常需将 main() 中初始化的关键依赖（如已连接的数据库实例、服务名、日志器等）安全地传递给其他包中的工具函数或业务逻辑，但又不希望引入易出错的全局变量或破坏依赖显式性。此时，单例模式（Singleton Pattern） 是兼顾简洁性与可控性的推荐方案。

核心思路是：定义一个线程安全的、惰性初始化的单例访问器，确保 RuntimeConfig 实例仅被创建一次，且所有调用方通过统一接口获取同一实例。

以下是完整实现示例：

// config/runtime.go
package config

import "sync"

type RuntimeConfig struct {
    DB       *DatabaseInstance
    AppName  string
    // 其他字段...
}

var (
    instance *RuntimeConfig
    once     sync.Once
)

// GetRuntime 返回全局唯一的 RuntimeConfig 实例。
// 若尚未初始化，调用者需确保先调用 Init()。
func GetRuntime() *RuntimeConfig {
    if instance == nil {
        panic("RuntimeConfig not initialized. Call config.Init() in main() first.")
    }
    return instance
}

// Init 显式初始化单例实例（必须在 main() 中调用一次）。
// 参数应由 main() 中已构建好的依赖传入，保持依赖注入的清晰性。
func Init(db *DatabaseInstance, appName string) {
    once.Do(func() {
        instance = &RuntimeConfig{
            DB:      db,
            AppName: appName,
            // 其他字段赋值...
        }
    })
}

在 main.go 中初始化：

// main.go
func main() {
    dbInstance := ConnectToDB(/* ... */)
    config.Init(dbInstance, "My app") // ✅ 关键：显式初始化单例

    // 启动 HTTP 服务、定时任务等...
    http.ListenAndServe(":8080", nil)
}

在任意其他文件中使用（如 elsewhere.go）：

// elsewhere.go
package main

import "your-app/config"

func SomeUtilityFuncThatNeedsRuntime(i int) int {
    runtime := config.GetRuntime() // ✅ 安全获取已初始化的实例
    runtime.DB.Save(runtime.AppName, i) // 示例操作
    return i + 1
}

⚠️ 重要注意事项：