企业级gin项目需具备跨域（动态origin+credentials支持）、结构化日志（耗时/ip/状态码/recovery后置）、参数校验（binding tag统一处理）、全局异常捕获及jwt鉴权（路由分组+错误分类返回）五大核心能力，缺一不可。
企业级 Gin 项目不是把 gin.Default() 跑起来就完事了——它必须能扛住线上流量、快速定位问题、拒绝非法参数、拦住未授权访问，同时让新同学接手不懵。这些能力靠零散写法堆不出来，得靠稳定、可复用的功能封装。
跨域中间件必须支持 Credentials 且不硬编码 Origin
前端带 Cookie 请求时，Access-Control-Allow-Origin: "*" 会直接被浏览器拒绝。很多封装直接写死域名或用通配符，上线后登录态失效。
- 必须判断请求来源是否可信，再动态设置
Access-Control-Allow-Origin，不能无脑写"*" -
Access-Control-Allow-Credentials设为"true"时，Origin 不能是通配符，否则浏览器报错：Response to preflight request doesn't pass access control check: The value of the 'Access-Control-Allow-Origin' header in the response must not be the wildcard '*' - 预检请求（OPTIONS）必须用
c.AbortWithStatus(200)终止，不能走后续 handler，否则可能触发重复日志或鉴权逻辑
日志中间件要带耗时、IP、路径和状态码，且避免 panic 时日志丢失
默认 gin.Logger() 只输出基础信息，线上排查慢接口或异常来源时根本不够用；更麻烦的是，如果 handler panic 了，日志中间件可能没来得及写入就退出。
- 务必在 Recovery 中间件之后注册日志中间件，否则 panic 时日志会被截断
- 用
c.Keys或自定义字段存起始时间戳，避免依赖外部变量造成并发冲突 - 记录
c.ClientIP()而非c.Request.RemoteAddr，后者在 Nginx 转发后是代理 IP - 状态码必须从
c.Writer.Status()获取，不能用硬编码或 handler 返回值，因为中间件可能修改响应
参数校验必须绑定结构体 + tag，拒绝手写 if 判断
用 c.Query("xxx") + if xxx == "" 校验，代码膨胀快、错误提示不统一、无法复用校验规则。
- 定义结构体时用
bindingtag，比如Username string `json:"username" binding:"required,min=2,max=20"` - 调用
c.ShouldBind(&req)，失败自动返回 400 并填充标准错误字段，不用手动c.AbortWithStatusJSON() - 全局注册自定义验证器（如手机号、邮箱格式），避免每个结构体重复写正则
- 注意：JSON 和 Form 绑定行为不同，
c.ShouldBindJSON()会读取 body，而c.ShouldBind()自动识别 Content-Type，优先用后者
JWT 鉴权中间件要区分 public / protected 路由，且 Token 解析失败必须明确返回 401
把所有路由都套 AuthMiddleware()，结果健康检查、登录接口也被拦住；或者 Token 过期/签名错误时返回 500，前端无法区分是服务炸了还是登录失效。
- 用路由分组隔离 public 路径，比如
r := gin.Group("/api")下再分.Group("/v1/auth")（免鉴权）和.Group("/v1/user").Use(AuthMiddleware())（需鉴权） - 解析 Token 时捕获
jwt.ParseError类型，对TokenExpired和ValidationErrorSignatureInvalid分别返回不同 msg，但统一状态码 401 - 从
c.Request.Header.Get("Authorization")提取 token，去掉"Bearer "前缀后再解析，别依赖前端传得规整 - 校验通过后，把 user ID 或 claims 写进
c.Set("user_id", uid)，后续 handler 直接取，别重复解析
真正难的不是写一个能跑的中间件，而是让它们组合起来不互相干扰：日志不因 panic 失效，跨域不破坏鉴权头，参数校验错误时不触发 JWT 解析。每层封装都要清楚自己在哪一环、依赖什么、可能被谁改写。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
