Postman是验证Gin接口最直接有效的工具，但常见问题多因配置遗漏：如POST JSON请求必须手动添加Content-Type: application/json头，否则c.ShouldBindJSON()返回400；文件上传必须用form-data而非raw或x-www-form-urlencoded，否则c.FormFile()报“http: no such file”；GET参数应通过Params标签填写以确保正确URL编码；请求地址须与r.Run()绑定的host:port完全一致。
Postman 是验证 Gin 接口最直接有效的工具，但很多问题不是 Gin 写错了，而是 Postman 配置漏了一两个关键项——比如 Content-Type 没设、c.ShouldBindJSON() 就会静默失败返回 400；又比如上传文件时没用 form-data 而用了 raw，c.FormFile("file") 直接报 http: no such file。
Postman 发 JSON POST 请求必须手动加 Content-Type
Gin 的 c.ShouldBindJSON() 不会自动识别请求体类型，它只认 Content-Type: application/json 这个 header。Postman 默认不带这个头，即使你选了 raw → JSON 也一样。
- 务必在
Headers标签页里手动添加：Key 填Content-Type，Value 填application/json - 如果漏了，Gin 会返回
400 Bad Request，且日志里通常只显示bind error，没有更具体的提示 - 不要依赖 Postman 的 “Auto-generate headers” 功能——它有时不生效，尤其在切换 body 类型后
文件上传必须用 form-data，不能用 raw 或 x-www-form-urlencoded
c.FormFile("file") 只能从 multipart/form-data 编码的请求中提取文件。Postman 里选错 body 类型是常见错误源头。
- 点
Body→ 选form-data（不是raw，也不是x-www-form-urlencoded） - Key 填字段名（如
file），Type 选File，然后点右侧Select Files上传本地文件 - 如果误用
raw发送二进制内容，c.FormFile()返回err != nil，错误信息是http: no such file，不是“文件为空”之类友好提示 - 多个文件上传时，多个
Key都设为file（同名），Gin 用c.FormFile("file")只取第一个；要用全部，得改用c.MultipartForm()手动遍历
GET 请求带查询参数时，别手输 URL 拼接，用 Params 标签
手写 http://localhost:8080/user?id=123&name=foo 容易 URL 编码出错（比如空格、中文、特殊符号），导致 Gin 的 c.Query("name") 拿不到值。
立即学习“go语言免费学习笔记（深入）”；
- 在 Postman 的
Params标签页里填 Key/Value，Postman 会自动做正确编码 - 例如填
name=张三 & 李四，它会生成?name=%E5%BC%A0%E4%B8%89+%26+%E6%9D%8E%E5%9B%9B - 对比：如果直接写在 URL 里，
&会被当成分隔符，后半截参数直接丢失 -
c.DefaultQuery("page", "1")这类带默认值的方法，在 Params 为空时才生效；手拼 URL 出错会导致参数根本没传过去，连默认值都用不上
真正容易被忽略的是：Gin 服务启动后，Postman 的请求地址必须和 r.Run() 绑定的地址完全一致——包括端口、路径前缀（如有）、是否带 https。本地调试时，http://localhost:8080 和 http://127.0.0.1:8080 在某些系统或代理下并不等价，建议统一用 localhost。
