Go连接InfluxDB 2.x必须用官方influxdb-client-go（v2.8+），因其支持token鉴权、bucket定位和Flux查询；使用influxdb1-client会因API路径和认证不兼容导致401/404错误。
Go连接InfluxDB 2.x必须用官方influxdb-client-go，别碰influxdb1-client
InfluxDB 2.x彻底弃用了v1的HTTP API路径和认证方式，用influxdb1-client会卡在401或404——它默认发请求到/query，而2.x只认/api/v2/write和/api/v2/query。官方influxdb-client-go（v2.8+）才真正支持token鉴权、bucket定位和Flux查询。
实操建议：
- 初始化客户端时，
url必须带协议和端口（如"http://localhost:8086"），漏掉http://会导致connection refused -
token不能是UI里随便复制的“API Token”，得是all-access权限的token，否则写入时返回error code 403: forbidden -
org和bucket参数必须严格匹配InfluxDB中创建的名称，大小写敏感，空格也不行
写入监控点要用WriteAPI.WriteRecord，不是WriteAPI.Write
直接调WriteAPI.Write传[]byte容易出错：它要求手动拼接Line Protocol，字段类型、转义、时间戳格式稍有偏差就静默丢弃数据（无报错但查不到）。用WriteRecord让SDK自动处理编码更稳。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
- 写入后
influx bucket list能看到数据，但from(bucket: "...") |> range(start: -1h)查不到——大概率是time字段没设或设成了0 Unix时间 - 字段值含空格或逗号却没用双引号包裹，Line Protocol解析失败
正确写法示例：
point := influxdb2.NewPointWithMeasurement("cpu_usage").
AddTag("host", "server-01").
AddField("value", 87.3).
SetTime(time.Now()) // 必须显式设置，否则默认为0
WriteAPI.WriteRecord(context.Background(), point)查监控数据优先用QueryAPI.Query，别用QueryAPI.QueryRaw
QueryAPI.QueryRaw返回原始响应体，你需要自己解析CSV或JSON——但InfluxDB 2.x默认返回的是带header的CSV，字段顺序不固定，且null值用NULL字符串表示，极易解析错。而QueryAPI.Query返回flux.Table结构，按列名取值，容错强。
使用场景注意：
- 查最近5分钟平均值，Flux语句里
range(start: -5m)比range(start: 0)安全，后者可能因时区或服务器时间偏差漏数据 - 聚合函数如
mean()默认对_value字段操作，如果你的field名不是value，得先用rename(columns: {"my_field": "_value"}) - Query调用必须
defer result.Close()，否则goroutine泄漏，跑几天后内存暴涨
监控打点高频写入要开batch，关autoFlush
每秒打点10次以上时，如果每次WriteRecord都立即发HTTP请求，会迅速耗尽socket连接，出现dial tcp: lookup localhost: no such host或大量context deadline exceeded。SDK默认开启autoFlush（1s刷一次），但对监控场景太慢。
实操建议：
- 初始化WriteAPI时传
influxdb2.DefaultOptions().SetBatchSize(100).SetFlushInterval(100 * time.Millisecond) - batch size别设太大（如1000+），否则单次HTTP payload超2MB触发InfluxDB默认限制，返回
413 Payload Too Large - 进程退出前务必调
WriteAPI.Flush()，否则最后一批缓存数据丢了
时序数据的精度和可靠性，往往卡在写入路径的细节里——比如一个没设的SetTime()，或一个没close的result，系统跑两天后才暴露问题，排查成本远高于写的时候多加两行代码。
