iris服务启动失败因未调用run()/listen()；路径参数取不到值因大小写不匹配或误用urlparam()；中间件需调用ctx.stopexecution()阻止后续执行；模板报错因路径注册错误或函数未注册。
服务启动后浏览器打不开，终端没日志
这是Iris新手最常遇到的“静默失败”：写完路由、加完中间件，go run main.go后终端一闪而过或卡住不动，访问localhost:8080始终拒绝连接。
第一步：确认是否调用了 【Run() 或 Listen()】。Iris.New()只返回一个未激活的app实例，不调用启动方法，服务根本不会监听端口——这和Gin、Echo等框架行为不同，是Iris的硬性前提。
第二步：检查启动语句位置。必须在iris.New()之后、注册路由之前或之后（顺序不影响），但绝不能漏掉。常见错误是把app := iris.New()写在最前，然后直接写app.Get(...)，最后忘记加任何启动逻辑。
第三步：验证终端输出。正确启动会打印类似Now listening on http://localhost:8080的日志。若无此行，说明Run()/Listen()根本没执行到——可能是被if条件包裹、放在了return后面，或被recover捕获后吞掉了panic。
路径参数取不到值，ctx.Params().Get("id")返回空字符串
定义了app.Get("/user/{id:uint64}", handler)，但在handler里oid := ctx.Params().Get("id")得到的是空字符串，数据库查不到记录，也不报错。
方法一：核对参数名大小写和拼写。路由中写的是{id}，代码里就必须用Get("id")，写成Get("ID")或Get("Id")都会失败——Iris不自动做case转换，且不panic，只默默返回空串。
方法二：确认你没误用ctx.URLParam()。这个方法只读?query=string里的键值，比如/user/123?tab=profile中的tab，不是路径段{id}。混淆这两者会导致90%以上的初学者卡住半小时以上。
方法三：检查路由是否被其他更宽泛的路由提前匹配。比如在/user/{id}之前注册了/user/*wildcard，那么所有/user/开头的请求都会被后者吃掉，前者永远不会触发——把宽泛路由放到底部可避免。
中间件写了响应却仍执行业务Handler，导致数据重复写入或日志污染
JWT鉴权中间件里判断token无效，调了ctx.JSON(401, map[string]string{"error": "invalid token"})，但后续业务Handler还是被执行了，数据库里多了一条脏记录。
必须在写完响应后立即调用 【ctx.StopExecution()】。Iris的ctx.Next()不会自动检测是否已写响应，它只是按顺序执行下一个中间件或最终Handler，完全不管HTTP状态码或body是否已发送。
典型错误写法：先ctx.JSON(401, ...)，再ctx.StopExecution()，但后面又跟了一句ctx.Next()——这句ctx.Next()会被执行，因为StopExecution()只阻止“后续”，不撤销“已写”的事实；正确做法是用if-else结构，确保ctx.Next()只在合法分支里出现。
这一步操作起来很简单，直接把ctx.Next()挪到if authOK { ... }大括号内部就行，外面不要留裸露的ctx.Next()调用。
模板渲染报错：template not found 或 panic: template: ... is undefined
调用ctx.View("index.html")时崩溃，提示找不到文件，或者模板里引用的func未定义。
第一步：确认模板路径注册方式。必须用iris.Dir("./views")包裹路径，不能直接写"./views"。Iris会校验该目录是否存在、是否可读，且要求路径与实际文件系统结构严格一致——比如注册iris.Dir("./views")，那index.html就必须放在./views/index.html，而不是./templates/index.html。
第二步：检查模板函数是否已通过app.RegisterViewEngine注册。Iris默认只支持标准html/template语法，如果用了自定义函数如{{ dateFormat .Time }}，必须在app.New()后、Run()前调用app.RegisterViewEngine(iris.HTML(...))并传入FuncMap。
第三步：Windows用户注意路径分隔符。用iris.Dir("./views")比iris.Dir(".\views")更安全，后者在某些Go版本下可能因转义问题失效。
