influxdb 1.x 和 2.x 写入需区分版本：1.x 用 /write?db=xxx + 基础认证，2.x 用 /api/v2/write?org=xxx&bucket=xxx + token 认证；时间戳须统一精度（推荐纳秒+无单位），避免“未来时间”或远古时间；建议优先使用 influxdb-client-go 并启用 writeapiblocking 调试。
用http.Client发POST请求写入数据最直接
InfluxDB 2.x 默认关闭了兼容的 InfluxDB 1.x HTTP API，如果你连的是 2.x，必须用 Token + 组织/桶（org/bucket）参数；1.x 则走 /write 端点、靠数据库名和认证。别一上来就套模板，先确认版本：curl -s http://localhost:8086/ping 返回 204 是 2.x，带 X-Influxdb-Version 头的是 1.x。
Go 里最轻量的做法就是用标准库 http.Client 构造请求：
- 1.x：URL 为
http://host:port/write?db=mydb&precision=s，Body 是行协议文本，Header 设Content-Type: text/plain - 2.x：URL 为
http://host:port/api/v2/write?org=myorg&bucket=mybucket&precision=s，Header 加Authorization: Token your-token-here和Content-Type: text/plain; charset=utf-8 - 注意：2.x 的
precision参数只影响时间戳解析（如s表示秒级），不改变写入精度；时间字段若没带单位，默认按纳秒处理，容易写错成“未来时间”
influxdb-client-go 库能省掉手动拼 URL 和错误重试
官方维护的 influxdb-client-go 封装了认证、序列化、批量写入和自动重试逻辑，比裸写 http.Client 更稳。但它默认开启异步写入（WriteAPI），出错不会立刻返回——调试时容易误以为写成功了。
关键配置点：
- 初始化时传入
influxdb.Config{URL: "http://...", Token: "...", Organization: "...", Bucket: "..."}，Token 必须有写权限（2.x）或用户密码（1.x 兼容模式） - 同步写法用
WriteAPIBlocking，调用WritePoint()会阻塞并返回 error，适合调试和小流量场景 - 异步写法下，
Flush()才真正触发发送，且Errors()channel 需要单独 goroutine 消费，否则错误会被丢弃 - 批量大小建议设为 1000~5000 点，太小吞吐低，太大可能触发 InfluxDB 单次请求体限制（默认 10MB）
写入失败常见错误信息和对应动作
HTTP 层面的报错往往藏在响应 Body 里，不是简单看 status code。比如 400 Bad Request 可能是字段类型冲突，401 Unauthorized 是 Token 过期或权限不足，429 Too Many Requests 是写入速率超限（2.x 默认每秒 1000 点）。
典型错误及处理：
-
"error":"field type conflict"：同一 field 名在不同 point 用了不同类型（比如一会 int 一会 string），InfluxDB 不允许隐式转换，得统一预处理 -
"error":"unable to parse"：行协议格式错，常见于 tag 值含空格没加双引号、measurement 名含非法字符（如.或-）、时间戳多了一个ns后缀 -
"error":"authorization failed"：2.x 中 Token 对应的 org/bucket 不匹配，或该 Token 没绑定写权限（需在 UI 或 CLI 里显式授予WriteData权限） -
context.DeadlineExceeded：客户端超时，但服务端可能已接收部分数据，建议配合幂等写入（如加idtag）或用Retry-After响应头做退避
时间戳处理不当会导致数据“消失”或乱序
InfluxDB 默认按时间戳排序，但 Go 的 time.Now().UnixNano() 返回纳秒，而行协议中若不显式指定精度（如 1712345678901234567ns），InfluxDB 会按纳秒解析；如果用 Unix() 得到秒值却没加 s 单位，就会被当成纳秒，写进一个远古时间点。
安全做法：
- 统一用
t.UnixNano()生成时间戳，并在行协议末尾加1712345678901234567（不带单位），让 InfluxDB 按纳秒解析 - 或者显式控制精度：用
t.Unix()+s单位，URL 参数也设precision=s，避免歧义 - 不依赖客户端本地时间——尤其跨时区服务，建议从 NTP 同步后生成时间戳，或让 InfluxDB 用服务器时间（省略时间字段，服务端自动打时间戳）
时间字段一旦写错，查不到数据时别急着查查询语句，先用 influx query 或 Chronograf 查最近写入的 raw point，确认时间戳是否落在预期范围内。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
