go get github.com/kataras/iris/v12 失败或装错版本，因 Iris v12+ 强制要求模块路径，且受 GO111MODULE、GOPROXY 及代理缓存影响；本地调试需用 replace 替换并手动调用 app.Build()，否则 iris.Test() 报 “no routes found”。
直接用 go get 拉源码安装 Iris 并不可靠，尤其在 v12+ 版本后必须走模块路径；本地调试需绕过框架自动构建逻辑，否则 iris.Test() 会报 “no routes found”。
为什么 go get github.com/kataras/iris/v12 失败或装错版本
Go 模块解析会受 GO111MODULE 和 GOPROXY 影响，且 Iris 的 v12 要求显式指定模块路径。常见错误包括：
- 执行
go get github.com/kataras/iris（不带/v12）→ 拉到旧版 v11 或更早，与当前文档不兼容 - 未启用模块模式：
GO111MODULE=off时，go get会忽略go.mod，导致依赖混乱 - 代理返回缓存的旧 tag（如
v12.2.4），但你实际需要v12.2.5→ 应强制更新：go get github.com/kataras/iris/v12@v12.2.5
从 GitHub 下载源码包并本地引用的正确姿势
适用于想调试 Iris 内部实现（比如 Context 生命周期、路由匹配逻辑）或打 patch 的场景。不能直接 go build 源码目录，而要让项目识别为本地模块：
- 下载
iris-v12.2.5.zip（来自官方 release 页面），解压到$GOPATH/src/github.com/kataras/iris/v12 - 在你的项目根目录执行：
go mod edit -replace github.com/kataras/iris/v12=../path/to/iris/v12 - 运行
go mod tidy→ 此时go list -m github.com/kataras/iris/v12会显示replace状态 - 注意：替换路径必须是绝对路径或相对于当前项目的相对路径，不能是
~/开头
本地调试时 iris.Test() 报 no routes found 怎么办
根本原因是 app.Build() 未被调用，而 iris.Test() 依赖已注册的路由树。这不是 bug，是设计约束：
-
iris.Test(app, "GET", "/")前必须先调用app.Build()，否则路由未初始化 - 若你在测试中用
app.Get()注册路由，但没调app.Build()，iris.Test()就看不到任何 route - 不要在
TestMain里提前app.Build()—— 它会污染后续测试的容器状态；每个测试函数内单独调用更安全 - 验证方式：在测试开头加一行
fmt.Printf("routes: %d\n", len(app.GetRoutes()))，应输出 >0
调试 Context 和中间件生命周期的关键断点位置
想看请求怎么流经 iris.Logger()、自定义中间件、handler，最有效的办法不是打 log，而是设断点：
- 在
context.go的(*Context).Next()入口处下断点 → 观察中间件链执行顺序 - 在
router/router.go的lookup()方法里看参数解析和 handler 匹配过程 - 若 handler panic，堆栈常卡在
recovery.go的Recover()中间件里，而不是你写的代码行 —— 这说明 recovery 已生效，但你要去上层找真实 panic 点 - VS Code + Delve 调试时，在 launch.json 的
env加"GODEBUG": "gctrace=1"可辅助判断是否因 GC 导致 context 对象被提前回收
