iris.context.queryargs() 返回只读的 fasthttp.args，修改无效；应优先用 urlparam 或 formvalue 获取单值，遍历时用 visitall；formvalue 有隐式优先级，mvc 不自动绑定 query 到函数参数，需 readquery 显式解析。
iris.Context.QueryArgs() 返回的是只读结构体
在 Iris 中，ctx.QueryArgs() 返回一个 fasthttp.Args 类型对象，它底层是只读的字节切片视图。直接调用 .Set() 或修改其返回值不会生效，也不建议强行转为可写类型——这会破坏 fasthttp 的零拷贝设计，还可能引发 panic。
常见错误现象：代码里写了 ctx.QueryArgs().Set("key", "val")，但后续 ctx.URLParam("key") 或再次 QueryArgs().Get("key") 仍拿不到新值。
- 正确做法是：所有查询参数应在路由匹配前就已固定；若需“修改”参数，应构造新 URL 或改用
ctx.Request().URI().SetQueryString(...)（仅限重定向等场景） - 获取单个值优先用
ctx.URLParam("name")（路径参数）或ctx.FormValue("name")（兼容 query + post body），而不是先取QueryArgs()再.Get() - 需要遍历全部查询参数时，才用
ctx.QueryArgs().VisitAll(...)，注意回调函数中拿到的 key/value 是[]byte，别直接当 string 用（应转string(k)）
ctx.FormValue() 能同时读 query 和 form，但有隐式优先级
ctx.FormValue("id") 在 Iris MVC 中默认会按顺序检查：URL 查询参数 → POST 表单字段 → multipart 表单字段。这个行为看似方便，实则容易掩盖问题——比如前端误把 GET /api?status=active 发成 POST /api?status=active，后端却因表单里没填 status 而退回到 query 值，逻辑被悄悄绕过。
- 明确只读 query 时，坚持用
ctx.URLParam("id")（路径）或ctx.Request().URI().QueryArgs().Get("id")（query） - 若必须用
FormValue，记得在 controller 方法开头加日志：iris.Log().Infof("form value 'id': %s (from: %s)", ctx.FormValue("id"), ctx.Request().Method) - 注意：如果请求头
Content-Type不是application/x-www-form-urlencoded或multipart/form-data，FormValue会跳过解析 body，只查 query —— 这在调试时容易误判来源
MVC Controller 方法参数绑定 query 需显式声明
Iris 的 MVC 自动绑定只处理结构体字段标签（如 json:, form:），**不自动从 query string 绑定到函数参数**。你不能这样写：
func (c *MyController) Get(id int) { ... } // ❌ id 永远是 0
必须用 iris.Context 显式提取，或借助自定义绑定器：
- 最简方式：在 controller 方法里直接调
c.Ctx.URLParam("id")或c.Ctx.FormValue("id") - 想复用校验逻辑？定义结构体并用
c.Ctx.ReadQuery(&v)，例如：type SearchInput struct { Keyword string `url:"q"` Page int `url:"page,default(1)"` } var input SearchInput if err := c.Ctx.ReadQuery(&input); err != nil { c.Ctx.StatusCode(400) return } -
ReadQuery会忽略未标注url:标签的字段，且不支持嵌套结构体；默认值用default(...)，但仅对基本类型有效
测试 query 参数时要注意 URI 编码差异
本地用 curl 测试 curl "localhost:8080/search?q=hello+world"，Iris 解析出的 q 是 "hello world"（+ 被转为空格）；但若前端用 encodeURIComponent("hello world") 发送 q=hello%20world，结果一样。真正容易出错的是中文或特殊字符：
- 浏览器地址栏输入
?q=你好，实际发送的是%E4%BD%A0%E5%A5%BD，Iris 默认能正确解码 - 但如果手动拼接 URL 字符串（如
fmt.Sprintf("/search?q=%s", keyword)）而没调url.PathEscape或url.QueryEscape，会导致服务端收不到完整值 - 验证方法：在 controller 开头打印原始 query：
iris.Log().Infof("raw query: %s", string(c.Ctx.Request().URI().QueryString()))
query 参数不是黑盒，它的编码、传输、解析链条里任何一环断掉，都会让 Get 或 FormValue 返回空字符串——盯住原始字节，比猜逻辑更快定位问题。
