Files

135 lines
4.4 KiB
Go

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/")
}