需用 v2 SDK、token+org+bucket 认证，写入后必须调 Flush() 并检查 Errors() 捕获错误，Query 前先在 UI 验证 Flux 语法与时间范围，避免 NewPointFromStruct 反射开销。
怎么用 Go 连上 InfluxDB v2 并写入数据
InfluxDB v2 默认关闭了 v1 兼容 API，直接套用老教程会连不上或报 404 Not Found。必须用 v2 的 token + org + bucket 三元组认证，不能只靠地址+端口。
实操建议：
- 用官方 SDK：
github.com/influxdata/influxdb-client-go/v2，别用已归档的v1包 -
token要在 InfluxDB UI 的 Load Data → Tokens 里生成，权限至少含对应bucket的 Write - 初始化 client 时，
url必须带协议（如"http://localhost:8086"），末尾不加/api/v2—— SDK 会自动拼 - 写入前先确认
org（不是用户名）和bucket（不是数据库名）存在，否则报404 not found
示例关键片段：
client := influxdb2.NewClient("http://localhost:8086", "your-token-here")
writeAPI := client.WriteAPI("my-org", "my-bucket")
p := influxdb2.NewPoint("cpu", map[string]string{"host": "A"}, map[string]interface{}{"usage": 99.9}, time.Now())
writeAPI.WritePoint(p)Query 查询返回空结果？检查 Flux 语法和时间范围
Go 里用 QueryAPI.Query() 执行 Flux 脚本，但返回空不是因为没数据，大概率是 Flux 写错了或时间没对上。
立即学习“go语言免费学习笔记（深入）”；
常见错误现象：
- 查不到数据，但
influx write命令能写进去 → Flux 中from(bucket: "...")的 bucket 名大小写/下划线错了一位 - 返回
nil或空 slice，没报错 → Flux 脚本里漏了|> yield()，或者range()时间范围太窄（默认只查最近 1h） - 字段类型不匹配，比如把
int当float用 → Flux 不隐式转换，r._value * 1.0才行
实操建议：
- 先在 InfluxDB UI 的 Data Explorer 里跑通 Flux，再复制到 Go 代码中
- Flux 字符串必须用双引号，变量名不能含
-（cpu-usage要写成"cpu-usage"） - Go 中拼 Flux 字符串时，用反引号
`包裹，避免转义问题
为什么 WriteAPI.WritePoint() 不报错但数据没出现
WriteAPI 默认异步批量提交，出错不会立刻抛 panic 或 error，而是静默丢弃。这是最常被忽略的坑。
原因和对策：
- 网络不通、token 过期、bucket 不存在 → 错误被吞进内部 buffer，需主动调
writeAPI.Flush()并检查返回 error - 点的时间戳为零值（
time.Time{}）→ InfluxDB 拒收，但 SDK 不校验，写入失败无提示 - 字段值含
nil或未导出 struct 字段 → 序列化后字段消失，点变空，写入成功但无意义
务必在写完后加：
writeAPI.Flush()
if err := writeAPI.Errors(); err != nil {
log.Fatal("write error:", err) // 这里才能捕获真实错误
}struct 转 Point 性能差？别用 NewPointFromStruct
influxdb2.NewPointFromStruct() 看起来方便，但每调用一次都反射遍历字段，压测下 CPU 占用明显升高，不适合高频写入（如 >1k 点/秒）。
更优做法：
- 手写
NewPoint()，字段名和值都硬编码，零反射开销 - 如果结构体固定，提前建好
map[string]interface{}模板，运行时只更新值 - 批量写入时，复用同一个
Point实例（调p.Reset()），避免频繁分配
注意：InfluxDB 对单点字段数有限制（默认 256），字段过多会导致写入失败且错误信息模糊，建议控制在 50 以内。
