flux查询必须通过post /api/v2/query发起，带authorization token和application/vnd.flux头，响应为含元数据注释的text/csv，需跳过#行再解析；时间范围必须显式指定，token需具备目标bucket读权限。
Flux查询必须通过HTTP API发起，Go里没有原生Flux客户端
InfluxDB 2.x 不提供 Go 官方 SDK 来直接执行 Flux 查询；influxdb-client-go 库只支持写入和管理 API（如 bucket、org），不支持 query endpoint。你得自己构造 HTTP 请求调用 /api/v2/query。
常见错误是试图用 client.QueryAPI().Query()（这是 1.8 的 InfluxQL 接口，或误读文档），实际在 v2+ 的 Flux 场景下会返回空结果或 404。
- 必须用
POST /api/v2/query，Header 带Authorization: Token xxx和Content-Type: application/vnd.flux - 请求体是纯 Flux 脚本字符串，不是 JSON 封装的查询对象
- 响应是
text/csv格式（带特殊注释行），不是 JSON —— 这点极易踩坑
解析 Flux CSV 响应要跳过注释行，用标准 csv.Reader + 自定义字段映射
Flux 返回的 CSV 不是普通表格：前几行是 #group、#datatype、#default 等元数据注释，真实数据从 #, 行之后开始。直接用 csv.NewReader().ReadAll() 会把注释当数据读错。
正确做法是逐行读取，检测到 # 开头就跳过，直到遇到空行或 #, 分隔符行才开始解析数据行：
reader := csv.NewReader(resp.Body)
for {
line, err := reader.Read()
if err == io.EOF {
break
}
if len(line) > 0 && line[0] == "#" {
continue // 跳过所有 # 开头的元数据行
}
if len(line) == 0 || (len(line) == 1 && line[0] == "") {
continue // 跳过空行
}
// 此时 line 是真实数据行，例如 ["2024-01-01T00:00:00Z", "cpu", "idle", "95.2"]
}
-
#datatype行告诉你每列类型（dateTime:RFC3339、string、double），但 Go 的csv包不自动转换，需手动time.Parse()或strconv.ParseFloat() - 列顺序不固定，依赖
#group和后续表头行（通常第二行）对齐，不能硬编码索引取值 - 如果 Flux 用了
yield(name: "xxx")，表头名会变，脚本和解析逻辑需同步更新
Flux 脚本中时间范围必须显式指定，且单位要匹配
Flux 不像 SQL 那样有默认时间上下文。from(bucket: "my-bucket") 后若不加 range()，查询会失败或返回空——InfluxDB 不接受无时间范围的 Flux 查询。
典型写法：
from(bucket: "telegraf") |> range(start: -1h) |> filter(fn: (r) => r._measurement == "cpu" and r._field == "usage_idle") |> limit(n: 10)
-
start: -1h是相对 now 的偏移，start: 2024-01-01T00:00:00Z是绝对时间；两者不可混用（如start: -1h, stop: 2024-01-01T00:00:00Z会报错） - 单位必须小写：
h、m、s，写成H或hr会返回error: invalid duration - 如果查询跨天但用
-24h，而系统时区非 UTC，可能漏掉边界数据；更稳的方式是用绝对时间 +timezone参数（需服务端支持）
Token 权限不足会导致 401 或空结果，而非明确错误提示
Flux 查询走的是 /api/v2/query，它校验的是 Token 对目标 bucket 的 read 权限。即使 Token 能成功创建 client、列出 buckets，也可能因权限粒度太粗（比如只有 org 级 read:org）而查不到数据。
- 检查 Token 权限：进入 InfluxDB UI → Load Data → Tokens → 点击对应 Token → 确认有
Read/Write Permitted Buckets且勾选了目标 bucket - 测试最简 Flux：
from(bucket:"my-bucket") |> range(start:-1m) |> limit(n:1)，排除脚本语法问题 - 响应状态码是 200 但 body 为空 CSV（只有注释行），大概率是权限或 bucket 名拼写错误（注意大小写敏感）
Flux 的调试难点在于错误信息藏得深：HTTP 层没报错，CSV 里也没 error 字段，全靠人工比对 token、bucket、时间、字段名四者是否完全匹配。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
