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 本身不提供元数据描述能力。
