用influxdb-client-go/v2初始化client，传URL和Token即可，org/bucket写入时指定；需配置HTTP安全选项、WriteAPI缓冲参数、时间戳精度、字段类型及tag/field合理划分，并确保org/bucket已预创建且Token权限正确。
用 influxdb-client-go/v2 初始化 client 就对了，别碰 influxdb1-client，也别自己拼 http.Client 发 POST /api/v2/write —— 丢点、没重试、时间戳错乱是常态。
安装和初始化必须带 /v2
安装命令漏掉 /v2 后缀会导致拉取错误版本（比如 v1.x 兼容分支或已归档的旧版），后续调用 NewClient 会 panic 或静默失败：
- 正确命令：
go get github.com/influxdata/influxdb-client-go/v2 - 错误示例：
go get github.com/influxdata/influxdb-client-go（拉的是 v1 分支，不支持 Token 认证） - 初始化只传 URL 和 Token：
influxdb2.NewClient("http://localhost:8086", "your_token")；org和bucket是写入时才指定的参数，不是 client 构造参数 - 如果连接的是自签名 HTTPS 或本地测试环境，必须显式配置：
influxdb2.HTTPConfig{InsecureSkipVerify: true}
WriteAPI 配置要设 BatchSize 和 FlushInterval
默认 WriteAPI 每次 WritePoint() 都触发网络请求，高频率打点（如每秒百级指标）下极易触发连接耗尽或超时。必须用 WriteOptions 控制缓冲行为：
-
BatchSize: 1000：攒够 1000 条再发，避免小包风暴 -
FlushInterval: 1000（单位 ms）：即使不满 1000 条，1 秒也强制 flush，防数据滞留 -
ErrorCallback必须设，否则写入失败会被吞掉，日志里看不到任何提示 - 程序退出前务必调
writeAPI.Flush()，否则缓冲区剩余数据直接丢失
时间戳精度必须显式指定
InfluxDB 默认按纳秒解析时间戳，但 Go 的 time.Now() 在监控/采集场景中多数是毫秒级精度。不显式设精度会导致数据被截断、查不到、聚合结果错：
立即学习“go语言免费学习笔记（深入）”；
- SetTime() 必须调用，且推荐用
time.Now().UTC()，避免本地时区干扰 - 毫秒时间戳就得设
"ms"：point.SetPrecision("ms") - 字段类型要对齐：
AddField("cpu_usage", float64(95.2))，别传int（32 位平台可能溢出），整数用int64或加后缀如8i - 字符串 tag 值不能含逗号、等号、空格，否则 Line Protocol 解析失败；建议提前清洗：
strings.ReplaceAll(v, " ", "_")
Tag 和 Field 划分容易踩内存爆炸坑
把高基数字段（如 request_id、user_ip、trace_id）塞进 tag，会引发 series 爆炸，InfluxDB 内存暴涨、写入卡顿、查询超时——这是监控系统崩掉最常见的原因：
- tag 只用于低基数、高频过滤字段：比如
host="web01"、service="auth"、env="prod" - 原始指标值（
latency_ms、http_status、error_count）一律进 field - 判断标准就一条：这个字段是否常用于
WHERE或GROUP BY？取值是否少于几百个？满足才放 tag - 单个 measurement 的 tag 组合总数（series 数）超过 10 万就该警觉；InfluxDB 官方建议控制在 10 万以下
最常被忽略的一点：org 和 bucket 必须提前在 InfluxDB UI 或 CLI 创建好，SDK 不提供创建接口；Token 需有对应 bucket 的 write 权限，权限不对只会返回 401，不会报具体缺失哪项权限。
