query参数应使用r.url.query().get()，form参数需先调r.parseform()再查r.form或直接用r.postformvalue()；混用或跳过解析将导致参数读取失败。
直接说结论：Query 参数用 r.URL.Query().Get()，Form 参数用 r.PostFormValue() 或先调用 r.ParseForm() 再查 r.Form；混用或跳过解析步骤是绝大多数参数读不到的根源。
Query 参数必须用 r.URL.Query().Get()，别信 r.FormValue() 能自动兜底
r.FormValue("key") 看似方便，但它会合并 URL Query 和 POST Body 中同名字段，且 POST 值优先——这对 GET 接口是灾难性的。比如 /list?page=1，若某处误调了 r.ParseForm()（哪怕没 body），r.FormValue("page") 仍可能返回空字符串（因为 r.Form 初始化为空，未被填充）；而 r.URL.Query().Get("page") 永远直接、无副作用、无需前置调用。
-
r.URL.Query().Get("id")返回第一个值，?id=1&id=2时得"1" - 要取全部值，用
r.URL.Query()["id"]，它返回[]string，需判空再取 -
r.URL.Query()是惰性解析，首次调用才 parse，后续复用缓存，性能无顾虑 - 如果需要原始未解码字节（比如签名验签），得读
r.URL.RawQuery，不是.Query()
POST 表单必须显式调用 r.ParseForm()，否则 r.PostForm 为空
Go 的 *http.Request 不会自动解析请求体。r.PostFormValue("name") 内部会隐式调用 r.ParseForm()，但仅限于 application/x-www-form-urlencoded；一旦你手动调过 r.ParseForm()，再调 r.PostFormValue() 就只是查缓存，没问题。但如果你漏了这步，r.PostForm 就是 nil，r.PostFormValue() 返回空字符串，且不报错——这是最常踩的静默坑。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 普通文本表单（
Content-Type: application/x-www-form-urlencoded）：必须r.ParseForm()后才能安全访问r.Form或r.PostForm -
r.PostFormValue("key")语义明确（只读 POST body），比r.FormValue("key")更安全，后者会混入 URL 参数 - 若需遍历所有字段或处理多值（如复选框
hobby=reading&hobby=swimming），用r.Form["hobby"]，它返回[]string，记得判空 - 调用
r.ParseForm()后，r.Form和r.PostForm才有数据；之前访问它们都是空或 nil
JSON 请求和 Form 请求不能共用 r.ParseForm()
r.ParseForm() 会读取并消耗 r.Body；而 json.NewDecoder(r.Body).Decode() 也要读 r.Body。两者互斥：先 ParseForm() 再解 JSON，Decode() 必定失败，返回 EOF 或空对象。
- 区分 Content-Type：是
application/json就走 JSON 解析路径，是application/x-www-form-urlencoded才用ParseForm() - 不要在同一个 handler 里既调
r.ParseForm()又调json.Decode() - 若需兼容多种格式，应先检查
r.Header.Get("Content-Type")，再分支处理 - 文件上传必须用
r.ParseMultipartForm()，它内部会调ParseForm()，但额外处理二进制流
类型转换必须手动做，且不能忽略错误
Golang 不做任何隐式类型转换。r.URL.Query().Get("limit") 永远返回 string，哪怕它是数字。直接 strconv.Atoi() 忽略 error，会导致 ?limit= 或 ?limit=abc 时得到 0，和合法的 ?limit=0 无法区分。
- 先确认参数存在：
if v, ok := r.URL.Query()["limit"]; ok && len(v) > 0 && v[0] != "" - 再转类型：
limit, err := strconv.Atoi(v[0])，必须检查err != nil - Gin 的
c.Query("id")同理，也是 string，c.GetInt("id")才封装了转换逻辑，但底层仍是strconv+ error 检查 - 时间、布尔等类型同理，别依赖框架“自动”，自己控制解析边界
真正容易被忽略的是：Query 和 Form 的语义边界、解析时机、以及 Body 的一次性读取特性——它们不是语法糖，而是 Go HTTP 设计里明确暴露的控制权。写 handler 时，先看请求方法和 Content-Type，再决定走哪条解析路径，比堆砌 FormValue 调用更可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
