gin.Default() 不可用于生产环境，因其默认启用debug模式、日志与panic恢复中间件，暴露敏感信息且信任所有代理；router.Run() 默认监听0.0.0.0:8080，需按部署环境显式指定地址；应优先使用c.ShouldBindJSON()并校验err，结构体字段须带json tag，Param与Query不可混用。
gin.Default() 是最常用的启动方式，但它默认开启 debug 模式、自动注入日志和 panic 恢复中间件——这对开发友好，但上线前必须改。
为什么 gin.Default() 不能直接上生产
它等价于 gin.New().Use(gin.Logger(), gin.Recovery())，会暴露敏感路径、响应时间、堆栈（如果 panic），且默认信任所有代理，存在安全风险。控制台警告里那句 "You trusted all proxies, this is NOT safe" 不是摆设。
router.Run() 的端口行为容易被忽略
不传参数时，默认监听 :8080（即 0.0.0.0:8080），但如果你在容器或云环境部署，可能需要显式绑定 127.0.0.1:8080 或指定 IPv4/IPv6 地址。常见踩坑点：
- 本地测试用
router.Run(":3000")没问题，但 Docker 中没加-p 3000:3000就访问不到 - 使用
router.Run("localhost:8080")会导致外部请求无法连入（只绑本地回环） - 想监听 IPv6？得写
router.Run("[::1]:8080")，不是::1:8080
c.ShouldBindJSON() 和 c.Bind() 的关键区别
前者只处理 Content-Type: application/json 请求，并在失败时返回错误；后者会根据请求头自动选择绑定器（JSON / XML / form），但若头缺失或不匹配，会静默失败或 panic。真实项目中更推荐：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 明确接口类型时用
c.ShouldBindJSON()，配合if err != nil做校验 - 不要依赖
c.Bind()自动推断，尤其当前端可能发错Content-Type时 - 结构体字段必须带
json:tag，否则绑定永远是零值
路由参数和查询参数别混用
c.Param("id") 只能取 /user/:id 这类路径里的动态段；c.Query("page") 才取 ?page=1 这种查询字符串。新手常犯的错：
立即学习“go语言免费学习笔记（深入）”；
- 写了
router.GET("/user?id=:id", handler)，以为能用c.Param("id")拿到 —— 实际上这是个固定路径，:id不会被识别为参数 - 用
c.GetQuery("id")去取 POST body 里的 JSON 字段 —— 完全无效 - 没区分
c.DefaultQuery("limit", "10")和c.Query("limit")：前者无参时返回默认值，后者无参时返回空字符串
Param 调用背后是 Radix 树匹配，一次 ShouldBindJSON 隐含了 MIME 类型校验和反射解析。真正卡住人的，从来不是“怎么写”，而是“为什么这里没拿到值”“为什么日志里突然多了一堆调试信息”。 
