用influxdb-client-go/v2初始化client、显式设时间精度、高基数字段全放field而非tag，三者任一出错均导致数据查不到或系统卡死；连不上v2需核对token、org、URL配置，org填name非ID，URL须带协议端口，自签名HTTPS需InsecureSkipVerify。
直接用 influxdb-client-go/v2 初始化 client，显式设时间精度、把高基数字段全塞进 field 而非 tag，这三件事做错任何一项，指标就大概率查不到或写入卡死。
连不上 InfluxDB v2？先核对 token、org、URL 三个硬参数
连接失败八成不是网络问题，而是认证或路由配置错。InfluxDB v2 要求 token 必须绑定 org 并授予 bucket 读写权限；org 填的是 name（比如 "my-org"），不是 UUID；URL 必须带协议和端口，例如 "http://localhost:8086" ——少一个斜杠或端口都会 404。
- token 要在 UI 的「Load Data → Tokens」里生成，不能复用 root 密码
- org 名称可在右上角头像 → Organizations 页面确认，别填空字符串
- 若用 Docker 启动且 Grafana 在宿主机，URL 不能写
localhost，得换成host.docker.internal或桥接 IP - 自签名 HTTPS 环境必须加
influxdb2.HTTPConfig{InsecureSkipVerify: true}，否则报x509: certificate signed by unknown authority
写进去的数据查不到？时间戳精度和截断方式错了
秒级监控指标（如 CPU 使用率、QPS）写进去却查不到，几乎全是时间戳没对齐导致的。InfluxDB 内部按纳秒索引，但 Flux 查询的 range() 和 aggregateWindow() 默认也按纳秒对齐——如果你写入的是 time.Now()（含纳秒随机值），哪怕只差几毫秒，range(start: -1m) 就可能漏掉最后一批点。
- 正确做法：用
time.Now().Truncate(time.Second)构造整秒时间戳，再传给point.SetTime() - 错误写法：
influxdb2.NewPoint("cpu", tags, fields, time.Now())—— 纳秒随机，聚合失效 - 从外部 JSON（如 Prometheus 格式）解析时间时，先
time.Parse("2006-01-02T15:04:05Z", s)，再.Truncate(time.Second) -
WriteOptions.Precision是 v1 客户端概念，v2 SDK 完全不认；时间精度全靠你传入的time.Time值决定
WriteAPI 不 flush 就退出？数据静默丢失是默认行为
WriteAPI.WritePoint() 是异步缓冲写入，不调 Flush() 或 Close()，点就一直卡在内存 buffer 里。微服务进程一退出，buffer 清空，刚采集的几百条指标就彻底消失，日志还不会报错。
立即学习“go语言免费学习笔记（深入）”；
- 程序退出前必须调
writeAPI.Flush()，并检查返回error；只看WritePoint()返回值毫无意义 - 高并发场景别每个请求都
Flush()，应复用单个WriteAPI实例，在 goroutine 里定期Flush()，或用writeAPI.Close()（会自动 flush） - 强一致性需求可设
SetBatchSize(1).SetFlushInterval(0)强制同步写，但吞吐会断崖下降 - 别用
WriteAPIBlocking上生产——它每条数据发一次 HTTP 请求，100 条 = 100 次 round-trip，扛不住真实压测
tag 设计不当比写不进去更致命：series 爆炸会拖垮整个库
把 request_id、user_ip、trace_id 这类每条都不一样的字段塞进 tag，InfluxDB 会为每个唯一组合生成新 series。10 万请求 = 10 万个 series，内存暴涨、写入延迟飙升、查询超时，最终服务假死。
- 只把低基数、高频过滤字段放
tag：如host="web01"、service="auth"、env="prod" - 原始数值指标（
latency_ms、http_status、error_count）一律进field，不建索引也没关系 - 判断标准就一条：这个字段是否常用于
WHERE或GROUP BY？取值是否少于几百个？满足才放tag - 单个 measurement 的 tag 组合总数（series 数）超过 10 万就该警觉；官方建议控制在 10 万以下
最易被忽略的其实是时间戳构造方式——不是用什么客户端，而是你传进去的那个 time.Time 值是否真的落在整秒边界。很多团队花半天排查 token 和网络，最后发现只是少了一句 .Truncate(time.Second)。
