writepoint()成功仅表示入缓冲队列，必须调用flush()并检查errors()才能确认写入结果；时间戳需用settime(time.time)且精度一致；tag与field须严格区分，避免类型冲突或高基数滥用。
WritePoint()不报错但数据没进去？必须 Flush 并检查 Errors()
这是 Go 写入 InfluxDB 2.x 最常被忽略的坑：WritePoint() 成功只代表点进了缓冲队列，不代表发出去了。网络中断、token 过期、bucket 不存在等错误全被静默吞掉。
实操建议：
- 每次写完（尤其调试阶段）必须立刻调
w.Flush()，然后立即读w.Errors()—— 若返回非nilerror，说明这批数据根本没发出去 - 别依赖
defer w.Flush()：程序提前退出时，缓冲区可能直接丢弃 - 用
client.WriteAPIBlocking(org, bucket)替代默认异步 API，适合调试或低频场景；它同步阻塞、错误不掩盖 - 批量写入时，
WritePoint()单次调用不返回 error，但Flush()后的Errors()会汇总所有失败点
401 Unauthorized 或 404 Not Found？检查 token、org、bucket 三者是否全部匹配
InfluxDB 2.x 完全废弃 v1 协议，influxdb-client-go/v2 是唯一稳定 SDK。用错版本（比如 influxdb1-client）或手拼 HTTP 请求，大概率返回 401 或 404，不是配置问题，是协议层不兼容。
常见错误现象：
- 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 页面重新生成并赋权
时间戳错乱或被忽略？SetTime() 必须传 time.Time，且精度要对齐
Go 客户端默认按纳秒解析时间戳，而你传的 time.Now() 或 JSON 解析出的时间戳大概率是毫秒级。InfluxDB 不报错，但会把 1719804180000（毫秒）当成纳秒（≈54年），导致数据“消失”在时间线之外。
实操建议：
- 构造
Point时必须调用.SetTime(t time.Time)，不能只靠字段拼接或默认行为 - 从字符串解析时间（如
"2026-07-06T11:23:00Z"）时，先用time.Parse(time.RFC3339, s)得到time.Time，再传给SetTime() - 时间戳不能为零值
time.Time{}，InfluxDB 直接拒收；建议统一用time.Now().UTC() - 高频写入时，确保每个
Point的time.Time精度一致（例如都用.UTC()），避免服务端因精度混用拒绝整批
Tag 和 Field 混用或类型冲突？字段名含连字符、高基数值会静默丢点
InfluxDB 的 line protocol 要求 tag 是索引键（string），field 是值（可为 float/int/bool/string）。同一 field 名后续写入不同类型（比如先写 temp=23.5，再写 temp="unknown"）会报 field type conflict 错误，且该 series 将被锁定无法再写。
容易踩的坑：
- tag 值含非法字符（逗号、等号、空格）会导致整条写入被静默丢弃；只允许 ASCII 字母、数字、下划线、连字符
- 把高基数字段（如
request_id、trace_id、user_agent）塞进 tag，会触发 series 爆炸 —— 每条唯一组合都生成一个新 series，内存和磁盘增长呈指数级 - 字段名含连字符（如
cpu-usage）必须用双引号：r._field == "cpu-usage"，否则 Flux 解析失败 - 数值类数据一律进 field，即使它是设备 ID（如
device_id=123i）也要加i后缀标整型，否则默认当 float 存
最易被忽略的是 precision 和 tag 基数——它们不报错，但上线后查不到数据、Grafana 图表空、监控告警失灵。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
