Golang Expvar包导出自定义变量_集成第三方监控系统的桥梁

expvar.publish没生效是因为只接受expvar.var接口类型，需用expvar.newint()等而非原始类型；/debug/vars默认仅限localhost，须显式注册handler且避免路由冲突。

expvar.Publish 为什么没生效？变量根本没出现在 /debug/vars 里

调用 expvar.Publish 后访问 /debug/vars 看不到你的变量，不是因为你写错了，而是它只接受 expvar.Var 接口类型——普通 int、String 或 map 都不行。

• expvar.Publish 的第二个参数必须是实现了 expvar.Var 接口的值（比如 *expvar.Int、*expvar.Map），不能传原始类型或自定义 Struct
• 常见错误：直接传 expvar.Publish("counter", 42) → 无效；正确写法是 expvar.Publish("counter", expvar.NewInt())，再用 .Set(42)
• 如果变量要支持并发更新，优先用 expvar.NewInt()、expvar.NewFloat()、expvar.NewMap()，它们内部已加锁
• 别在 init() 里 publish 同名变量多次，会 panic：”already registered“ —— 检查是否重复 import 或重复初始化

怎么把自定义结构体（比如 http 统计）暴露给 expvar

想导出带多个字段的统计结构（如请求总数、失败数、平均延迟），不能直接 publish struct，得包装成 expvar.Map 并手动同步字段值。

• 用 expvar.NewMap("http_stats") 创建顶层容器，再往里面 add 子变量：stats.Set("total", expvar.NewInt())
• 每次更新时，必须显式调用子变量的 .Set() 或 .Add()，expvar 不会自动反射或监听 struct 字段变化
• 避免在 handler 中高频调用 expvar.Map.Set —— 它内部有 mutex，高并发下可能成瓶颈；可先在本地累加，定期批量 flush 到 expvar
• 如果结构体字段多且动态，考虑用 expvar.Map 的 AddMap 方法嵌套，但注意嵌套层级过深会让 prometheus 抓取时解析变慢

用 curl 或 Prometheus 抓不到 expvar 数据？检查这几个点

/debug/vars 默认只绑定 localhost，生产环境外网访问不到，不是配置漏了，是 go runtime 的默认保护策略。

• HTTP server 必须显式注册 expvar handler：http.HandleFunc("/debug/vars", expvar.Handler().ServeHTTP)，光 import 包没用
• 若服务监听 0.0.0.0:8080 却只允许 curl http://localhost:8080/debug/vars，大概率是 handler 被挂到了错的 mux 上（比如用了 gorilla/mux 却没传对 router）
• Prometheus 抓取失败常因 Content-Type 是 text/plain; charset=utf-8，而老版本 client 期望 application/json —— 可用 promhttp 中间件做格式转换，或改用 expvarmon 这类兼容桥接工具
• 某些容器环境（如 kubernetes）会拦截 /debug/* 路径，需确认 ingress 或 sidecar 是否重写了路径

expvar 和 pprof 共用时 /debug/vars 返回 404

不是冲突，是路由覆盖。Go 标准库的 expvar.Handler() 和 pprof.Handler() 都试图注册到同一 mux 的根路径，后注册的会顶掉前一个。

立即学习“go语言免费学习笔记（深入）”；

• 别这么写：http.Handle("/debug/", http.StripPrefix("/debug/", pprof.Handler())) + 另一行 http.HandleFunc("/debug/vars", ...) —— 前者已接管全部 /debug/*，后者永远不会触发
• 正确做法：统一用 http.ServeMux 显式注册，例如：mux.HandleFunc("/debug/vars", expvar.Handler().ServeHTTP) 和 mux.Handle("/debug/pprof/", http.StripPrefix("/debug/pprof/", pprof.Handler()))
• 如果你用的是 http.DefaultServeMux，确保所有 debug handler 都在 http.ListenAndServe 之前注册，顺序无关，但不能漏
• 调试时 curl -v 看响应头里的 Server 和 Content-Length，404 但 Content-Length > 0？说明 handler 执行了但返回空 —— 很可能是 expvar map 为空（没 publish 任何变量）

实际集成监控系统时，最麻烦的往往不是发布变量，而是让下游系统理解 expvar 的扁平 JSON 结构。Prometheus 要 label，zabbix 要 key 命名规范，Datadog 要 type hint —— 这些都得靠一层薄薄的代理或 exporter 补齐，expvar 本身不提供元数据描述能力。