go kit 的 endpoint 是业务逻辑的协议无关封装，签名固定为 func(context.context, interface{}) (interface{}, error)，需配合 transport 层（如 http.newserver）和注册机制才能运行。
go-kit 的 endpoint 是什么，为什么不能直接写 handler？
endpoint 不是 HTTP handler，而是业务逻辑的“协议无关封装”。你写一个 Validate 方法，它既能在 HTTP 里用，也能在 gRPC、Thrift 甚至 CLI 里复用。如果跳过 endpoint 直接写 http.HandlerFunc，等于把传输层（HTTP）和业务逻辑焊死，后续加 gRPC 支持或单元测试就得重写一遍。
常见错误：把 request 和 response 定义成 http.Request/http.ResponseWriter 类型 —— 这会让 endpoint 失去跨协议能力，Go Kit 的 transport 层根本没法接。
- request/response 结构体必须是纯数据结构（如
type ValidateRequest struct { Date string }），不含任何 net/http 依赖 - endpoint 函数签名固定为
func(context.Context, interface{}) (interface{}, error)，不是func(http.ResponseWriter, *http.Request) - transport 层（比如
http.NewServer）负责把 HTTP 请求解包成你的 request 结构，再喂给 endpoint；返回值也由它序列化回 JSON 或其他格式
怎么让 go-kit 服务真正跑起来？别只写 endpoint
只定义 helloEndpoint() 是没用的 —— 它只是个函数，不监听端口、不解析请求、不返回 HTTP 状态码。Go Kit 要求你显式组装三层：endpoint → transport → server。
典型遗漏：忘了注册 handler 到 http.ServeMux，或者用错 http.ListenAndServe 的第二个参数（传了 nil 而不是 mux）。
- 必须用
transport/http.NewServer包裹 endpoint，并提供decodeRequest和encodeResponse函数（否则请求体无法解析） - handler 创建后，要手动注册到
http.Handle("/validate", yourHandler)，不能只调yourHandler.ServeHTTP -
http.ListenAndServe(":8080", nil)中的nil表示用默认 mux，但如果你自己建了http.NewServeMux()，就必须传进去，否则路由不生效
服务注册 Consul 失败？检查这三个地方
Consul 注册失败时，go-kit 不会报明显错误，服务看似启动成功，实则“隐身”——其他服务发现不了它。根本原因常出在健康检查配置、网络连通性或注册时机上。
常见现象：curl http://localhost:8500/v1/health/service/user-service 返回空数组，或日志里有 "failed to register" "err":"Put ... dial tcp 127.0.0.1:8500: connect: connection refused"。
- 确认 Consul 容器端口映射正确：
docker run -p 8500:8500 consul，且 Go 服务里连接地址是"http://host.docker.internal:8500"（Mac/Win）或"http://172.17.0.1:8500"（Linux Docker 默认网关） - 注册对象必须实现
Registrar接口，且Register()调用要在http.ListenAndServe之前；否则服务已监听，但还没来得及注册就挂了 - Consul 健康检查路径（如
/status）必须真实存在并返回 200，且在注册配置中指定Check.HTTP = "http://localhost:8080/status"—— 注意这里不是容器内地址，而是 Consul 能访问到的服务地址
中间件链顺序错了，日志和熔断就全乱套
Go Kit 中间件是洋葱模型：外层先执行，内层后执行。如果你把日志中间件放最里层，那它永远收不到 panic 后的错误；把熔断器放太外层，它可能对 OPTIONS 预检请求也计数，导致误触发。
典型错误：把 loggingMiddleware 和 circuitBreaker 链在一起时，用 svc = breaker(svc); svc = logging(svc) —— 实际执行顺序反了。
- 推荐顺序（由外到内）：
instrumenting → circuit breaker → rate limiter → logging → business service - 所有中间件必须接收并返回
Service接口类型，不能混用endpoint.Endpoint或http.Handler - 日志中间件里用
defer logger.Log("took", time.Since(begin))记录耗时，但如果外层有 panic，这个 defer 不会执行 —— 所以真正的耗时统计应放在最外层 transport 的 middleware 里
endpoint 是骨架，transport 是皮肤，中间件是神经，注册是呼吸 —— 少一环，服务就不是“活”的微服务，只是个能 curl 通的 Go 程序。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
