必须使用官方 influxdb-client-go/v2 库连接 InfluxDB 2.0，因其仅支持 /api/v2/ 接口和 token 认证；Flux 查询须通过 QueryAPI.Query 执行，时间范围需显式指定，结果需两层遍历解析 record；写入时精度由 WriteOptions.Precision 控制，Point 时间字段须为 time.Time 类型。
Go 连接 InfluxDB 2.0 必须用官方 client v2，别碰 influxdb1-client
InfluxDB 2.0 完全弃用了 HTTP API v1，所有写入/查询都走 /api/v2/，认证也换成 token 而非用户名密码。用 influxdb1-client 或自己拼 http.Post 请求，大概率返回 404 Not Found 或 401 Unauthorized —— 不是因为配置错，而是协议层就不通。
实操建议：
- 必须用官方库：
github.com/influxdata/influxdb-client-go/v2（注意末尾/v2） - 初始化时传入 URL、token 和 org 名，
bucket不是连接参数，是后续写/查时指定的 - token 权限要够：至少有
read:orgs/{org-id}/buckets/{bucket-id}才能查，write:orgs/{org-id}/buckets/{bucket-id}才能写
示例关键行：
client := influxdb2.NewClient("http://localhost:8086", "your-token-here")<br>defer client.Close()
Flux 查询不能直接用 string 拼接，得走 QueryAPI.Query
很多人以为 Flux 是“类 SQL”，想用 fmt.Sprintf 拼查询语句再 POST，结果要么报 invalid character，要么字段名被转义丢数据。Flux 是表达式语言，对缩进、引号、时间字面量敏感，且 Go client 要求把整个 Flux 脚本当纯文本提交，但必须由 QueryAPI.Query 封装执行，不能手撸 HTTP 请求。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 用
client.QueryAPI(org)获取查询实例，再调Query(ctx, fluxScript) - Flux 脚本里的时间范围必须显式写，比如
range(start: -1h)，不能依赖服务端默认值 - 避免在 Flux 中硬编码 bucket 名；推荐用参数占位：
from(bucket: params.bucket) |> range(start: params.start)，然后用QueryOption注入
示例 Flux 片段：
flux := `from(bucket: "my-bucket")<br> |> range(start: -1h)<br> |> filter(fn: (r) => r._measurement == "cpu")<br> |> last()`
Query 结果解析容易漏掉 table / record 层级，导致 panic
Flux 返回的是多表结构（哪怕只有一张），每张表对应一个 series + tag 组合，表内才是 record 流。直接循环 result.Tables() 却忘了调 table.Records()，或者误以为 record.ValueByKey("_value") 总是非 nil，就会触发 panic: interface conversion: interface {} is nil。
实操建议：
- 必须两层遍历：
for _, table := range result.Tables() { for _, record := range table.Records() { ... } } -
record.ValueByKey()返回interface{}，需类型断言，如v, ok := record.ValueByKey("_value").(float64) - 时间字段是
record.Time()，不是record.ValueByKey("_time")—— 后者可能为 nil 或格式异常
写入数据别用 Point.Precision，用 WriteAPI.WriteRecord 配置 time precision
Point 构造时设 Point.Precision 是个常见误区。这个字段在 client v2 中已被忽略，真正起作用的是 WriteAPI 初始化时传的 influxdb2.WriteOptions 里的 precision 参数。不设或设错，会导致时间戳被截断成秒级（即使你传了纳秒时间），查出来全是整点数据。
实操建议：
- 写入前明确时间精度需求：IoT 场景通常用
influxdb2.Nanosecond，日志类可用influxdb2.Millisecond - 通过
client.WriteAPIWithOptions(org, bucket, influxdb2.WriteOptions{Precision: influxdb2.Nanosecond})创建写入实例 - Point 时间字段必须是
time.Time类型，不要传 int64 纳秒值 —— client 会自动按 precision 转换
Flux 的语法自由度高，但 Go client 对错误反馈很“安静”：查不到数据不报错，只返回空结果；token 权限不足可能静默跳过某张表。调试时务必先用 influx cli 或 Chronograf 手动跑同一段 Flux，确认脚本能返回预期数据，再回 Go 里对接 —— 这步省不得。
