应使用gin.new()创建空引擎并用gin.wraph包装go-kit的httptransport.server，避免gin.default()与go-kit的http.handler冲突；所有业务逻辑须经endpoint封装，decode函数需直接读r.body且禁用gin自动解析。
gin.Default() 和 go-kit 的 http.Handler 冲突怎么解
直接用 gin.Default() 启动，再套 go-kit 的 httptransport.NewServer，会导致两个 HTTP 处理器逻辑混杂，gin.Engine 不是标准 http.Handler 的“干净”实现——它内部做了 context 切换和中间件栈管理，而 go-kit 的 http.Server 期望的是纯函数式、无副作用的 handler。
正确做法是让 gin 实例退回到接口兼容层：用 gin.New() 初始化空引擎，不加默认中间件；所有路由注册必须通过 gin.WrapH() 包装 go-kit 的 httptransport.Server 实例，而不是反过来。
-
gin.WrapH()是关键桥接函数，它把http.Handler转成gin.HandlerFunc，否则r.POST("/foo", fooHandler)会编译失败 - 不要在 gin 路由里写业务逻辑，所有 endpoint 必须先经 go-kit 的
endpoint.Endpoint封装，再交给 transport 层 - 如果用了
gin.Logger()或gin.Recovery()，要确认它们和 go-kit 的ServerErrorEncoder不重复写 status code，否则响应头可能被覆盖
decodeRequest 函数里读 body 失败的常见原因
go-kit 的 httptransport.NewServer 默认只读一次 r.Body，但 gin 在解析 form 或 json 时可能已提前 consume 过——尤其当你在 decode 函数外调用过 c.Request.ParseForm() 或 c.ShouldBindJSON()，就会导致后续 decode 报 http: body already read 错误。
根本解法是绕过 gin 的自动解析，全程由 go-kit 控制输入流：
- decode 函数里直接用
json.NewDecoder(r.Body).Decode(&req)，不要依赖 gin.Context - 确保请求 Content-Type 是
application/json，go-kit 不自动处理 multipart/form-data - 如果需要 query 参数，从
r.URL.Query()提取，别用c.Query() - 避免在 gin handler 里调用任何读 body 的方法，包括
c.Request.Body直接访问
服务启停生命周期必须交给 go-kit 管理
很多人写完 r := gin.New(); r.POST(...); r.Run(":8080") 就以为完事了，但这样完全绕过了 go-kit 的 graceful shutdown、超时控制和 endpoint 生命周期钩子。一旦服务要下线或扩容，连接会强制中断，丢失正在处理的请求。
真正可控的做法是把 gin 引擎当做一个 http.Handler 交出去：
- 构造好
gin.Engine后，不再调用r.Run() - 用
http.Server{Addr: ":8080", Handler: r}手动启动，并注册 os.Signal 监听 - 或更推荐：用 go-kit 的
transport/http.NewTransport（需自行封装）+run.Group统一管理多个 transport 的启停 - 务必在 shutdown 前调用
r.Shutdown()，否则 gin 的 pending 请求不会等待完成
错误编码器不生效，HTTP 状态码总是 200
go-kit 默认的 httptransport.DefaultErrorEncoder 只负责序列化 error，不设置 HTTP status code。如果你没显式配置 ServerErrorEncoder，所有错误都会返回 200 + 错误 JSON，前端无法做状态分流。
修复方式很直接，但容易漏：
- 在
httptransport.NewServer的 options 里加上httptransport.ServerErrorEncoder(yourEncoder) - encoder 函数里必须调用
w.WriteHeader(code)，例如w.WriteHeader(http.StatusInternalServerError) - 别复用 gin 的
c.AbortWithStatusJSON()，它操作的是*gin.Context，而 go-kit 的 encoder 接收的是http.ResponseWriter - 如果 error 类型实现了
statusCoder接口（如go-kit/kit/transport/http/server.go中定义），可自动映射 status code，但需确保 error 构造时传入了正确 code
