根本原因是Gin仅识别重复key形式（如?ids=1&ids=2）的URL数组，不解析JSON数组或逗号分隔字符串；QueryArray只读query、PostFormArray只读表单body、ShouldBindJSON只读JSON body，来源严格分离，混用导致丢数据。
为什么 c.QueryArray 和 c.GetArray 经常拿不到数据？
根本原因不是函数写错了，而是 HTTP 请求里数组参数的编码方式和 Gin 的解析逻辑不匹配。Gin 默认只把形如 ids=1&ids=2&ids=3 这种重复 key 的形式识别为数组；如果前端发的是 JSON 数组（比如 {"ids":[1,2,3]}）或序列化字符串（比如 ids=[1,2,3]），c.QueryArray("ids") 会返回空切片。
常见错误现象：c.QueryArray("ids") 始终返回 []string{}，即使 URL 明确写了 ?ids=1&ids=2 —— 检查是否漏了 BindQuery 或用了 POST body 却调用 Query 方法。
- GET 请求必须用重复 key：
/api?tag=a&tag=b&tag=c→c.QueryArray("tag")才有效 - POST 表单同理：表单字段名重复，且 Content-Type 是
application/x-www-form-urlencoded - JSON 请求必须走
c.ShouldBindJSON，不能用QueryArray
如何正确接收 URL 查询中的数组参数？
用 c.QueryArray 最稳妥，但前提是前端按规范拼接 URL。不要依赖逗号分隔（如 ?ids=1,2,3），Gin 不自动拆解。
示例请求：GET /search?category=book&category=movie&category=game
立即学习“go语言免费学习笔记（深入）”；
categories := c.QueryArray("category")
// categories == []string{"book", "movie", "game"}
- 若需转为 int 类型数组，得手动遍历
strconv.Atoi，Gin 不做类型转换 - 注意空值：当 URL 中只有
?category=时，QueryArray返回[]string{""}，不是 nil - 如果前端用 axios 或 fetch 发送 GET 请求，确保 URL 参数是扁平化重复键，而不是嵌套对象
POST 请求中怎么收 JSON 数组？
别碰 QueryArray，直接绑定结构体。Gin 的 c.ShouldBindJSON 能自然处理 JSON 数组字段。
假设请求体是：{"ids":[101,102,103],"names":["a","b"]}
type SearchReq struct {
IDs []int64 `json:"ids"`
Names []string `json:"names"`
}
var req SearchReq
if err := c.ShouldBindJSON(&req); err != nil {
c.JSON(400, gin.H{"error": err.Error()})
return
}
// req.IDs == []int64{101, 102, 103}
- 字段标签
json:"ids"必须和 JSON key 完全一致（包括大小写） - 如果 JSON 字段可能缺失，加
omitempty；如果必须存在，用自定义校验或binding:"required" - Content-Type 必须是
application/json，否则ShouldBindJSON会静默失败
表单提交（x-www-form-urlencoded）里的数组怎么处理？
和 GET 查询一样，靠字段名重复。但要注意：浏览器原生表单无法直接提交数组，得靠 JS 动态生成多个同名 <input>，或者后端用 c.PostFormArray。
HTML 示例：<input name="file_id" value="1"><br><input name="file_id" value="2"><br><input name="file_id" value="3">
fileIDs := c.PostFormArray("file_id")
// fileIDs == []string{"1", "2", "3"}
-
PostFormArray只读 body，不读 URL query；QueryArray只读 URL query，不读 body - 如果同时在 query 和 body 里传同名字段，Gin 不合并，得分别取
- 值始终是 string，数字要自己转，别指望框架自动类型推导
