结论：用influxdb-client-go/v2初始化客户端时只传url和token、显式设置precision为"ms"、将高基数字段全放入field而非tag，三者任一出错均会导致数据查不到或系统卡死。
直接说结论：用 influxdb-client-go/v2 初始化客户端、显式设 Precision、把高基数字段全塞进 field 而不是 tag，这三件事做错任何一项，监控数据就大概率查不到或系统卡死。
初始化 client 时只传 URL 和 Token，别碰 org/bucket
很多人一上来就往 NewClient() 里塞 org 和 bucket，结果 panic 或报 404 not found。这是因为 influxdb-client-go/v2 的设计逻辑是：client 只管连接和认证，org 和 bucket 是写入时才绑定的上下文参数。
- 正确写法：
client := influxdb2.NewClient("http://localhost:8086", "your_token") - 错误写法：
influxdb2.NewClient("...", "token", "myorg", "mybucket")—— 这个签名根本不存在 - 如果连的是自签名 HTTPS（比如本地 Docker 环境），必须加
HTTPConfig{InsecureSkipVerify: true}，否则 TLS 握手失败，错误信息是x509: certificate signed by unknown authority -
org和bucket必须提前在 InfluxDB UI 或 CLI 创建好；SDK 不提供创建接口，Token 也得有对应 bucket 的 write 权限
写入前必须显式指定 time precision，否则时间戳全乱
Go 的 time.Now().UnixMilli() 返回毫秒，但 influxdb-client-go/v2 默认按纳秒解析。不设精度，一个 1718345220000（毫秒）会被当 1718345220000 纳秒 ≈ 1.7 秒后 存进去，查当天数据永远为空。
- 构造
Point时，SetTime()必须调用，且推荐用time.Now().UTC()，避免本地时区干扰 - 批量写入（
WriteAPI.WritePoints()）必须通过WriteOptions显式设Precision: "ms"，不能依赖默认值 - 常见错误现象：数据写进去了，但
SELECT * FROM ... WHERE time > now() - 1h查不到；Flux 查询返回空；Grafana 图表断层 - 判断依据：你的时间戳来源是什么？Prometheus Exporter 是毫秒，Telegraf 默认毫秒，
time.UnixMilli()是毫秒，time.UnixNano()才是纳秒
tag 字段误用导致 series 爆炸，比写不进去还致命
把 request_id、user_ip、trace_id 这类每条都不一样的字符串塞进 tag，InfluxDB 会为每个唯一组合生成一个新 series。10 万请求 = 10 万个 series，内存飙高、写入延迟飙升、查询超时，最终服务假死。
- 只把低基数、高频过滤字段放
tag：例如host="web01"、env="prod"、service="auth"—— 这些取值通常少于几百个 - 原始指标值一律进
field：如latency_ms=123.4、http_status=200、error_count=1，它们不建索引也没关系，InfluxDB 对field聚合极快 - 字符串
tag值不能含逗号、等号、空格，否则 Line Protocol 解析失败；建议提前清洗：strings.ReplaceAll(v, " ", "_") - 单个
measurement的 tag 组合总数（series 数）超过 10 万就该警觉；官方明确建议控制在 10 万以下
批量写入失败静默丢点，必须手动检查 error
WriteAPI.WritePoints() 默认异步 + 缓冲队列，网络抖动或服务端返回 429 Too Many Requests 时，部分点直接丢弃，函数却返回 nil 错误，你以为写成功了。
- 不要依赖
len(points)判断是否全写入；InfluxDB 对单次请求中部分点校验失败，可能只返回 warning 级 error，err仍为nil - 更稳妥做法：用
WriteAPIBlocking（同步阻塞模式），或自己封装WritePoints()并严格检查返回的err - 如果启用批量缓冲（
BatchSize/FlushInterval），务必配好重试策略和失败回调，否则断网期间的数据无法补传 - 字段类型也要小心：
AddField("cpu_usage", int(95))在 32 位平台可能溢出；统一用float64(95.0)或int64(95)，整数建议加后缀如95i
真正难的不是写进去，而是让每一条数据都可查、可聚合、不拖垮集群。precision 设错，查不到；tag 塞错，跑不动；error 不判，丢数据——这三个点，任何一个漏掉，监控系统就只是个摆设。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
