panic源于对nil指针/接口的非法反射访问，如未检查v.isnil()就调interface()；viper.getstringmapstring等返回nil需判空；mapstructure.decode须传可寻址指针；unmarshalyaml方法须首行检查t==nil。
解析配置文件时 panic: runtime error: invalid memory address or nil pointer dereference，基本不是配置内容本身的问题，而是你用反射或结构体字段访问时，对 nil 指针、nil 接口或未导出字段做了非法提取。
config.Unmarshal 之后直接 FieldByName 访问嵌套指针字段
常见于 YAML/JSON 解析后结构体中含 *string、*int 或 *SubConfig 字段，但解析失败或字段缺失导致这些指针为 nil；后续用 reflect.Value.FieldByName 取到该字段的 reflect.Value 后，没检查就调 Interface() 或 String()。
-
v := reflect.ValueOf(cfg).FieldByName("Timeout")返回的是一个reflect.Value，若cfg.Timeout是nil *int，则v.Kind() == reflect.Ptr且v.IsNil() == true，此时v.Interface()会 panic - 正确做法是：先
v.IsValid() && !v.IsNil()（对指针、slice、map、chan、func 有效），再取值；对非指针字段，v.IsValid()足够 - 别依赖
v.CanInterface()——它不存在；要安全转回 interface{}，得写if v.IsValid() && (v.CanAddr() || v.Kind() != reflect.Ptr) { v.Interface() }
使用 viper.GetStringMapString 时未判空就遍历
viper 的 GetStringMapString 等方法在键不存在或类型不匹配时返回 nil map[string]string，而非空 map。直接 for k, v := range viper.GetStringMapString("features") 会 panic。
- 必须显式判空：
m := viper.GetStringMapString("features"); if m == nil { m = make(map[string]string) } - 同理，
GetStringSlice、GetBool等虽不 panic，但GetStringMap和GetStringMapString是高危区 - 更稳妥的做法是统一用
viper.Get("features").(map[string]interface{})，但需配合ok断言，且注意类型断言失败会 panic，建议用cast.ToStringMapString（来自github.com/mitchellh/mapstructure）
mapstructure.Decode 传入 nil 指针或未寻址结构体
mapstructure.Decode 要求目标参数是可寻址的指针，否则内部反射调用 reflect.Value.Elem() 会失败，最终表现为 “invalid memory address” —— 实际是 reflect.Value 不可解包，不是业务数据为空。
- 错误写法：
var cfg Config; mapstructure.Decode(raw, cfg)→cfg是值类型，不可寻址，Decode内部v.Elem()panic - 正确写法：
var cfg Config; mapstructure.Decode(raw, &cfg)，或cfg := new(Config); mapstructure.Decode(raw, cfg) - 如果 raw 是
nilinterface{} 或空 map，Decode不 panic，但字段保持零值；真正危险的是传了不可寻址的目标
自定义 UnmarshalYAML 方法里忘记处理 nil 接收者
给结构体实现 UnmarshalYAML 时，如果方法接收者是 *T，但调用方传的是 nil 指针（比如 var t *MyConf; yaml.Unmarshal(data, t)），方法体内第一行解引用就会崩。
- 必须在方法开头加
if t == nil { return nil }，这是唯一安全的守门方式 - 不要试图在方法内
*t = MyConf{...}，因为t是nil，解引用即 panic - 如果希望支持
nil接收者初始化，应改为func (t **MyConf) UnmarshalYAML(...) {...}并在内部做*t = &MyConf{...}，但语义变重，慎用
最常被忽略的点：空指针 panic 往往不发生在配置读取那一刻，而是在后续某次反射取值、或某个字段被首次访问时才暴露——所以日志里看不到配置解析失败，只看到“某行代码突然崩了”。查问题得顺着 panic 栈往回找，看那个 reflect.Value 是从哪来的，它对应的原始字段是不是指针类型，以及上游有没有做 nil 防御。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
