写入数据前必须显式设置 precision 参数，如毫秒时间戳需设为”ms”，否则会被误解析为纳秒导致数据错乱；tag 应仅用于低基数、高频过滤字段，高基数字段塞入 tag 会引发 series 爆炸和性能暴跌。
写入数据前必须设置正确的 precision 参数
go 客户端写入 InfluxDB 时，默认用纳秒精度（ns），但如果你的时间戳来自 time.Now() 或 json 解析，很可能实际是毫秒级——不显式指定 precision 就会写进错误时间点，查不到、聚合错、甚至被 silently 截断。
- 写入前确认时间戳单位：unix 时间戳是毫秒？微秒？还是纳秒？常见监控打点（如 prometheus Exporter、Telegraf）多为毫秒
- 用
client.WritePoint()时，传入的*client.Point必须带Time字段；若留空，客户端自动填入纳秒时间，和你预期不符 - 批量写入用
client.Write()时，必须通过client.BatchPointsConfig.Precision显式设为"ms"、"s"等，不能依赖默认值 - 示例：
bp, _ := client.NewBatchPoints(client.BatchPointsConfig{ Database: "metrics", Precision: "ms", // ← 关键！不写这行，毫秒时间戳会被当纳秒处理 })
Tag 和 Field 混用导致查询性能暴跌
InfluxDB 的索引只建在 tag 上，field 不索引。把高基数字段（如请求 ID、用户 IP、traceID）误塞进 tag，会导致 series 数爆炸，内存暴涨、写入卡顿、查询超时。
- 判断标准：该字段是否用于
GROUP BY或WHERE过滤？是否取值少（host=”web01″）？满足才放tag - 日志类、指标类原始值（如
latency_ms、http_status、error_message）一律进field - Go 构造
client.Point时，tags map[string]string和fields map[string]interface{}是两个独立参数，别手滑塞错 map - 典型错误：
tags: map[string]string{"trace_id": "abc123"} // ❌ 高基数 tag，series 泛滥
批量写入失败不报错，但部分点丢失
client.Write() 默认启用异步批量提交，底层用缓冲队列 + goroutine 发送。一旦网络抖动或服务端拒绝（如 429 Too Many Requests），错误被吞掉，err 返回 nil，但部分点已丢弃。
- 必须手动开启同步模式：创建 client 时传
client.HTTPConfig{InsecureSkipVerify: true}不够，关键要设WriteConsistency和检查返回 err - 更稳妥做法：禁用内部 batch，自己控制
client.WritePoints()并捕获 error —— 它返回的是完整写入结果，不是 void - 务必检查返回的
err，而不仅是len(points)是否匹配；InfluxDB 对单次请求中部分点校验失败时，可能只返回 warning 级 error - 示例：
if err := client.Write(bp); err != nil { log.Printf("write failed: %v", err) // ← 别跳过这行 }
Go struct 转 Point 时 time.Time 字段解析出错
直接把含 time.Time 字段的 struct 传给 client.NewPoint()，时间字段常被转成 Unix 纳秒整数，再被 client 当作“无时区时间戳”二次解释，最终写入时间偏移 8 小时或完全错乱。
立即学习“go语言免费学习笔记（深入）”；
- 根本原因：
client.NewPoint()对 struct 的反射逻辑不处理time.Time的时区信息，只取.UnixNano() - 安全做法：手动提取
time.Time字段，调用.In(time.UTC)统一时区，再传给client.Point{Time: t} - 避免用 struct tag 自动映射时间字段（如
json:"ts" influx:"time"），InfluxDB Go client 不支持该 tag 语义 - 如果结构体里有多个时间字段，只允许一个作为
Time，其余必须转成field（比如"start_time_ns": t1.UnixNano()）
时间精度、tag/field 边界、错误可见性、time.Time 时区 —— 这四点不抠清楚，写进去的数据看着成功，查起来全是谜。