Iris需手动注册各HTTP方法且不支持Resource自动映射；安装失败时应启用GO111MODULE=on、设置GOPROXY=https://goproxy.cn，并指定版本如@v14；路径参数用:id和ctx.Param("id")；嵌套路由须链式调用，调试可用app.GetRoutes()和LogDebug。
直接上手就能跑通，不需要额外封装或抽象层；但必须手动注册每个HTTP方法，Iris不提供Resource或Route这类自动映射API。
安装时遇到git clone失败怎么办
国内拉取github.com/kataras/iris大概率报fatal: early EOF或RPC failed。这不是你环境的问题，是GitHub直连被干扰的典型表现。
- 必须启用Go Modules：
GO111MODULE=on - 设置代理源：
GOPROXY=https://goproxy.io（Go 1.13+ 可用https://goproxy.cn更稳定） - 执行
go get -u github.com/kataras/iris@v14，注意带@v14明确版本，避免拉到不兼容的dev分支 - 如果仍失败，可临时改用
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"（仅限Git CLI方式）
app.Get和app.Post必须分开写，不能合并
Iris不支持类似app.Resource("/users", handler)的写法——这个调用根本不存在，强行封装会掩盖请求生命周期细节，调试时路由表里显示为UNKNOWN方法。
- 标准CRUD对应：列表用
app.Get("/users", listHandler)，创建用app.Post("/users", createHandler)，单条更新推荐app.Patch("/users/:id", updateHandler)，删除用app.Delete("/users/:id", deleteHandler) - 路径参数固定写成
:id，不是{id}或ctx.Param("id")，别错用ctx.URLParam("id") - 同一个路径上混用
Put和Patch不会报错，但语义冲突会让前端调用混乱，建议只选其一并保持团队约定
嵌套路由组必须链式调用，否则前缀丢失
比如要做API版本隔离，api := app.Party("/api/v1")之后，子路由必须继续用api.Party("/users")再调.Get，而不是回到app.Get("/users")。
- 错误写法：
users := api.Party("/users"); app.Get("/orders", handler)→ 实际注册的是GET /orders，不是/api/v1/users/orders - 正确写法：
users := api.Party("/users"); users.Get("/orders", handler)→ 注册为GET /api/v1/users/orders - 调试时可用
app.GetRoutes()打印所有路由，确认前缀是否完整；配合iris.Logger().SetLevel(iris.LogDebug)看启动日志里的路由树
查询参数、表单、JSON要分清读取方式
ctx.Param、ctx.URLParam、ctx.FormValue、ctx.ReadJSON四者职责分明，互不替代。
-
ctx.Param("id")只取路径段，如/users/:id中的123；ctx.URLParam("page")才取?page=2里的值 -
ctx.FormValue("name")只对application/x-www-form-urlencoded或multipart/form-data有效；JSON请求必须用ctx.ReadJSON(&v) - 批量ID如
?ids=1,2,3需手动strings.Split(ctx.URLParam("ids"), ",")，Iris不内置数组解析 - 若同时支持表单和JSON，得自己判断
ctx.ContentType()再分支处理，框架不自动适配
最容易被忽略的是OPTIONS预检响应——用app.Get/app.Post注册后，Iris会自动返回Allow: GET, POST头；但若误用app.Handle("GET", ...)，CORS跨域PUT请求会在浏览器里静默失败，且日志里找不到明显线索。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
