必须使用 influxdb-client-go/v2，因其内置连接池、缓冲区、自动重试和纳秒精度控制，避免丢点、重试缺失和时间戳错乱；初始化仅传 url 和 token，写入时指定 org/bucket，显式设置精度、时区及错误回调，严格区分 tag（低基数过滤）与 field（原始指标）。
直接用 influxdb-client-go/v2，别碰 influxdb1-client 或手写 HTTP 请求——丢点、重试缺失、时间戳错乱这三件事在生产环境里几乎必然发生。
初始化 client 必须绕开老版本和自定义 HTTP 封装
新版 SDK 已内置连接池、缓冲区、自动重试和纳秒级精度控制，这些不是“可选优化”，而是写入不丢数据的底线。
- 安装命令必须带
/v2：go get github.com/influxdata/influxdb-client-go/v2 - 初始化只传 URL 和 Token：
influxdb2.NewClient("http://localhost:8086", "your-token")，org和bucket是写入时才指定的，不是 client 构造参数 - 若连的是自签名 HTTPS 或本地测试环境，必须显式配置：
influxdb2.HTTPConfig{InsecureSkipVerify: true} - 建议设置
ErrorCallback捕获写入失败（比如网络抖动、token 权限不足），而不是静默吞掉错误
写入时时间戳单位错是查不到数据的最常见原因
InfluxDB 默认按纳秒解析时间戳，但 Go 的 time.Now() 返回的是纳秒值，而多数监控采集源（如 Prometheus Exporter、Telegraf）实际提供的是毫秒级时间戳。混用会导致数据被截断或聚合错乱。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 务必显式调用
SetPrecision("ms")或"ns"，取决于你的时间戳来源；例如毫秒时间戳就设"ms" -
SetTime()必须调用，且推荐用time.Now().UTC()，避免本地时区干扰 - 字段类型要对齐：
AddField("cpu_usage", float64(95.2))，别传int（32 位平台可能溢出），整数统一用int64 - Tag 值不能含逗号、等号、空格，否则 Line Protocol 解析失败；建议提前清洗：
strings.ReplaceAll(v, " ", "_")
高基数字段塞进 tag 会直接拖垮 InfluxDB
Series 爆炸不是性能问题，是资源耗尽型故障——内存暴涨、写入卡顿、查询超时，重启都救不回来。
- Tag 只用于低基数、高频过滤字段：比如
host="web01"、service="auth"、env="prod" - 原始指标值（
latency_ms、http_status、error_count）一律进field，不建索引也没关系，InfluxDB 对field聚合极快 - 判断标准就一条：这个字段是否常用于
WHERE或GROUP BY？取值是否少于几百个？满足才放tag - 单个
measurement的 tag 组合总数（series 数）超过 10 万就该警觉；官方建议控制在 10 万以下
真正难的不是写进去，而是让写入行为可预测——时间戳精度、tag cardinality、client 初始化方式，这三个点任意一个没对齐，后续排查成本会指数级上升。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
