必须使用 influxdb-client-go/v2 官方 SDK 对接 InfluxDB 2.x，因协议层彻底变更：接口统一为 /api/v2/、认证仅支持 token；WriteAPI 默认异步且错误静默，须调 Flush() 检查；Point 时间戳不可为零值；bucket/org 名严格匹配；Flux 查询需显式 yield() 并正确处理多表结构。
influxdb-client-go/v2 是唯一能稳定对接 InfluxDB 2.x 的 Go 客户端，用 influxdb1-client 或手拼 HTTP 请求基本会卡在 401/404 —— 不是配置错，是协议层不兼容。
必须用 v2 官方 SDK，别碰 influxdb1-client
InfluxDB 2.0 彻底废弃了 v1 的 /write 和 /query 接口，所有通信走 /api/v2/，认证只认 token。用 influxdb1-client 连 2.x，哪怕 URL、token 都对，也会返回 401 Unauthorized 或 404 Not Found。
- 安装命令必须带
/v2：go get github.com/influxdata/influxdb-client-go/v2 - 初始化 client 时只传 URL 和 token，
org和bucket是写/查时才指定的参数 - URL 必须带协议（
http://或https://），末尾不能加/api/v2—— SDK 会自动补全
WriteAPI.WritePoint() 不报错 ≠ 数据已写入
WriteAPI 默认异步批量提交，错误被静默吞掉，这是最常踩的坑。点写进去没反应，十有八九是这个原因。
- 调
writeAPI.Flush()强制提交并检查返回的error，否则网络中断、token 过期、bucket 不存在都不会暴露 -
Point的时间戳不能是零值（time.Time{}），InfluxDB 直接拒收，SDK 也不校验 - 确保
bucket和org名完全匹配（大小写、下划线、连字符都算），输错一位就 404
Flux 查询返回空？先看 UI 里能不能跑通
Go 里 QueryAPI.Query() 返回空 slice 且不报错，大概率不是没数据，而是 Flux 脚本本身有问题。
- 必须显式写
|> yield()，漏了就啥也不返回 -
range()时间范围太窄（比如默认-1h），而数据在更早时间，就查不到 - 字段名含
-（如cpu-usage）必须用双引号包裹："cpu-usage"，否则解析失败 - Flux 字符串建议用反引号
`包裹，避免 Go 字符串转义干扰
Query 结果解析要过两层：table → record
Flux 返回的是多表结构（result.Tables()），每张表对应一个 tag 组合；表内才是 record 流。跳过 table 直接遍历 record 会 panic。
立即学习“go语言免费学习笔记（深入）”；
- 必须先遍历
result.Tables()，再对每个table调table.Records() -
record.ValueByKey("_value")可能为nil，需判空，否则触发interface conversion: interface {} is nil - 时间字段用
record.Time()，字段值用record.ValueByKey("xxx")，别混用record.Field()这类旧接口
