最可靠方式是用influxdb-client-go的QueryAPI执行Flux查询；必须带range()指定时间范围，否则返回空表；Query()返回迭代器需手动遍历table和record；参数化查询变量须加$前缀且类型严格匹配。
直接用 influxdb-client-go 的 QueryAPI 执行 Flux 查询是最可靠、最主流的方式。InfluxDB 2.x+ 已弃用 InfluxQL 查询接口，所有新项目必须走 Flux；强行用旧方式会返回 400 Bad Request 或空结果。
Flux 查询必须带 range()，否则查不到数据
这是新手踩坑最多的地方：Flux 要求每个查询都明确指定时间范围，from() 和 filter() 单独用是无效的。不加 range() 不报错，但返回空表——因为默认范围是“无”，不是“全量”。
-
range(start: -1h)表示最近 1 小时，支持-24h、-7d、2026-01-01T00:00:00Z等写法 - 生产环境别用
start: -30d这种模糊表达，应换为绝对时间戳（如start: 2026-09-10T00:00:00Z），避免时区或 DST 导致范围漂移 - 如果要查“全部历史”，仍需显式写
range(start: 0)，不能省略
QueryAPI.Query() 返回的是迭代器，不是结构体
Go 客户端不会自动把 CSV 结果转成 []map[string]interface{}，你得手动遍历 Table 和 Record。跳过这步直接打印 result 只会看到地址或空值。
- 必须用
for table := range result { ... }进入表级循环（一个查询可能返回多张逻辑表） - 每张表内再用
for record := range table { ... }遍历记录 -
record.ValueByKey("field_name")获取字段值，record.Time()拿时间戳，record.String()看原始行内容（调试用） - 别在循环里做耗时操作（如 HTTP 请求），否则阻塞整个查询流
参数化查询防注入，但变量名必须用 $ 前缀
Flux 支持参数传入，但语法和 SQL 完全不同：变量声明在查询字符串外，引用时必须带 $，且类型要匹配，否则运行时报 cannot convert string to time 这类错误。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
from(bucket:$bucket) |> range(start:$start, stop:$stop) |> filter(fn: (r) => r._measurement == $measurement) - 调用时传 map：
queryAPI.Query(ctx, flux, map[string]interface{}{"bucket": "my-bucket", "start": time.Now().Add(-1*time.Hour), "measurement": "cpu"}) - 时间类型参数必须是
time.Time，字符串会失败；字符串参数不能带多余空格，" cpu "匹配不到"cpu" - 标签（tag）值建议全小写、无特殊字符，避免 Flux 解析歧义
Flux 的管道式语法看着灵活，但一旦嵌套多层 group() + aggregateWindow()，调试难度陡增。建议先用 influx CLI 或 Chronograf 测试好 Flux 脚本，再粘进 Go 代码；别指望靠日志猜哪一层丢了字段。
