必须用 influxdb-client-go/v2 连接 influxdb v2.x，因它专为 token 认证设计；旧版 influxdb1-client 仅支持 username/password，混用会导致 401 或 404 错误。
Token认证连接InfluxDB v2.x 用 influxdb2.Client 而不是旧版 driver
Go 官方推荐且唯一支持 Token 认证的 InfluxDB 客户端是 github.com/influxdata/influxdb-client-go/v2，它专为 InfluxDB 2.x / Cloud 设计。老版本的 influxdb1 client 不支持 Token 认证（只支持 username/password），强行混用会导致连接失败或 401 错误。
常见错误现象：401 Unauthorized、invalid or expired authentication credentials，多数是因为用了错的 client 包，或 Token 权限不足。
- 确认 InfluxDB 版本是 2.0+ 或 Cloud；v1.x 不支持 Token 认证（需升级或改用 Proxy + Basic Auth）
- 安装正确 client：
go get github.com/influxdata/influxdb-client-go/v2 - Token 必须有对应 bucket 的读/写权限（在 UI 的 “Load Data → Tokens” 里检查）
influxdb2.NewClient 初始化时必须传入完整 URL 和 Token
URL 格式必须带协议和端口（如 http://localhost:8086 或 https://us-west-2-1.aws.cloud2.influxdata.com），不能省略 http:// 或写成 localhost:8086 —— 否则 client 会默认拼成 http://localhost:8086 但忽略你给的 scheme，导致 TLS 错误或连接超时。
示例初始化代码：
Token 消耗追踪工具。当用户需要监控 API token 使用情况、生成每日/每周消耗报告、分析使用趋势时使用此 Skill。功能包括：自动记录每次对话的 token 消耗、生成数据表格报告、计算使用趋势和预测、支持定时推送日报。
client := influxdb2.NewClient("https://your-influx-url.com", "your-long-token-string-here")
defer client.Close()
- Token 字符串不能含前后空格（复制时容易带换行或空格，建议用
strings.TrimSpace处理） - 若用自签名证书（如本地 Docker 部署），需额外配置 HTTP client：
influxdb2.WithHTTPClient(&http.Client{Transport: &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}}) - 不建议把 Token 硬编码在代码里，应通过环境变量读取：
os.Getenv("INFLUX_TOKEN")
写入数据前必须指定 org 和 bucket，二者缺一不可
InfluxDB 2.x 的写入路径是 /api/v2/write?org=xxx&bucket=yyy，client 不会自动推导 org 名（即使只有一个 org）。如果漏传或传错，会返回 404 Not Found 或 400 Bad Request，错误信息里常含 organization not found 或 bucket not found。
写入示例：
writeAPI := client.WriteAPI("my-org-name", "my-bucket-name")
writeAPI.WritePoint(influxdb2.NewPoint("cpu", map[string]string{"host": "A"}, map[string]interface{"usage": 23.4}, time.Now()))
-
org是组织名（不是 ID），可在 UI 右上角下拉菜单看到，区分大小写 -
bucket是 bucket 名（也不是 ID），在 “Load Data → Buckets” 页面查看 - 如果 org 名含空格或特殊字符，无需 URL 编码 —— client 内部会处理
- 写入失败不会 panic，需检查
writeAPI.Errors()或启用日志：influxdb2.WithBatchSize(1)方便调试
查询数据要用 QueryAPI，Token 权限必须包含 Query 权限
Token 默认只对指定 bucket 有写权限，查数据必须显式赋予 “Read” 权限（UI 中勾选 “Query” 或 “All Buckets”）。否则 QueryAPI.Query 会静默返回空结果，或报 403 Forbidden（错误信息可能不明确）。
查询示例：
queryAPI := client.QueryAPI("my-org-name")
result, err := queryAPI.Query(context.Background(), `from(bucket:"my-bucket") |> range(start:-1h) |> filter(fn: (r) => r._measurement == "cpu")`)
if err != nil {
log.Fatal(err)
}
- 查询语句必须用 Flux 语法，不能用 InfluxQL（v1.x 语法）
-
Query返回的是迭代器，需循环result.Next()才能拿到数据；忘记循环会导致程序卡住或无输出 - 若查询返回大量点，注意内存占用 ——
result.Next()是流式读取，但每条Record仍需手动释放（调用r.Values()后可丢弃）
curl -v -H "Authorization: Token xxx" https://url/api/v2/buckets 能否列出 bucket，能通再进 Go 代码。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
