根本原因是只注册了指标，没挂载http handler；必须显式调用http.handle("/metrics", promhttp.handler())且在listenandserve前执行，否则/metrics路径不存在导致404或空响应。
为什么/metrics返回404或空响应
根本原因是只注册了指标，没挂载HTTP Handler。Prometheus客户端不会自动把指标塞进路由里——prometheus.MustRegister()只是把指标放进默认注册器，但/metrics路径压根不存在。
必须显式调用：http.Handle("/metrics", promhttp.Handler())，且这行代码要在http.ListenAndServe()之前执行。如果用了Gin，得用router.Use(gin.WrapH(promhttp.Handler()))；Echo则用e.GET("/metrics", echo.WrapHandler(promhttp.Handler()))。
- 路径名不强制叫
/metrics，但Prometheus配置里的scrape_configs.job.metrics_path必须和这里一致 - 别手写
http.HandleFunc拼文本响应——promhttp.Handler()会处理Content-Type协商、gzip、HEAD请求，自己拼容易格式不兼容 - 若用了自定义Registry（比如
reg := prometheus.NewRegistry()），必须用promhttp.HandlerFor(reg, nil)，不能直接用promhttp.Handler()
自定义指标一注册就panic：duplicate metrics collector
这是Go Prometheus客户端最典型的崩溃原因，不是代码写错，而是注册逻辑失控。同名指标（包括label维度组合）被MustRegister()两次，进程立刻退出，HTTP服务起不来。
高频场景：
- 把
prometheus.NewCounterVec()写在HTTP handler函数里，每次请求都新建+注册 - 多个包的
init()都执行同一段注册代码（比如公共metrics包被多处import） - 单元测试没清理registry，跑完一个test case后registry还残留指标
解法很明确：所有指标变量必须是包级变量，注册只做一次，放在init()或main()开头：
var httpReqCounter = prometheus.NewCounterVec(
prometheus.CounterOpts{ Name: "http_requests_total", Help: "Total HTTP requests" },
[]string{"method", "path", "status"},
)
func init() {
prometheus.MustRegister(httpReqCounter)
}
活跃连接数为什么越看越高，从不下降
因为用了Counter去记“当前在线人数”或“WebSocket连接数”。Counter只支持Inc()和Add()，没有Dec()——goroutine退出时没法扣减，数字只增不减，监控完全失真。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
正确做法：
- 改用
Gauge类型：prometheus.NewGaugeVec() - 每个新连接调
.Inc()，连接关闭时务必调.Dec()（建议用defer gauge.Dec()确保执行） - 如果连接生命周期跨多个goroutine，需保证
Dec()只执行一次，避免负值
别用Gauge.Set(1)模拟计数——那只是覆盖当前值，不是原子增减，高并发下会丢数据。
打点时标签爆炸或P99不准，怎么选Histogram还是Summary
标签爆炸常因把用户ID、traceID这类高基数字段直接塞进WithLabelValues()；P99不准则大概率误用了Summary——它不支持Prometheus的rate()聚合，分位数计算也依赖客户端滑动窗口，查历史P99会漂移。
实操建议：
- 延迟类指标一律用
Histogram：prometheus.NewHistogramVec()，Buckets按SLA目标设（如SLA是200ms，Buckets至少含0.2） - 避免在
Histogram上加业务标签（如user_id），它本身不支持多维分桶；状态码等维度用CounterVec单独统计 - 路径中动态ID（如
/order/123）必须归一化为/order/{id}再打点，否则每笔订单生成一个新时间序列 - 高基数标签改用采样：比如只对
error_type打标，不记录具体error_message
真正难的不是写几行注册代码，而是在服务启动前就想清楚指标语义、标签粒度、生命周期管理——漏掉任何一环，后期都要花十倍力气修。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
