expvar.NewInt 和 expvar.NewFloat 有效，但需确保变量被全局引用且命名合法；自定义 struct 应嵌入 expvar.Map 并 Publish；/debug/vars 需手动注册 handler；生产环境可安全启用，性能开销极低。
expvar.NewInt 和 expvar.NewFloat 为什么没效果？
因为 expvar.NewInt 和 expvar.NewFloat 返回的是指针，但默认不自动注册到全局变量表里——你得手动调用 expvar.Publish 或直接用 expvar.Do 注册，更常见的是直接用 expvar.Get 检查是否已存在，或干脆走 expvar.Publish 显式挂载。
常见错误现象：变量声明了、自增了，但访问 /debug/vars 看不到；或者看到初始值 0 且不再变化。
- 正确做法是：先
var reqCount = expvar.NewInt("http_requests_total")，然后在逻辑中调用reqCount.Add(1) - 不需要额外 publish——
expvar.NewInt内部已自动注册，前提是变量名不重复且未被 gc 掉（即保持引用） - 如果变量定义在函数内，或被局部作用域包裹后没逃逸，可能被 GC 回收，导致指标消失
- 名字含点号（如
"api.latency_ms"）会被 expvar 当作嵌套对象处理，实际只支持简单标识符（字母/数字/下划线）
如何让自定义 struct 类型出现在 /debug/vars 页面？
expvar 支持任意实现了 expvar.Var 接口的类型，但最简路径是嵌入 expvar.Map 并用 Set 注册字段，而不是自己实现 String() 方法返回 JSON 字符串——那样只会被当成纯文本塞进顶层 key，无法展开。
使用场景：想暴露一组关联指标，比如连接池状态（idle、inuse、max）。
立即学习“go语言免费学习笔记（深入）”；
- 定义结构体时匿名嵌入
*expvar.Map，并在初始化时调用map.Init() - 每个字段用
map.Set("idle", expvar.NewInt("idle"))挂载，不是赋值给 struct 字段 - 最终注册到根命名空间：
expvar.Publish("db_pool", yourMapVar) - 避免在
String()里拼接 JSON——expvar 会把整个结果当字符串值，失去类型和可解析性
为什么 /debug/vars 返回 404 或空响应？
默认情况下，Go 的 http.DefaultServeMux 并不会自动注册 expvar 的 handler；它只是准备好了 expvar.Handler，但没人把它挂到路由上。
常见错误现象：启动服务后 curl /debug/vars 返回 404，或返回空页面（HTTP 200 但 body 为空）。
- 必须显式注册：
http.Handle("/debug/vars", expvar.Handler()) - 如果用了其他 mux（如 gorilla/mux、chi），不能依赖 DefaultServeMux，得手动
r.Handle("/debug/vars", expvar.Handler()) - 路径区分大小写，
/debug/VARS或/debug/vars/（带尾斜杠）都无效 - 若同时启用了 pprof，别把
/debug/pprof和/debug/vars注册到同一路径前缀下导致冲突
expvar 在生产环境要不要开？性能影响有多大？
开。默认几乎零开销——所有指标读取都是原子操作，/debug/vars 响应是快照式序列化，不加锁也不阻塞主逻辑。真正要注意的是你自己的指标更新频率和数据结构复杂度。
性能影响主要来自三类地方：
- 高频写入：比如每毫秒调用一次
expvar.Int.Add(1)，本身没问题；但若每次写都触发 map 查找+类型断言（比如用expvar.Get("x").(*expvar.Int).Add(1)），就比直接持有指针慢 3–5 倍 - 大结构体序列化：如果注册了一个含几百个字段的
expvar.Map，每次请求都要遍历并调用每个子项的String()，可能拖慢响应（尤其当某些String()有 IO 或计算） - 内存泄漏风险：用
expvar.Publish注册了匿名函数或闭包，又没提供清理机制，会导致变量长期驻留内存
复杂点在于：expvar 不提供指标生命周期管理，也没有 unregister 接口。一旦 publish，就一直挂着——所以动态创建的指标（比如按 tenant ID 分维度）必须自己用 map 管理，别直接 publish 到根空间。
