viper.readinconfig()找不到config.json的根本原因是viper默认按setconfigname指定的无扩展名文件名（如"config"）在addconfigpath路径下依次尝试config.json、config.yaml等，但若未显式调用addconfigpath或文件名不匹配就会失败；解决方法是重命名为app.json后配setconfigname("app")，或直接用setconfigfile("config.json")跳过自动搜索。
为什么直接用 viper.ReadInConfig() 找不到 config.json
常见现象是报错 Config File "app" Not Found in "[. ./configs]"，哪怕文件明明放在项目根目录或 configs/ 下。根本原因不是路径写错，而是 Viper 默认只认文件名不带扩展名 —— 它会按顺序尝试 app.json、app.yaml、app.toml 等，但不会自动匹配 config.json。
解决办法只有两个：
• 要么把文件重命名为 app.json（推荐），然后调用 viper.SetConfigName("app")
• 要么保留 config.json，改用 viper.SetConfigFile("config.json")，跳过自动探测逻辑
• 别混用：如果用了 SetConfigFile，就不要再调 AddConfigPath 或 SetConfigName，否则行为不可控
viper.Unmarshal() 解析 JSON 时字段全为空
典型表现：JSON 里有 "port": 8080，结构体字段也声明为 Port int `json:"port"`，但解析后值仍是 0。问题通常出在三处：
- 结构体字段未导出（首字母小写），比如
port int→ 必须写成Port int -
json:tag 拼写错误，比如写成josn:"port"或漏掉双引号 - JSON 值类型与 Go 字段类型不匹配，例如 JSON 中
"read_timeout": "5s"（字符串）却定义为ReadTimeout time.Duration—— 标准encoding/json不支持自动转 duration，得自己写自定义 UnmarshalJSON 方法或改用字符串字段
JSON 配置 vs YAML：选哪个更稳妥
如果你的配置项简单、不需注释、团队熟悉 JSON，用 JSON 没问题；但只要涉及嵌套结构或需要说明，YAML 明显更友好。关键差异不在功能，而在实际维护成本：
- JSON 不支持注释，上线前删注释容易漏项，协作时无法留说明
- JSON 对尾部逗号敏感，多一个
,就整个解析失败，而 YAML 宽容得多 - Viper 加载 JSON 时解析速度略快，但对启动耗时影响微乎其微（通常
- 若已有 JSON 配置且无协作压力，不必强行迁移；新项目建议直接上 YAML
如何让 Gin 启动时校验配置完整性
加载完配置后不做检查，等到真正用 viper.GetInt("server.port") 时才发现字段缺失，容易导致 panic 或静默降级。应在 viper.ReadInConfig() 后立刻做基础校验：
- 用
viper.IsSet("server.port")确保必填字段存在 - 对数值类字段加范围检查，比如
port := viper.GetInt("server.port"); if port 65535 { log.Fatal("invalid server.port") } - 数据库 DSN 字段建议用正则粗筛格式，避免启动后连不上才报错
- 别依赖
viper.Unmarshal()的返回值判断——它只报解析错误，不报字段缺失
最易被忽略的是环境变量覆盖逻辑：如果同时设置了 SERVER_PORT=9000 和配置文件里的 port: 8080，Viper 默认以环境变量为准，但你可能根本没意识到这个覆盖正在发生。
