Iris v12+ 必须用 iris.Addr() 封装监听地址，如 app.Run(iris.Addr(":8080"))；配置字段名严格区分大小写且不校验合法性，YAML 不支持环境变量展开，未调用 Run() 或 Listen() 应用不会启动。
iris.Run() 传参必须用 iris.Addr() 包裹地址
直接写 app.Run(":8080") 会编译失败，Iris v12+ 要求监听地址必须显式封装为 iris.Addr 类型。这是类型安全设计，不是可选语法糖。
常见错误是照抄旧教程写法：app.Listen(":8080") 虽然仍能运行，但无法启用 TLS、超时控制等新特性；而漏掉 iris.Addr 则根本过不了编译。
-
app.Run(iris.Addr(":8080"))—— 最简启动，支持 Graceful Shutdown -
app.Run(iris.TLS("cert.pem", "key.pem"))—— 启用 HTTPS，但必须配合ConfigureHost()才生效（否则静默失败） -
app.Run(iris.Addr(":8080"), iris.WithConfiguration(iris.Configuration{DisableStartupLog: true}))—— 启动参数 + 全局配置合并传入
iris.Configuration 字段名严格区分大小写且不支持 snake_case
YAML 或代码中填的字段名，必须和 iris.Configuration 结构体定义里的一模一样，比如 FireMethodNotAllowed 写成 fire_method_not_allowed 或 firemethodnotallowed 都会被忽略——不会报错，但行为不符合预期（405 错误不返回）。
容易被忽略的点：Iris 不校验字段合法性，多写、少写、拼错全都不提示。调试时建议加一行日志确认是否生效：
cfg := iris.Configuration{FireMethodNotAllowed: true}
app.Logger().Infof("FireMethodNotAllowed is set to %v", cfg.FireMethodNotAllowed)
- 关键字段如
DisableStartupLog、TimeFormat、DisableInterruptHandler必须首字母大写 - 字段值类型要匹配：例如
TimeFormat是string，不能传int；DisableBodyConsumptionOnUnmarshal是bool，不能写"false" - 未设置的字段走 Iris 默认值，比如
TimeFormat默认是"2006-01-02 15:04:05"，改错格式会导致日志时间乱码
环境变量不能在 YAML 里自动展开，必须手动处理
如果你在 config.yml 里写了 Addr: ":${PORT}"，Iris 会原样加载字符串 ":${PORT}"，导致监听失败。YAML 解析器不执行 shell 变量替换。
正确做法只有两种：
- 绕过 YAML，直接用
os.Getenv("PORT")拼接：app.Run(iris.Addr(":" + os.Getenv("PORT"))) - 先用
gopkg.in/yaml.v3读文件到map[string]interface{}，再用os.ExpandEnv替换，最后反序列化为iris.Configuration
别把业务参数（如数据库地址、API 密钥）塞进同一个 YAML 文件里混用——iris.Configuration 只管框架级行为（日志、路由重定向、错误页），业务配置应单独管理。
不调用 Run() 或 Listen()，应用根本不会启动
写完 iris.New()、注册一堆路由、加好中间件，终端没日志、浏览器打不开——不是代码有 bug，是服务压根没跑起来。Iris 不会自动监听端口，它只返回一个未激活的 *iris.Application 实例。
常见静默失败场景：
-
go run main.go后进程立刻退出：说明没调Run()或Listen()，main 函数执行完就结束了 - 进程卡住但无响应：可能用了
iris.TLS()却没配ConfigureHost()，HTTPS 启动失败但没报错 - 写了
app.Get("/health", handler)却收不到请求：99% 是漏了启动调用
真正难排查的是：中间件里写了响应但没调 ctx.StopExecution()，后续逻辑继续执行并覆盖输出——这种问题不会报错，只会返回意外内容。
