真搭好了需满足：go version有输出且GO111MODULE=on；influxdb-client-go/v2用正确token、org、URL初始化；写入调WriteAPI并显式Flush()；查询必须遍历result.Next()且检查result.Err()。
go 命令能跑起来，influxdb-client-go/v2 能正常写入，才是真搭好了——其他全是中间状态。
确认 go 命令已就位且模块模式启用
很多“环境装好了但跑不起来”的问题，根源在 go 没进 PATH 或模块被静默禁用。
- 运行 go version 必须有输出（如 go version go1.22.0 linux/amd64），否则检查安装路径是否加入 PATH（Linux/macOS 看 ~/.bashrc 或 ~/.zshrc；Windows 查系统环境变量）
- 运行 go env GO111MODULE 应返回 on；若为 auto 或 off，执行 go env -w GO111MODULE=on 强制开启
- 项目根目录下不能存在 vendor/ 目录或 GO111MODULE=off 环境变量，否则 go mod init 会失效
用 influxdb-client-go/v2 连 InfluxDB 2.x 的硬性条件
别碰老库、别手拼 HTTP，官方客户端是唯一稳定路径。
- token 必须在 InfluxDB Web UI 的 Load Data → Tokens 页面创建，并勾选目标 bucket 的 Write 和/或 Read 权限
- org 参数填的是组织的 name（不是 ID），可在右上角头像 → Organizations 里核对
- URL 格式必须完整：例如 http://localhost:8086（本地开发）或 https://us-west-2-1.aws.cloud2.influxdata.com（云服务），缺协议或端口必连不上
- 初始化时传错 token 或 org，错误表现常是 401 Unauthorized 或 404 Not Found，而非网络超时
WriteAPI 写入时最容易丢数据的三个动作
批量写入不是“调一次 WritePoint 就完事”，缓冲机制不显式干预就会丢点。
- 别每条数据都调 writeAPI.WritePoint()：攒够几百上千点再统一 Flush()，否则 HTTP 开销压垮服务端
- 程序退出前必须调 writeAPI.Flush() 并检查返回 error，否则 buffer 中未发的数据直接蒸发
- 启用 WriteOptions 控制行为：例如设置 BatchSize: 1000、FlushInterval: 1000（毫秒）、ErrorCallback 捕获后台失败
Query 返回空？大概率没遍历 result.Next()
queryAPI.Query() 返回的是迭代器，不是数组或 slice。
- 必须手动循环：for result.Next() { record := result.Record(); ... }
- 每次循环后检查 result.Err()，否则查询中途出错（如字段不存在、权限不足）会被静默吞掉
- Flux 查询结果中时间戳是 record.Time()，数值是 record.Value()，别直接取 record.Values()——它返回的是原始 map，易错位
真正卡住人的从来不是“怎么连”，而是“连上了但写不进”“查不到但没报错”——这些都藏在 token 权限、时间戳精度、缓冲 flush 和迭代器遍历里。
