直接用 prometheus.NewGaugeVec 会 panic 是因为未注册到 DefaultRegisterer 或指标名非法；必须显式调用 prometheus.MustRegister()，且 Name 仅允许小写字母、数字、下划线、冒号，Help 非空。
为什么直接用 prometheus.NewGaugeVec 会 panic？
因为没注册到默认的 prometheus.DefaultRegisterer，或者注册时机不对。Go 微服务启动时，如果在 init() 里创建指标但没调用 .MustRegister()，后续 HTTP handler 暴露指标时会查不到数据，甚至 promhttp.Handler() 返回空响应。
正确做法是：所有指标必须显式注册，且最好在 main() 初始化阶段完成，不能延迟到 handler 里才创建。
- 用
prometheus.MustRegister()替代手动检查错误（它 panic 而不是返回 error，适合启动期） - 避免在 HTTP handler 中反复调用
NewCounterVec——每次都会新建对象，导致内存泄漏和指标重复注册报错 - 全局变量定义指标（如
var httpReqDur = prometheus.NewHistogramVec(...)），然后在main()里prometheus.MustRegister(httpReqDur)
如何给 HTTP 请求打标签并记录耗时？
业务微服务最常监控的是接口成功率、延迟、QPS。用 prometheus.NewHistogramVec 是标准做法，但标签设计直接影响查询灵活性和 cardinality 风险。
比如按 method 和 status 打标很安全，但加 path 就危险——如果 path 含用户 ID 或 UUID，会导致 label 组合爆炸，Prometheus 内存飙升甚至 OOM。
立即学习“go语言免费学习笔记（深入）”；
- 路径聚合用正则预处理：
/api/v1/users/{id}替换掉动态段再设为pathlabel - 直传
r.URL.Path前先做白名单过滤，或只保留前两级路径 - 记录耗时时，用
Observe()而非Set()；起始时间用time.Now()，结束时observeDur := time.Since(start).Seconds(); httpReqDur.WithLabelValues(method, status).Observe(observeDur)
为什么 /metrics 端点返回 200 但内容为空？
常见于注册顺序错误或 mux 路由冲突。Prometheus 的 promhttp.Handler() 必须挂载在正确的路由上，且不能被其他中间件拦截或重写 response body。
- 确认是否用了
http.Handle("/metrics", promhttp.Handler())，而不是http.HandleFunc——后者不支持 Prometheus 的 text format content negotiation - 如果你用
gorilla/mux或chi，要确保r.Handle("/metrics", promhttp.Handler()).Methods("GET")在所有业务路由之前注册 - 检查是否有中间件（如 gzip、auth）提前写了 response header/body，导致
promhttp.Handler()写失败——可在 handler 外层加if r.URL.Path == "/metrics" { ... }短路掉无关中间件
如何让自定义指标支持热更新而不重启服务？
Prometheus 指标本身不支持“修改定义”，但你可以通过复用已注册的 Vec 实例，在运行时动态增删 label 值。真正的难点在于：指标类型（Counter/Gauge/Histogram）和 label 名称一旦注册就不能改，否则会 panic。
- 需要动态维度时，预先定义足够宽泛的 label，例如
operation而不是硬编码"create_user"，运行时填值即可 - 不要试图 unregister 再 register 同名指标——Prometheus 不允许，会 panic "duplicate metrics collector registration attempted"
- 若真需切换指标逻辑（如从计数改为采样），只能靠新增一套指标名（如加
_v2后缀），旧指标自然归档
真正容易被忽略的是：指标生命周期必须和应用生命周期对齐。微服务 reload 时，如果旧 goroutine 还在往已注销的 Vec 写数据，会 panic。所以所有指标操作必须发生在主 goroutine 控制范围内，或加 sync.Once 包裹初始化逻辑。
