Go Kit 服务404或panic的主因是endpoint与transport间类型未对齐、context未透传及error处理不统一；需确保decode/encode结构体字段名类型严格匹配、首字母大写、JSON tag正确，且log/metrics/tracing均依赖context传递。
Go Kit 不是开箱即用的框架，而是需要你亲手组装的微服务工具集；直接照搬示例代码跑不起来，核心卡点在 endpoint 与 transport 的类型对齐和上下文传递上。
为什么你的 go-kit 服务启动后 404 或 panic？
最常见原因是 http.NewServer 的 decodeRequest 函数没正确处理请求体或 URL 参数，导致传入 endpoint 的 request 是 nil 或类型断言失败。Go Kit 不自动解析 query/body，全靠你手写 decode 逻辑。
- GET 请求必须手动从
r.URL.Query()提取参数，不能依赖结构体标签自动绑定 - POST JSON 必须检查
Content-Type头，且json.NewDecoder(r.Body).Decode()后要关闭 body（否则后续中间件读不到） -
greetingRequest和greetingResponse的字段必须首字母大写，否则 JSON 编解码失败（Go 反射规则） - 所有
endpoint.Endpoint函数签名固定为func(context.Context, interface{}) (interface{}, error)，传入 request 类型错、返回 response 类型错，都会在运行时 panic
如何让 endpoint 正确串联 service 和 transport？
关键不是“写完就扔”，而是保持三层之间数据结构的严格一致：service 方法参数/返回值 → endpoint 输入/输出 → transport decode/encode 的 struct 字段名和类型必须完全匹配。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- service 层定义
Greeting(string) (string, error)，那greetingRequest就只能有一个Name string字段，不能多也不能少 -
makeGreetingEndpoint内部的req.(greetingRequest)断言，依赖 transport 层 decode 返回的正是greetingRequest实例，否则 panic - transport 的
encodeResponse接收的是 endpoint 返回的greetingResponse，字段名、tag、可导出性必须和 decode 侧的 request struct 对称 - 别省略
error字段的 JSON tag：Err string `json:"err,omitempty"`，否则错误信息不会出现在响应里
log、metrics、tracer 这些“可观测性”组件怎么接才不漏数据？
它们不是插上就生效的开关，而是靠 context 透传 + 中间件包装。漏数据的主因是中间件链没包住 endpoint，或 context 没往下传。
立即学习“go语言免费学习笔记（深入）”；
-
log.Logger必须作为endpoint函数闭包的捕获变量，或通过context.WithValue注入，不能在 handler 里临时 New - 使用
kit/log时，log.With(logger, "method", "Greeting")要放在 endpoint 函数开头，且 logger 必须带 traceID（来自 transport 层注入的 context） -
prometheus.Counter等指标对象需在 service 初始化时创建并传入 endpoint，不能每次调用都 New，否则指标不累积 - tracing 的 span 必须由 transport 层（如
http.Server）创建，并通过ctx传给 endpoint，endpoint 内部再用opentracing.StartSpanFromContext继承
真正难的不是写多少行代码，而是每一层之间那几个 interface{} 和 context.Context 的交接点——那里没有编译错误，但 runtime 一碰就崩。类型对齐、context 透传、error 处理路径统一，这三处松动一点，整个链路就断在你看不见的地方。
