必须使用influxdb-client-go/v2连接InfluxDB 2.x，因其原生支持token认证、org/bucket模型和Line Protocol；旧版influxdb1-client不兼容，即使开启兼容API也会因认证、路径、格式差异而失败。
Go连接InfluxDB 2.x要用influxdb-client-go，不是influxdb1-client
直接用老的 influxdb1-client 会连不上 InfluxDB 2.x（哪怕开了兼容 API），因为认证、路径、数据格式全变了。必须用官方维护的 influxdb-client-go（v2+ 版本），它原生支持 token 认证、org/bucket 模型和 Line Protocol 写入。
安装命令是：
go get github.com/influxdata/influxdb-client-go/v2
常见错误现象：
• 报错 401 Unauthorized —— 没传 token 或 token 权限不足
• 报错 404 Not Found —— 用的 client 初始化方式还是 v1 风格，比如误传 database 名而非 bucket 名
• 写入后查不到数据 —— 忘了指定 org，或 org 名拼写与 InfluxDB UI 中不一致
写入数据前必须明确 bucket、org 和 precision
InfluxDB 2.x 没有 database 和 retention policy 的概念，而是用 bucket（含内置 retention）和 org 做两级隔离。写点（Point）时，bucket 和 org 是必填参数；precision（如 ns、ms）决定时间戳精度，默认是纳秒，但如果你用 time.Now() 直接写，没问题；如果从字符串解析时间，没设对 precision 会导致时间错乱。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 创建 bucket 时记下它的 exact name（区分大小写），不要依赖默认生成的 ID
-
org可以是 org 名或 org ID，推荐用 org 名（更可读），但必须和 InfluxDB 中完全一致（包括空格） - 写入单条数据用
WriteAPI.WritePoint()，批量用WriteAPI.WriteRecord()或WriteAPI.WritePoints()，后者内部会自动 batch，但要注意点数组不能超 1000 条/次，否则可能被 server 拒绝
构造 Point 要避免字段类型冲突
InfluxDB 对同一 field key 强制要求类型一致（比如第一次写 value=123（int），第二次就不能写 value=123.0（float）），Go client 不做运行时校验，冲突会导致写入静默失败或报 400 Bad Request 并提示 field type conflict。
正确做法：
- 所有数值字段显式调用
Point.AddField()并匹配 Go 类型：整数用int64，浮点用float64，布尔用bool，字符串用string - 避免把 JSON 解出来的
interface{}直接塞进 field —— 它可能是float64即使原始是 int，导致后续类型漂移 - tag 值只能是 string，传其他类型（如 int）会 panic，client 不转换
示例：
pt := influxdb2.NewPoint("cpu",<br> map[string]string{"host": "server01", "region": "us-west"},<br> map[string]interface{}{"usage_idle": 90.5, "usage_user": 5},<br> time.Now())这里 usage_idle 是 float64，usage_user 是 int，但 client 会自动转成 float64 写入 —— 实际上这不是安全行为，最好统一显式转成 float64。
查询数据得用 Flux，不是 SQL，且要处理响应流
InfluxDB 2.x 查询接口只接受 Flux 脚本，返回的是逐行 streaming 的 ND-JSON。Go client 提供 QueryAPI.Query()，但它返回的是 flux.TableIterator，不是 []struct。你得手动遍历 table → row → value，不能期望像 ORM 一样直接 decode。
容易踩的坑：
- 忘记调用
iter.Next()就直接iter.Table()，结果 panic - 字段名带下划线（如
_time、_value）是系统字段，业务字段在record.ValueByKey()里取，别硬解 JSON - 没 close iterator，导致 HTTP 连接泄漏（client 不自动关）
- Flux 脚本里漏写
|> yield()，查询无输出但也不报错
最简可用查询脚本：
from(bucket: "my-bucket")<br> |> range(start: -1h)<br> |> filter(fn: (r) => r._measurement == "cpu")<br> |> yield(name: "last_hour")
真正麻烦的是类型推导和字段一致性 —— InfluxDB 不强制 schema，但 client 一旦遇到同一 field 在不同行出现不同类型，就会跳过那行，还不会报错。调试时得开 InfluxDB 日志或用 CLI 手动查 raw response。
