必须显式调用 prometheus.MustRegister() 且仅一次否则指标未注册导致 /metrics 为空或 404自定义 Registry 需配 promhttp.HandlerFor(reg, ...)注册须在 ListenAndServe 前完成。用 prometheus/client_golang 暴露指标是 Go 服务监控的事实标准自己手写计数器、拼 metrics 文本、绕过注册机制——全都会在上线后出问题。怎么注册指标才不会 404 或返回空指标没注册 Prometheus 看不见promhttp.Handler() 只读默认注册器prometheus.DefaultRegisterer但很多人误以为“定义了变量就自动生效”。必须显式调用 prometheus.MustRegister()且只能调一次重复注册会 panicduplicate metrics collector registration attempted如果用了自定义 prometheus.NewRegistry()就得配 promhttp.HandlerFor(reg, ...)否则 promhttp.Handler() 还是查默认注册器结果就是 /metrics 返回 200 但内容为空注册必须在 http.ListenAndServe() 之前完成放在 init() 或 main() 开头最安全Counter 和 Gauge 到底该用哪个类型选错不是“不好看”而是会让 PromQL 查询直接失效比如用 Gauge.Set() 记请求总数服务重启后数值归零rate() 就崩掉。Counter只增不减适合累计量——http_requests_total、errors_totalGauge可升可降适合瞬时值——go_goroutines、cache_size_bytes别用 Gauge 模拟 P95 延迟那是 Histogram 的职责也别用 Counter 记当前活跃连接数它不会减HTTP 中间件埋点为什么耗时不准常见写法是在 handler 开头打点、结尾再打点但中间可能 panic、提前 return、或 defer 没覆盖所有出口导致 Observe() 漏调或时机错位。 Trenz AI驱动的社交电商营销平台专为TikTok Shop设计