InfluxDB 2.x 写入需配置 token 和 org，否则报 401 或 400；tag 值须为字符串，field 类型错误会导致静默丢弃；推荐用 WriteRecord 批量写 Line Protocol，注意时间戳单位为纳秒，单批≤1MB，并自行实现超时与指数退避重试。
用 influxdb2.Client 写入数据前必须配置认证和端点
不配置 token 和 org 会直接报错 401 Unauthorized 或 400 Bad Request，哪怕 URL 看起来是对的。InfluxDB 2.x 不再用用户名密码，而是靠 token 控制权限，且写入时必须显式指定所属 org（不是 bucket 名）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
token需从 InfluxDB UI 的 Load Data → Tokens 页面复制，选带Write权限的 token（推荐新建专用 token，别用默认 all-access） -
url末尾不要加/api/v2/write——influxdb2.Client会自动拼接，手动加会导致 404 -
org是组织名（字符串），不是 ID；bucket才是实际存储目标（可填名字或 ID，推荐用名字）
Point 结构体字段顺序和类型影响写入行为
InfluxDB 对字段（fields）和标签（tags）区分严格：tag 值必须是字符串，field 值可以是 string/float64/int64/bool/time.Time；写错类型会导致整条数据被静默丢弃（无错误提示，但查不到）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
influxdb2.NewPoint()构造数据点，第一个参数是 measurement 名，第二个是 tagsmap[string]string，第三个是 fieldsmap[string]interface{} - 避免在 fields 中传
nil或未导出 struct 字段 —— 会被跳过，容易误以为写入成功 - 时间戳建议显式传入：
time.Now().UTC()，不传则用服务端接收时间，可能造成时序错乱
示例：
pt := influxdb2.NewPoint(
"cpu",
map[string]string{"host": "server01", "region": "us-west"},
map[string]interface{}{"usage_idle": 99.5, "usage_user": 0.3},
time.Now().UTC(),
)
WriteAPI.WriteRecord() 比 WriteAPI.WritePoint() 更适合批量场景
单条写入用 WritePoint() 简单，但压测或高吞吐时频繁调用会触发连接复用不足、HTTP 头开销大等问题，实测 QPS 下降明显。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 批量写入优先用
WriteRecord()，把多条 Line Protocol 格式字符串一次性提交（每行一条） - Line Protocol 示例：
cpu,host=server01,region=us-west usage_idle=99.5,usage_user=0.3 1717023600000000000 - 注意时间戳单位是纳秒；若省略，服务端用当前时间；若传入毫秒，需左移 6 位（×1e6）转成纳秒
- 单次请求 body 不宜超过 1MB，否则返回
413 Payload Too Large—— 建议每批控制在 500~2000 行
超时和重试逻辑得自己补，Client 默认不重试
influxdb2.Client 的 WriteAPI 默认没有网络失败重试，遇到临时 503、DNS 解析失败或连接中断，会直接返回 error，上层不处理就丢数据。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 给
http.Client设置Timeout和MaxIdleConnsPerHost（例如 100），避免连接耗尽 - 对
WriteRecord()或WritePoint()调用做简单指数退避（如 100ms → 300ms → 1s），最多重试 3 次 - 检查 error 是否包含
"connection refused"、"i/o timeout"、"503"等关键词，再决定是否重试
真正难搞的是部分失败：一批 1000 行里有 1 行语法错（比如 tag 值含空格），整个 batch 被拒，但 error message 里不告诉你哪一行错了 —— 这时候只能降级到单点写 + 捕获 panic/log，或者预校验 Line Protocol 格式。
