Kratos配置加载必须显式传路径、先Load()再Scan()、结构体tag与YAML严格对齐；漏任一环节或顺序颠倒均panic，且file.NewSource()默认不热更新。
直接用 config.New() + file.NewSource() 就能读，但路径错、结构体没对齐、漏 Load() 或 Scan() 任一环节都会 panic。
配置文件路径怎么传才不报错
Kratos 默认不自动找 configs/config.yaml，必须显式传入路径。常见错误是相对路径写死在代码里，导致本地能跑、CI 或容器里找不到文件。
-
flagconf变量通常从命令行参数读取，比如-conf ./configs/config.yaml，推荐保留这个习惯 - 不要写
../../configs/config.yaml这类硬编码路径；改用filepath.Join(os.Getenv("PWD"), "configs", "config.yaml")或启动时统一注入 - 如果用
make run启动，确认Makefile中的go run命令带了-conf参数，否则默认值可能为空
结构体定义和 YAML 字段怎么对上
YAML 文件里的嵌套层级必须和 Go 结构体 tag 完全一致，大小写、下划线、缩进都影响 Scan() 成败。
- YAML 中
server:对应结构体字段Server struct{...} `yaml:"server"`，不是Server或server_addr - 数组、map 类型字段要显式声明，比如
Timeouts []string `yaml:"timeouts"`，不能留空或用interface{} - 如果用
internal/conf/bootstrap.proto生成配置结构体（推荐），记得每次改 proto 后执行make config，否则Scan()会因字段缺失失败
Load 和 Scan 的调用顺序不能颠倒
Load() 是把文件内容读进内存，Scan() 才真正解析成结构体。跳过 Load() 直接 Scan() 会导致空结构体，且无报错提示。
- 必须按顺序：先
c.Load()，再c.Scan(&bc)，中间不能有其他逻辑阻断 -
defer c.Close()要放在main()函数最开始，确保出错也能释放资源 - 检查
err：两个步骤都要判断 error，尤其Load()失败时，Scan()会 panic —— 错误信息类似panic: reflect: call of reflect.Value.Interface on zero Value
为什么 config.yaml 修改后服务没反应
默认的 file.NewSource() 不开启热更新，改了 YAML 文件必须重启进程。想自动生效得加 Watch 机制。
- 仅加
file.NewSource()不够，需额外调用c.Watch("server.addr", observer)并实现Observer.OnChange() - 更实用的做法是换用支持热更新的 Source，比如
k8s.NewSource()或etcd.NewSource()，本地开发可用fsnotify自封装 - 注意：热更新只触发
OnChange回调，不会自动重Scan()整个结构体，你要手动调用c.Scan()刷新目标变量
实际部署时，config.yaml 很少真放本地磁盘——K8s 下它该是 ConfigMap 挂载的文件，所以路径、权限、挂载点是否就绪，比语法对不对更容易卡住启动流程。
