writeapi.writepoint() 不报错不等于数据已写入，必须调用 flush() 并检查 errors()；influxdb 2.x 需严格匹配 token、org（组织名）、bucket（大小写敏感），且仅支持 v2 协议。
WriteAPI.WritePoint() 不报错 ≠ 数据已写入，这是最常被忽略的坑
连不上 InfluxDB 2.x？先确认 token、org、bucket 三者是否全部匹配
InfluxDB 2.x 完全废弃 v1 协议，influxdb-client-go/v2 是唯一稳定可用的 SDK。用错版本（比如 influxdb1-client）或手拼 HTTP 请求，大概率返回 401 Unauthorized 或 404 Not Found，不是配置问题，是协议层不兼容。
常见错误现象：
- URL 写成
"http://localhost:8086/api/v2"—— SDK 会自动补全路径，多加/api/v2导致 404 -
org填了用户名或 ID，实际要填 UI 右上角 Organizations 页面显示的 org name（大小写、下划线敏感） -
bucket名在 UI 里创建时叫my-bucket，代码里写成my_bucket或mybucket，直接 404 - token 权限没勾选对应 bucket 的 Write 权限，UI 中在 Load Data → Tokens 页面重新生成并赋权
写入后查不到数据？检查时间戳、Flush 和 Errors
WriteAPI 默认异步批量提交，WritePoint() 调用成功不代表数据已落盘，错误会被静默吞掉。必须主动触发 Flush() 并检查 Errors()。
实操建议：
- 时间戳不能为零值：
time.Time{}会被 InfluxDB 拒收；务必用time.Now().UTC()或time.Parse(...)构造有效时间再调point.SetTime() - 写完立刻调
writer.Flush()，然后立即读writer.Errors()—— 若返回非 nil error，说明这批数据根本没发出去 - 不要依赖
defer writer.Flush()，延迟执行可能在程序退出前就丢弃了缓冲区 - 批量写入时，单次
WritePoint()调用不带 error 返回，但Flush()后的Errors()会汇总所有失败点
Query 返回空 slice？Flux 脚本和迭代逻辑都得对
QueryAPI.Query() 返回的是 influxdb2.QueryTableResult 迭代器，不是数据本身。漏掉迭代步骤或 Flux 写错，都会“看似成功却拿不到数据”。
关键点：
- Flux 必须显式写
|> yield()，否则什么也不返回 - 时间范围太窄：
range(start: -1h)查不到 2 小时前的数据，改成range(start: -24h)再试 - 字段名含连字符（如
cpu-usage）必须用双引号：r._field == "cpu-usage" - Go 中拼 Flux 字符串建议用反引号：
`from(bucket:"my-bucket")|>range(start: -1h)|>yield()`，避免转义干扰 - 结果解析必须两层循环：先遍历
result.Tables()，再对每个table.Records()调Next()；跳过 table 直接遍历 record 会 panic -
record.ValueByKey("_value")可能为 nil，需判空；别用已废弃的record.Field()
批量写入性能差？别只靠默认配置
默认 WriteAPI 缓冲区小、刷新间隔长，高频写入时容易堆积或超时。性能瓶颈往往不在 InfluxDB，而在客户端配置。
调优方向：
- 改用
WriteAPIBlocking避免异步不确定性，适合调试或低频写入 - 自定义
writeAPI时传入write.OptBatchSize(500)和write.OptFlushInterval(1 * time.Second) - 并发写入别裸起 goroutine，用带缓冲 channel + worker pool 控制并发数，防内存爆涨
- 避免在循环里反复调
NewPointWithMeasurement()—— 可复用 point 实例，仅改 tag/field/time - 不用
NewPointFromStruct，反射开销大；结构体字段多时，手动AddField更快
真正卡住人的从来不是语法，而是 Flush() 没调、Errors() 没看、Flux 没 yield、time.Time 是零值——这些点不验，写一万行代码也查不到一条数据。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
