Iris 必须显式调用 Run() 或 Listen() 才启动服务，否则路由注册无效；路径参数需用 ctx.Params().Get() 获取；中间件响应后必须调用 ctx.StopExecution() 阻止后续执行；模板路径须用 iris.Dir() 包裹且与实际结构一致。
iris.New() 后不调用 Run() 或 Listen()，服务根本不会启动
写完 iris.New() 就直接注册路由、加中间件，结果 go run main.go 之后终端静默退出或进程卡住但浏览器 8080 无响应——这不是 bug，是没启动 HTTP server。Iris 不会自动监听端口，它只返回一个未激活的 app 实例。
常见错误现象：app.Get("/health", ...) 写得再全，没 Run() 就等于没写；终端看不到 Now listening on http://localhost:8080 日志，说明服务压根没跑起来。
-
Run(iris.Addr(":8080"))是 v12+ 推荐方式，支持传入iris.Configuration控制超时、TLS、Graceful Shutdown 等 - 旧版惯用的
Listen(":8080")仍可用，但不支持 TLS 配置（需配合ConfigureHost()） - 如果用了
iris.TLS("cert.pem", "key.pem")却没调ConfigureHost()，HTTPS 会静默失败
路径参数必须用 ctx.Params().Get()，不是 ctx.URLParam()
ctx.URLParam("id") 只读 query string（比如 /user?id=123），而 RESTful 路由里的 /user/{id:uint64} 中的 id 是路径参数，必须走 ctx.Params()。新手常在这儿取空字符串，还查半天 token 或数据库逻辑。
使用场景：定义 app.Get("/order/{oid:string}", handler) 后，在 handler 里要拿到 URL 中的 oid 值。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
oid := ctx.Params().Get("oid")或带类型校验的ctx.Params().GetString("oid") - 拼错参数名（如路由写
{orderID}却用Get("oid")）会返回空字符串，不 panic —— 容易漏掉非空判断 - 若需强制类型转换且失败时返回 error，用
ctx.Params().GetInt64("id")等方法，比手动strconv.ParseInt更安全
中间件里写完响应必须调 ctx.StopExecution()，否则 ctx.Next() 仍会执行
Iris 的 ctx.Next() 不像 Gin 的 Abort()，它不检查是否已写响应，也不自动中断后续逻辑。鉴权中间件里 ctx.JSON(401, ...) 后忘了 ctx.StopExecution()，业务 handler 还是会被调用，可能造成数据误删或日志污染。
典型踩坑点：JWT 解析失败后返回 401，但末尾仍写了 ctx.Next()，导致后续中间件和 handler 继续执行。
- 正确模式：验证失败 →
ctx.StatusCode(401)+ctx.JSON(...)+ctx.StopExecution()，且确保ctx.Next()在 if 分支外不被执行 -
ctx.StopExecution()仅阻止当前请求链后续中间件和 handler，不影响其他并发请求 - 不要依赖 “写完响应就自动终止”，Iris 显式要求你控制执行流
模板路径注册必须匹配文件结构，且用 iris.Dir() 包裹
用 app.RegisterView(iris.HTML("./views", ".html")) 却提示 template not found？问题往往出在路径没对齐或没用 iris.Dir()。Iris 的视图系统不接受相对路径字符串，必须显式包装为 iris.Dir 类型。
常见错误：把模板放在 ./templates/user/index.html，却注册成 iris.HTML("templates", ".html")，而实际目录结构是 ./views/user/index.html。
- 正确注册：
app.RegisterView(iris.HTML(iris.Dir("./views"), ".html")) - 模板中引用子模板时，路径是相对于
iris.Dir()指定的根目录，比如{{template "header.html" .}}表示./views/header.html - 若用嵌入资源（
go:embed），需配合iris.EmbedFS()，不能混用iris.Dir()
真正容易被忽略的是中间件执行流的“显式终止”要求——Iris 把控制权完全交给你，不替你做假设。少一个 StopExecution()，就可能让未授权请求穿透到业务层；路径参数取错一次，整个 API 就返回空数据却无报错。这些都不是框架缺陷，而是设计选择，得按它的规则来。
