gin是基于httprouter的高性能go web框架，提供路由分组、中间件、参数绑定与json渲染等能力，兼容net/http生态，适合构建restful api、bff及微服务网关。
直接用 net/http 能跑通，但真要上线、加版本、加权限、加监控，不换路由器（gorilla/mux 或 chi）迟早翻车。
gorilla/mux 路由注册顺序必须严格按 specificity 排
路径匹配不是“最长前缀”，而是按注册顺序逐条比对。一旦写错顺序，/users/{id} 会吃掉所有更具体的路由，比如 /users/me 或 /users/count 永远收不到请求。
-
/users/{id}必须放在/users/me、/users/latest等静态路径之后 - 正则约束强烈建议加上：
/users/{id:[0-9]+}，否则{id}会匹配/users/123/xxx这类越界路径 - 子路由用
.Subrouter()隔离，别把/orders和/users注册在同一个 router 实例下——Prometheus 标签、OpenAPI 分组、中间件作用域都会混乱
c.ShouldBindJSON() 必须配强类型结构体，不能用 map[string]interface{}
用 map[string]interface{} 接参，等于主动放弃字段校验、IDE 补全、Swagger 自动生成、甚至字段零值覆盖风险——前端传 {"name": ""}，后端结构体字段没设指针或 omitempty，DB 原值就被清空。
- 结构体字段必须首字母大写 +
json:"name"标签，漏掉就解码为空字符串或零值 - 必填字段加
binding:"required"，邮箱加binding:"email"，c.ShouldBindJSON()会自动返回422 Unprocessable Entity - 禁止在 handler 里手动调用
json.Unmarshal()，否则绕过 Gin 的错误拦截，400 不进日志、不触发统一错误中间件
HTTP 状态码不能只靠 200 和 500
前端靠状态码做重试、缓存、路由跳转。返回全用 200 + {"code": 404}，fetch().then() 永远不会进 catch，错误流控彻底失效。
- 资源不存在必须用
http.StatusNotFound（404），不是200+ null - 创建成功必须用
http.StatusCreated（201），并设Locationheader：c.Header("Location", "/users/"+id) - 业务校验失败（如手机号格式错）优先用
http.StatusUnprocessableEntity（422），比400更语义化 - 数据库连接失败应返回
http.StatusServiceUnavailable（503），500只留给未捕获 panic
路径参数提取后必须校验，不能直接当数字用
c.Param("id") 返回的是字符串，不做转换和校验就传给 DB 查询，轻则查不到，重则 SQL 注入（尤其拼接 raw query 时）或 panic（strconv.Atoi 遇到非数字崩溃）。
- 用
strconv.ParseUint(c.Param("id"), 10, 64)转换，并检查 error - 若 ID 是 UUID，用
uuid.Parse()，别用正则粗筛 - PUT / PATCH 更新时，结构体字段要用指针（
*string）+omitempty，否则未提供的字段会被零值覆盖原数据
真正难的不是写完接口，是让每个 c.Param、每个 ShouldBindJSON、每个 http.Error 都保持语义一致——这需要从第一个 handler 就定下规则，而不是等线上报出 404 当 200 处理才去补。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
