WriteAPI.WritePoint()不报错≠数据已写入，因默认异步机制会静默吞掉网络中断、token过期、bucket不存在等错误；必须调writeAPI.Flush()强制提交并检查error，且Point时间戳不能为零值，org和bucket名须大小写精确匹配。
WriteAPI.WritePoint() 不报错 ≠ 数据已写入，必须调 writeAPI.Flush() 检查错误；QueryAPI.Query() 返回空不等于没数据，大概率是 Flux 脚本漏了 |> yield() 或时间范围不对。
为什么 WritePoint() 总是静默失败
默认异步写入机制会把点攒批发出去，网络中断、token 过期、bucket 不存在等错误全被吞掉，不抛 panic，也不返回 error。你看到的“成功”只是进队列了。
-
writeAPI.Flush()是唯一能强制提交并暴露真实错误的操作，每次写完（尤其调试阶段）必须加 - 点的时间戳不能是零值
time.Time{}，InfluxDB 直接拒收，SDK 不校验，也没提示 - 使用
WriteAPIBlocking可绕过异步陷阱，适合小规模或调试场景，但别在高并发采集里长期用——它会阻塞 goroutine - 确保
org和bucket名完全匹配：大小写、下划线、连字符都算，输错一位就是 404
Flux 查询总为空？先看 UI 能不能跑通
Go 里 QueryAPI.Query() 返回空 slice 且 err == nil，90% 是 Flux 本身问题，不是连接或权限故障。
- 必须显式写
|> yield()，漏了就啥也不返回——这是最常被忽略的语法硬性要求 -
range(start: -1h)默认只查最近 1 小时，而你的数据可能在更早时间，改成range(start: -24h)或具体时间戳再试 - 字段名含
-（如cpu-usage）必须用双引号包裹："cpu-usage"，否则 Flux 解析失败 - Flux 字符串建议用反引号
`包裹，避免 Go 字符串转义干扰，比如`from(bucket:"my-bucket")|>range(start:-1h)`
Query 结果解析必须过两层：table → record
Flux 返回的是多表结构，不是扁平 record 列表。跳过 table 层直接遍历 record 会 panic，因为 result.Records() 不存在。
- 正确路径：先遍历
result.Tables()，再对每个table调table.Records() -
record.ValueByKey("_value")可能为nil，不判空直接类型断言会 panic - 时间字段统一用
record.Time()，数值字段用record.ValueByKey("xxx")，别混用已废弃的record.Field() - 如果字段名是动态的（比如来自 tag），别硬编码 key，先用
record.Values()看结构
初始化 client 和 writeAPI 的参数别传错位置
URL 和 token 是 client 初始化时传的，org 和 bucket 是写/查时才指定——这个分离设计容易搞混。
立即学习“go语言免费学习笔记（深入）”；
- client 初始化只接受两个参数：
influxdb2.NewClient("http://localhost:8086", "your-token")，末尾不能带/api/v2，协议必须写全（http://或https://） -
writeAPI := client.WriteAPI("my-org", "my-bucket")，这里my-org是组织名，不是用户名；my-bucket是 bucket 名，不是数据库名 - token 必须在 InfluxDB UI 的 Load Data → Tokens 页面生成，权限至少勾选对应 bucket 的 Write/Read
- 别用
influxdb1-client或手拼 HTTP 请求连 2.x，协议层彻底不兼容，401/404 不是配错了，是根本走不通
