用influxdb-client-go/v2是唯一靠谱集成方式，需正确配置token、org、URL，显式传time.Time类型时间戳，避免tag非法字符和字段类型错误，调优WriteOptions提升批量写入性能，Query需遍历result.Next()获取数据。
用 influxdb-client-go/v2 是当前唯一靠谱的集成方式，别碰老库、别手拼 HTTP 请求——丢点、没重试、时间戳错乱是常态。
连不上 InfluxDB 2.x？先查 token 和 org 配置
最常见失败不是网络问题，而是权限或名称写错。InfluxDB 2.x 要求 token 必须显式绑定到 org，并授予对应 bucket 的读写权限。
- token 在 UI 的 Load Data → Tokens 页面创建，勾选目标 bucket 的
Write（写入）和/或Read（查询）权限 -
org参数填的是 org 的 name（不是 ID），可在右上角头像 → Organizations 里确认 - URL 必须带协议和端口，例如
http://localhost:8086；若启用了 TLS，必须用https且证书有效 - 初始化示例：
client := influxdb2.NewClient("http://localhost:8086", "your-token-here")
写入时 timestamp 总被忽略？必须用 time.Time 显式传入
默认会用本地时间，但如果你需要自定义时间戳（比如设备上报时间），SetTime() 必须接收 time.Time 类型值，不能塞字符串或数字。
- 正确做法：
point.SetTime(time.Now().UTC())或从字符串解析：t, _ := time.Parse(time.RFC3339, "2026-06-12T14:30:00Z"); point.SetTime(t) - 别用
.UnixMilli()或.Unix()构造时间戳再传——InfluxDB 存纳秒级，Go 的time.Time默认精度可能被截断，导致多点时间戳冲突、后写覆盖前写 - tag 值里不能含逗号、等号、空格；字段类型要对齐：整数用
int64，别传int（32 位平台易溢出）
批量写入性能差？关键在 WriteOptions 调优
WriteAPI 默认异步缓冲，但不调优就容易吞吐低、报错漏检、内存堆积。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 推荐配置：
BatchSize: 1000（攒够千条再发）、FlushInterval: 1000（毫秒级强制刷）、ErrorCallback捕获后台错误 - 别每条都调
WritePoint()：单次写入几百上千点才调一次Flush()，否则 HTTP 开销压垮服务端 - 程序退出前务必调
writeAPI.Flush()并检查返回 error，否则 buffer 里未 flush 的数据直接丢失 - 遇到
429 Too Many Requests不是代码问题，是 bucket 写入限频触发了，得降频或升配 write limit
Query 返回空？别忘了迭代 result.Next()
queryAPI.Query() 返回的是一个迭代器，不是结果数组。不手动遍历，永远拿不到数据。
- 必须循环：
for result.Next() { record := result.Record(); ... } - 记得检查
result.Err()判断查询是否中途出错 - Flux 查询语句里
bucket名要和实际一致，大小写敏感；_measurement和 tag key 也要匹配写入时定义
真正难的不是写入或查询语法，而是 schema 设计：tag 高基数（比如用户 ID）会撑爆 series cardinality，字段类型混用会导致写入静默失败，网络中断时 buffer 溢出也得靠监控 WriteAPI.Errors() 通道才能感知。这些细节不盯紧，系统跑几天就出问题。
