QueryAPI.Query()返回空slice且err==nil，90%是Flux脚本问题：漏写|> yield()、range时间范围过窄、字段名含特殊字符未加双引号、未正确遍历result.Tables()和table.Records()。
QueryAPI.Query() 返回空 slice 且 err == nil 怎么办
这不是连接或权限问题，90% 是 Flux 查询本身没返回数据。最常见原因是漏写 |> yield() —— Flux 要求显式声明输出，不写就静默丢弃结果。
其他高频原因：
-
range(start: -1h)时间范围太窄，你的数据实际在-24h或更早，得调宽或用绝对时间戳，比如range(start: 2026-10-09T00:00:00Z, stop: 2026-10-10T00:00:00Z) - 字段名含特殊字符（如
cpu-usage）没加双引号，Flux 解析失败，应写成"cpu-usage" - Flux 字符串建议用反引号包裹：
`from(bucket:"my-bucket")|>range(start:-1h)|>yield()`，避免 Go 字符串转义干扰
遍历 result.Tables() 时 panic 怎么办
Flux 返回的是多表结构（result.Tables()），不是扁平的 record 列表。直接调 result.Records() 会 panic，因为该方法根本不存在。
正确路径必须两层遍历：
立即学习“go语言免费学习笔记（深入）”；
- 先遍历
result.Tables()，每个table对应一个 measurement + tag 组合 - 对每个
table，再调table.Records()获取 record 列表 -
record.ValueByKey("_value")可能为nil，不判空直接类型断言（如.([]interface{})）会 panic - 时间字段统一用
record.Time()，数值字段用record.ValueByKey("xxx")，别混用已废弃的record.Field()
字段名是动态的（比如来自 tag）怎么安全取值
硬编码 key（如 record.ValueByKey("temperature")）在字段名不固定时必然失败。你应该先探查结构，再取值。
推荐做法：
- 调
record.Values()拿到[]query.Value，遍历看有哪些 key 和类型 - 用
record.Table().Columns()查当前表所有列名，确认字段是否存在 - 如果字段名来自 tag（比如
host="web01"），注意它不会出现在_field中，而是作为record.Values()的一部分，key 名就是 tag 名 - 字段名含
-或空格时，ValueByKey传参也得带引号，如ValueByKey("cpu-usage")
为什么 time.UnixMilli() 写进去的数据查不到
Go 默认用毫秒，但 influxdb-client-go/v2 写入时不设精度，默认按纳秒解析。一个 1718345220000（毫秒）会被当 1718345220000 纳秒 ≈ 1.7 秒后的时间存进去，查当天数据自然为空。
解决方式只有两个：
- 写入时显式设
Precision: "ms"（WriteOptions或Point.SetPrecision("ms")） - 查询时把时间范围也对齐：Flux 中
range(start: -1h)是服务端本地时间，但如果你写入时间戳本身偏了，查的仍是错的区间 - 务必用
time.Now().UTC()构造时间，避免本地时区导致的 offset 错误
字段名、时间精度、表结构这三处最容易被跳过，但任一出错都会让查询“看起来成功，实际没数据”。
