Flux 查询必须显式写 |> yield()，否则 QueryAPI.Query() 返回空 slice 且 err == nil；时间范围需匹配数据真实时间戳并截断纳秒；含连字符的字段名须加双引号；结果需两层遍历，record.ValueByKey() 需判空。
Flux 查询必须显式写 |> yield()
Go 调用 QueryAPI.Query() 返回空 slice 且 err == nil，90% 是因为 Flux 脚本漏了 |> yield()。这不是连接或权限问题，而是 Flux 语法硬性要求：没有 yield()，查询就“不输出任何表”，SDK 解析时自然拿不到 record。
- 正确写法：
`from(bucket:"my-bucket") |> range(start: -1h) |> filter(fn: (r) => r._measurement == "cpu") |> yield()` - 错误写法：
`from(bucket:"my-bucket") |> range(start: -1h) |> filter(fn: (r) => r._measurement == "cpu")`（无 yield，必为空） - 如果想指定表名，可加参数：
|> yield(name: "cpu_usage")，方便后续按名取表
时间范围写错会导致查不到数据
range(start: -1h) 默认查“最近 1 小时”，但你的数据可能落在更早时间，或写入时未对齐整秒——这两种情况都会让查询看似成功实则无结果。
- 先确认数据真实时间：用 InfluxDB UI 执行相同 Flux，看
_time字段值是否在预期范围内 - 写入端必须用
time.Now().Truncate(time.Second)设置点时间戳，否则纳秒级偏差会让range()匹配失败 - 调试时建议用绝对时间范围：
range(start: 2026-10-08T15:00:00Z, stop: 2026-10-08T16:00:00Z)，排除相对时间歧义
filter 条件里字段名含 - 必须加双引号
Flux 对标识符解析很严格。像 cpu-usage 这类带连字符的字段名，不加引号会被解析成 cpu minus usage，直接报语法错误或静默过滤失败。
- 正确：
filter(fn: (r) => r."cpu-usage" > 80)或filter(fn: (r) => r._field == "cpu-usage") - 错误：
filter(fn: (r) => r.cpu-usage > 80)（解析失败，Query() 可能返回空或 panic） - tag 名同理：
r.host == "server-01"没问题，但r.data-center == "us-east"必须写成r."data-center"
Query 结果必须两层遍历：result.Tables() → table.Records()
Flux 返回的是多表结构（比如 yield(name: "a") 和 yield(name: "b") 会生成两个表），跳过 table 层直接调 result.Records() 会 panic，因为该方法根本不存在。
立即学习“go语言免费学习笔记（深入）”；
- 必须这样写：
for table := range result.Tables() { for _, record := range table.Records() { t := record.Time() v := record.ValueByKey("_value") if v != nil { value, ok := v.(float64) if ok { // 处理数值 } } } } -
record.ValueByKey("xxx")可能返回nil，不判空直接类型断言会 panic - 别混用旧字段访问方式：
record.Field()已废弃，record.Values()适合动态字段场景
yield() 缺失和时间戳未截断，这两点会让整个查询“看起来没报错，但什么也查不到”。 
