应使用 Viper 加载 TOML 配置文件，而非将业务配置塞入 iris.Configuration；需在 iris.New() 前完成 viper 初始化、路径/类型设置及 ReadInConfig() 调用并检查错误，确保结构体字段导出且 tag 匹配，文件编码为 UTF-8 无 BOM。
直接用 viper 加载 TOML，别碰 iris.Configuration
Iris 的 iris.Configuration 结构体只管 HTTP 服务器启动参数（比如 Timeout、DisableInterruptHandler），**不负责业务配置**。数据库地址、JWT 密钥、多语言路径这些必须外置——TOML 就是干这个的，但得靠 viper 或原生库加载，不是 Iris 自己解析。
常见错误是把 db.host = "127.0.0.1" 写进 TOML，然后试图塞进 iris.Configuration{} 里，结果字段被忽略，运行时 panic 或空值。
- 业务配置统一走
viper：初始化早于iris.New()，调viper.SetConfigType("toml")+viper.ReadInConfig() - 若拒绝引入
viper，可用github.com/pelletier/go-toml/v2直接toml.Unmarshal，但要自己处理文件读取、错误、重载逻辑 -
os.Getenv()适合简单场景（如PORT、ENV），但无法表达嵌套结构，TOML 的表（[database]）和数组表（[[servers]]）它压根不支持
viper 加载 TOML 的关键三步
不是加几行代码就行，顺序和细节错一个，viper.Get("xxx") 就返回空。
- 第一步：在
main()开头就初始化viper，**必须在iris.New()之前**，否则 handler 里拿不到值 - 第二步：指定路径和类型：
viper.SetConfigName("config")（对应config.toml）、viper.AddConfigPath("./conf")、viper.SetConfigType("toml") - 第三步：调
viper.ReadInConfig()，**必须检查 err**；常见失败原因：文件不存在、权限不足、TOML 语法错（比如漏了引号、用了中文冒号）
示例片段：
viper.SetConfigName("config")
viper.AddConfigPath("./conf")
viper.SetConfigType("toml")
if err := viper.ReadInConfig(); err != nil {
log.Fatal(err) // 别只 print，服务起不来要立刻暴露
}
TOML 结构和 Go 结构体字段怎么对上
字段名大小写、嵌套层级、数组表写法，三个地方一错，解析出来就是零值，还不报错。
- Go 结构体字段必须首字母大写（导出），否则
go-toml或viper（底层用它）直接跳过 - 字段名默认按大小写敏感匹配 TOML key，
Port对应port会失败；加toml:"port"tag 显式绑定 - TOML 的
[[databases]]是数组表，Go 必须用切片：Databases []Database `toml:"databases"`；写成Databases Database就会报cannot unmarshal TOML array into Go struct field - 未声明的 TOML 字段会被静默丢弃，调试时别以为数据丢了——先确认结构体字段是否都定义且导出
加载后怎么安全注入到 Iris handler
别在每个 handler 里反复调 viper.GetString("db.host")，既慢又难测。用依赖注入或闭包封装。
- 推荐方式：定义配置结构体（如
type Config struct { DB struct{ Host string } }），viper.Unmarshal(&cfg)一次解析，然后传给 handler 函数闭包 - 如果用中间件传递，用
ctx.Values().Set("config", cfg)，但注意生命周期——ctx是请求级的，别存大对象 - 环境变量优先级高于 TOML？加
viper.AutomaticEnv()，但记得调viper.SetEnvPrefix("APP")，否则DB_HOST不会映射到viper.Get("db.host") - 热重载不推荐：TOML 文件变更后 reload 需重建整个
iris.Application实例，线上基本不可行；配置变更走环境变量或配置中心更实际
最易被忽略的一点：TOML 文件编码必须是 UTF-8 无 BOM。带 BOM 的文件用 go-toml/v2 解析会直接报 invalid character 'ï' looking for beginning of value，而 viper 默认用的也是它——用编辑器另存为 UTF-8（无 BOM）格式，别跳过这步。
