expvar 不是生产级监控方案，但它能快速暴露运行时关键指标，适合调试、压测和轻量级服务自检。
expvar 为什么默认只暴露 /debug/vars？
Go 运行时把 expvar 注册到默认的 http.DefaultServeMux，路径固定为 /debug/vars。它不自动启动 HTTP 服务，也不监听端口——你得自己起一个 http.Server，否则访问会 404。
- 常见错误现象：
curl http://localhost:8080/debug/vars返回 404，但代码里明明调了expvar.NewInt("hits") - 必须显式注册 handler：
http.Handle("/debug/vars", expvar.Handler()) - 如果用了自定义
http.ServeMux（比如 Gin、Echo），expvar.Handler()得手动挂载，不能依赖默认 mux - 路径不可改：handler 内部硬编码了 JSON 输出格式和 Content-Type，别试图用
http.StripPrefix套一层
怎么安全导出自定义变量而不破坏原有指标？
expvar 的全局变量表是并发安全的，但类型一旦注册就不能替换。直接调 expvar.NewInt("foo") 两次会 panic：panic: duplicate registration: foo。
- 使用场景：你想在初始化阶段注册计数器，但模块可能被多次 import 或测试中反复跑
- 推荐做法：用
expvar.Get("name")先查是否存在，再类型断言；不存在才新建 - 注意
expvar.Get返回*expvar.Int等指针类型，不是基础值，别误当int64用 - 示例：
if v := expvar.Get("req_count"); v != nil { if i, ok := v.(*expvar.Int); ok { i.Add(1) } } else { expvar.NewInt("req_count").Add(1) }
JSON 输出结构混乱？小心嵌套 map 和非标准类型
expvar.Handler() 输出的是纯 JSON，但它的 key 是字符串，value 可以是数字、字符串、数组或嵌套对象——前提是 value 实现了 expvar.Var 接口。随便塞 map[string]interface{} 或 struct 会直接被转成空对象 {}。
立即学习“go语言免费学习笔记（深入）”；
- 常见错误现象：用
expvar.Publish("stats", expvar.Func(...))返回 map，结果/debug/vars里该字段显示为"stats": {} - 正确做法：用
expvar.Map管理嵌套结构，它支持动态增删子项且可序列化 - 性能影响：每次请求都遍历整个变量表并 JSON 编码，变量过多（>100 个）或含大 slice 会导致明显延迟
- 兼容性提醒：Go 1.21+ 对
expvar.Map的并发读写做了优化，旧版本建议避免高频写入
真正难的不是注册几个变量，而是想清楚哪些指标值得暴露、谁会看、多久刷一次。/debug/vars 被扫到生产环境日志里不是小事，别把内存地址、配置明文、用户 ID 当成“内部变量”塞进去。
