必须显式用 os.getenv 读取环境变量并手动赋值，iris 不自动注入；端口、地址、tls、路径、敏感配置等均需代码中解析+校验，避免硬编码和静默 fallback。
用 os.Getenv 读取环境变量，别依赖 iris.Configurator
Iris 没有内置“环境变量自动注入配置”机制，iris.Configuration 结构体字段不会被环境变量自动填充。所有覆盖行为必须由你显式调用 os.Getenv 完成。常见错误是以为设置 IRIS_PORT=8081 就能让 app.Run(iris.Addr(":8080")) 自动变，实际完全无效——端口还是写死的 ":8080"。
实操建议：
- 把所有可变配置项（如端口、日志等级、DB 地址）抽成变量，在
main()开头统一读取：port := os.Getenv("PORT")，没值则 fallback：if port == "" { port = "8080" } - 避免用模糊键名：
"ENV"或"MODE"容易拼错或语义不清；推荐明确命名，如"APP_PORT"、"LOG_LEVEL"、"DB_DSN" - 不要在
iris.Configuration{}字面量里直接写os.Getenv调用——Go 不允许在 struct 字面量中执行函数调用（编译报错）
覆盖 Listen 地址和 TLS 配置要改 Run 参数
iris.Addr 和 iris.TLS 是函数调用，不是配置字段，必须用环境变量值构造新参数传给 app.Run()。硬编码 iris.Addr(":8080") 再怎么设 PORT 环境变量都无效。
实操建议：
- 监听地址：用
os.Getenv("APP_ADDR")，默认":8080"，然后app.Run(iris.Addr(addr)) - TLS 证书路径：分别读
os.Getenv("TLS_CERT_FILE")和os.Getenv("TLS_KEY_FILE")，两者都非空才启用iris.TLS(cert, key) - AutoTLS 域名和邮箱也应来自环境变量：
iris.AutoTLS(os.Getenv("TLS_HOST"), os.Getenv("TLS_EMAIL"))
模板路径、静态资源路径必须绝对化 + 环境变量驱动
本地开发时写 "./views" 能跑，部署到 /opt/myapp 后就 404——Iris 不会根据环境变量自动补全路径前缀。相对路径在不同工作目录下行为不一致，这是生产环境最常踩的坑之一。
实操建议：
- 定义根目录变量：
rootDir := os.Getenv("APP_ROOT")，没值则 fallback 到当前目录：if rootDir == "" { rootDir, _ = os.Getwd() } - 模板注册：
app.RegisterView(iris.HTML(filepath.Join(rootDir, "views"), ".html")) - 静态文件：
app.HandleDir("/assets", iris.Dir(filepath.Join(rootDir, "assets"))) - 确保 systemd 或 Docker 启动时设置了
APP_ROOT=/opt/myapp，否则 fallback 到Getwd()可能仍是构建目录，不是运行目录
敏感配置走 os.Getenv + secrets 注入，绝不硬编码 fallback
数据库密码、API 密钥等不能写默认值，比如 os.Getenv("DB_PASSWORD") 如果为空，不能 fallback 成 "password123"——这会让测试环境误用弱密钥，且掩盖配置缺失问题。
实操建议：
- 对关键敏感字段做显式校验：
if dbPass == "" { log.Fatal("DB_PASSWORD is required") } - 在 CI/CD 或 Wrangler 部署时，用
secrets注入（Cloudflare Workers）或envFrom: secretRef（K8s），而非env:明文写入 - 本地开发用
.env文件配合godotenv.Load()加载，但上线前必须删掉该依赖，只保留原生os.Getenv——避免多一层抽象引入兼容性风险
environment 字段、systemd 的 Environment=、K8s 的 envFrom，到代码里每一处 os.Getenv 的 fallback 逻辑和 panic 条件，漏掉任意一环都会导致配置不生效或静默降级。
