直接用 influxdb.client 连不上 docker 启的 influxdb，大概率是版本错配或鉴权参数没对上——不是代码写错了，是 client 库和 influxdb 实例的协议不匹配。确认你跑的是 influxdb v1 还是 v2：docker 中 latest 镜像在 2026 年已指向 v2.x，而 v1（如 1.8）用 username/password 鉴权、无 token；v2 强制使用 token + 非空 org + bucket。验证方式：curl -i http://localhost:8086/ping，响应头含 x-influxdb-version: 1. 为 v1，含 x-influxdb-version: 2. 或 x-influxdb-build: oss 为 v2。v1 客户端应使用 github.com/influxdata/influxdb1-client/v2，传 httpconfig{addr: "http://influxdb:8086"}；v2 必须用 github.com/influxdata/influxdb-client-go/v2，初始化时传 token，并通过 writeapi("org", "bucket") 显式指定 org 和 bucket，org 不可为空。docker compose 环境下 go 客户端地址须填服务名（如 http://influxdb:8086），
直接用 influxdb.Client 连不上 Docker 启的 InfluxDB，大概率是版本错配或鉴权参数没对上——不是代码写错了，是 client 库和 InfluxDB 实例的协议不匹配。
确认你跑的是 InfluxDB v1 还是 v2
Docker 里默认拉的镜像名不带版本号时（比如 docker run influxdb），实际拉的是 latest，而 latest 在 2026 年已指向 v2.x。但很多旧项目仍用 influxdb:1.8 或 influxdb:1.9，它们用的是 InfluxQL + username/password；v2 则强制用 Flux + token + org。
快速验证方法：
- 执行
curl -I http://localhost:8086/ping - 如果响应头含
X-Influxdb-Version: 1.→ 是 v1 - 如果含
X-Influxdb-Version: 2.或X-Influxdb-Build: OSS→ 是 v2
Go 代码连 Docker 启的 v1（如 influxdb:1.8）
v1 的 Go client 不认 token，只认 username、password 和 database 参数；且 HTTP 地址末尾不能带 /api/v2 这类路径。
正确做法：
- 导入
github.com/influxdata/influxdb1-client/v2 - 用
client.NewHTTPClient，传client.HTTPConfig{Addr: "http://influxdb:8086"}（注意：Docker 内部通信用服务名，不是 localhost） - 写入前先调
c.CreateDatabase("mydb")（v1 没有自动建库） - 点数据必须带
time字段，否则会被丢弃；建议显式设p.Time(time.Now().UTC(), time.Nanosecond)
示例片段：
bp, _ := client.NewBatchPoints(client.BatchPointsConfig{Database: "mydb"})
pt, _ := client.NewPoint("cpu", map[string]string{"host": "srv-01"}, map[string]interface{}{"usage": 42.5}, time.Now().UTC())
bp.AddPoint(pt)
c.Write(bp)
Go 代码连 Docker 启的 v2（如 influxdb:2.7）
v2 的 client 必须带 token 和非空 org，哪怕只有一个 org；且 token 必须从 UI 或 CLI 创建，不能复用 root 密码。
关键点：
- 导入
github.com/influxdata/influxdb-client-go/v2 - 初始化 client 时传
influxdb2.NewClient("http://influxdb:8086", "your-token-here") - 调
client.WriteAPI("my-org-name", "my-bucket")，org 名必须和 UI 中「Load Data → Tokens」页显示的一致（区分大小写） - 写入 Point 时，时间戳必须是纳秒级整数：
point.Timestamp(time.Now().UTC().UnixNano(), time.Nanosecond)；用time.Now().Unix()会导致同秒内数据被覆盖 - 别用
WriteAPIBlocking()做高频写入，改用WriteAPI()并设置WriteOptions.BatchSize(500).FlushInterval(1000)
Docker Compose 网络下 client 怎么填地址
Go 应用若也跑在 Docker 里（比如用 docker-compose up 启动），就不能写 localhost:8086 —— 那是容器自己的 loopback，不是宿主机的。
必须用服务名：
-
docker-compose.yml 里 InfluxDB 服务叫
influxdb，Go 客户端就填http://influxdb:8086 - 确保两个服务在同一个 network 下（默认
docker-compose创建的 network 是互通的） - 启动顺序要控制：Go 服务加
depends_on: [influxdb]，但注意这只是启动顺序，不保证 InfluxDB 已 ready；建议加健康检查或启动时 ping/ping接口重试
最容易忽略的是：v2 的 org 参数为空字符串会静默失败，日志只报 400 Bad Request，不提示缺 org。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
