go连接influxdb 2.x必须使用influxdb2.client（v2官方库），因v1客户端端点路径（如/write）和认证方式（token强制）与v2（/api/v2/write）完全不兼容，混用会导致404或401错误；初始化传基础url即可，token需readwrite权限且bucket/org须预先存在；写入须正确管理writeapi生命周期（flush/close），避免静默丢失；tag用于索引（高频过滤字段），field存数值，顺序无关但语义不可颠倒；query必须用flux语法（from→range等），非sql，且需流式遍历result.next()解析。
Go连接InfluxDB 2.x必须用influxdb2.Client，别碰v1的influxdb.Client
Go里老项目常混用v1和v2客户端，结果写入失败还报错404 Not Found或401 Unauthorized——根本不是鉴权问题，是端点地址和协议完全不兼容。InfluxDB 2.x废弃了v1的HTTP API路径（如/write），改用/api/v2/write，且强制要求token认证。
实操建议：
- 用官方库
github.com/influxdata/influxdb-client-go/v2，不是v1或无v2后缀的旧版 - 初始化时传
http://localhost:8086即可，不用手动拼/api/v2/...前缀 -
token必须是ReadWrite权限的API token（在UI的Data > Tokens里生成），不能用用户名密码 - bucket和org名区分大小写，且必须已存在——客户端不会自动创建
写入数据前务必调用WriteAPIBlocking或正确管理WriteAPI生命周期
直接用client.WriteAPI("my-org", "my-bucket")返回的是异步写入接口，若不显式调用Flush()或等Close()，程序退出时缓冲区里的点可能丢失。常见现象：本地跑一次能写入，部署到容器里就“静默失败”。
实操建议：
- 短周期采集（如每秒1次）用
WriteAPIBlocking更稳妥：client.WriteAPIBlocking("my-org", "my-bucket")，它会同步阻塞直到服务端确认 - 高频写入（如每毫秒）才用
WriteAPI，但必须在采集循环外统一defer api.Close()，并在退出前api.Flush() - 别在每次写点都新建
WriteAPI实例——开销大且连接复用失效
构造Point时Tag和Field别写反，否则查询时查不到
InfluxDB按Tag建索引、按Field存值。把设备ID当Field写进去，后面用WHERE device_id = 'abc'就永远为空——因为device_id没被索引。
实操建议：
- 高频过滤字段（如
host、sensor_id、region）全放Tag；数值类（temperature、cpu_usage）放Field - Go里用
point.AddTag("host", "server-01")和point.AddField("temp", 23.5)，顺序无关，但语义不能颠倒 - Tag值别含空格或特殊字符，否则Flux查询会报
invalid identifier；实在要带空格，得用双引号包裹："tag with space"
Query用Flux语法，不是SQL，且queryAPI.Query返回的是流式Result
写惯SQL的人容易在Query里写SELECT * FROM cpu WHERE time > now() - 1h，结果err为nil但result.Next()始终false——Flux不认SQL关键字。
实操建议：
- Flux脚本必须以
from(bucket: "...")开头，时间过滤用|> range(start: -1h) -
queryAPI.Query(ctx, fluxScript)返回*influxdb2.Result，需循环result.Next()+result.Table()解析，不是一次性取数组 - 如果只查单个值（比如最新温度），加
|> last()并确保result.Next()调用一次后检查result.Err()，否则可能漏错
Tag和Field的边界、Flux的流式迭代、v2客户端的生命周期管理——这三处不细看文档就容易卡半天。实际部署时，先用curl手工发一个点验证bucket和token，再让Go代码跑起来，比对着日志猜快得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
