package config import ( "fmt" "os" "path/filepath" "strings" "github.com/spf13/viper" ) const ( // EnvPrefix 环境变量统一前缀,如 GOSMS_MYSQL_DSN 覆盖 mysql.dsn。 EnvPrefix = "GOSMS" // EnvKeyFile 指定配置文件路径的环境变量(GOSMS_CONFIG)。 EnvKeyFile = EnvPrefix + "_CONFIG" // DefaultConfigFile 默认配置文件(相对工作目录)。 DefaultConfigFile = "configs/config.dev.yaml" ) // Load 从指定路径加载并校验配置。 // // 加载优先级:path 参数 > 环境变量 GOSMS_CONFIG > configs/config.dev.yaml。 // YAML 中的任意键均可被环境变量覆盖:键层级以 "_" 连接并加前缀 GOSMS_, // 示例:mysql.dsn -> GOSMS_MYSQL_DSN;redis.addrs(切片)以逗号分隔。 func Load(path string) (*Config, error) { return load(path, nil) } // LoadWithOverrides 在文件与环境变量之上应用键值覆盖(ETCD 热更新用)。 // overrides 的键为点分层级(如 "log.level"),值以字符串写入。 func LoadWithOverrides(path string, overrides map[string]string) (*Config, error) { return load(path, overrides) } // load 统一装配:文件 → 默认值 → 环境变量 → 显式覆盖。 func load(path string, overrides map[string]string) (*Config, error) { if path == "" { path = resolveDefaultPath() } v := viper.New() v.SetConfigFile(path) v.SetEnvPrefix(EnvPrefix) v.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) v.AutomaticEnv() setDefaults(v) if err := v.ReadInConfig(); err != nil { return nil, fmt.Errorf("读取配置文件 %q 失败: %w", path, err) } for k, val := range overrides { v.Set(k, val) // 显式覆盖优先级最高 } var cfg Config if err := v.Unmarshal(&cfg); err != nil { return nil, fmt.Errorf("解析配置文件 %q 失败: %w", path, err) } if err := cfg.Validate(); err != nil { return nil, fmt.Errorf("配置校验失败(%s): %w", path, err) } cfg.Source = path return &cfg, nil } // resolveDefaultPath 解析默认配置文件路径。 func resolveDefaultPath() string { if p := os.Getenv(EnvKeyFile); p != "" { return p } return filepath.Join(filepath.Clean(DefaultConfigFile)) } // setDefaults 为全部键设置默认值; // 同时保证仅通过环境变量覆盖的字段在 Unmarshal 时可见(viper 已知键限制)。 func setDefaults(v *viper.Viper) { // server v.SetDefault("server.name", "go-sms") v.SetDefault("server.http.addr", ":8080") v.SetDefault("server.http.read_timeout", "30s") v.SetDefault("server.http.write_timeout", "30s") v.SetDefault("server.cmpp.addr", ":7890") v.SetDefault("server.cmpp.max_connections_per_account", 50) v.SetDefault("server.cmpp.idle_timeout", "60s") v.SetDefault("server.cmpp.window_size", 32) // log v.SetDefault("log.level", "info") v.SetDefault("log.format", "json") v.SetDefault("log.output", []string{"stdout"}) v.SetDefault("log.file.path", "/var/log/go-sms/app.log") v.SetDefault("log.file.max_size_mb", 100) v.SetDefault("log.file.max_age_days", 30) v.SetDefault("log.file.max_backups", 10) v.SetDefault("log.file.compress", true) // mysql v.SetDefault("mysql.max_open_conns", 100) v.SetDefault("mysql.max_idle_conns", 20) v.SetDefault("mysql.conn_max_lifetime", "1h") v.SetDefault("mysql.slow_threshold_ms", 500) // redis v.SetDefault("redis.mode", "single") v.SetDefault("redis.db", 0) v.SetDefault("redis.pool_size", 100) // balance(Day54 R1:默认 mysql 行锁,灰度切 redis;env GOSMS_BALANCE_MODE 覆盖) v.SetDefault("balance.mode", "mysql") v.SetDefault("balance.reconcile_interval", "5m") // kafka v.SetDefault("kafka.group_id", "go-sms") v.SetDefault("kafka.max_retry", 3) // etcd v.SetDefault("etcd.dial_timeout", "5s") // clickhouse v.SetDefault("clickhouse.database", "default") v.SetDefault("clickhouse.username", "default") v.SetDefault("clickhouse.dial_timeout", "10s") // minio v.SetDefault("minio.use_ssl", false) // tracer(Day 9) v.SetDefault("tracer.enabled", true) v.SetDefault("tracer.otlp_endpoint", "127.0.0.1:4318") v.SetDefault("tracer.service_name", "go-sms-gateway") // rate_limit(Day 9) v.SetDefault("rate_limit.enabled", true) v.SetDefault("rate_limit.capacity", int64(1000)) v.SetDefault("rate_limit.rate_per_sec", int64(100)) v.SetDefault("rate_limit.key", "ip") // jwt(Day 22) v.SetDefault("jwt.secret", "dev-go-sms-secret") v.SetDefault("jwt.ttl", "2h") // hot_reload(Day 12) v.SetDefault("hot_reload.enabled", true) v.SetDefault("hot_reload.prefix", "/config/go-sms/") }