Gin 不能直接写 InfluxDB 是因为它只是 HTTP 路由框架，不提供数据库驱动；必须用官方 client 库（v2 用 influxdb-client-go，v1.8 用 influxdb1-client），并注意 API 路径、鉴权方式、Point 构造规范、client 复用、上下文超时控制、批量写入配置及错误处理。
为什么 Gin 不能直接写 InfluxDB，得自己封装 client
因为 Gin 本身只是 HTTP 路由框架，不提供数据库驱动。InfluxDB 的写入必须走官方 influxdb-client-go 库（v2+），而它默认用的是 InfluxDB 2.x 的 API（/api/v2/write），不是 1.x 的 /write 端点——如果你连的是旧版 InfluxDB 1.8，influxdb-client-go 默认会报 404 Not Found 或 unauthorized，不是鉴权问题，是路径错了。
- 确认你用的是 InfluxDB 2.x（推荐）：用
influxdb-client-go+ token 鉴权，bucket和org必须传 - 如果是 InfluxDB 1.8：改用
github.com/influxdata/influxdb1-client，用username/password+database+retentionPolicy -
Gin的c.BindJSON()解析完数据后，别直接塞进WriteAPI.WritePoint()—— Point 构造失败时不会 panic，但会静默丢数据，建议加err != nil判断
如何在 Gin handler 里安全写入单条时序数据
别在 handler 里 new client，更别每次请求都 dial。client 是线程安全的，应该全局初始化一次，复用。
- 初始化放
main()或 init 函数里：client := influxdb2.NewClient("http://localhost:8086", "my-token") - 从
c.Request.Context()派生写入 context，避免 handler 超时后还往 DB 写：ctx, cancel := context.WithTimeout(c.Request.Context(), 5*time.Second) - 构造
influxdb2.Point时，measurement名不能含空格、逗号、等号；tag key/value 也同理，否则写入失败且无提示 - 示例关键片段：
point := influxdb2.NewPoint("cpu_usage", map[string]string{"host": "server-01", "region": "cn-sh"}, map[string]interface{}{"value": 87.3, "core_count": 8}, time.Now())
批量写入时怎么避免 OOM 和超时
InfluxDB 官方 client 默认开启自动 batch（1000 点 / 1s），但 Gin handler 里如果手动调 WriteAPI.WritePoint() 太频繁，buffer 会撑爆内存，尤其高并发场景。
- 显式控制 batch 行为：
writeAPI := client.WriteAPIWithOptions("my-org", "my-bucket", influxdb2.WriteOptions{BatchSize: 500, FlushInterval: 1000}) - 不要用
WriteAPI.WriteRecord()直接传原始 Line Protocol 字符串——除非你确保格式 100% 正确，否则解析失败就丢弃，还不报错 - 写入失败时，
WriteAPI.ErrorsCh()会吐出 error channel，必须另起 goroutine 消费，否则 buffer 堵死：go func() { for err := range writeAPI.ErrorsCh() { log.Printf("write error: %v", err) } }() - HTTP 超时要设在 client 层（
NewClientWithOptions的HTTPConfig），不是 Gin 的c.Timeout()
查询时为什么 timestamp 总对不上
InfluxDB 查询返回的时间戳默认是纳秒级 Unix 时间（如 1723379520000000000），Gin 返回 JSON 时若没处理，前端 JS 的 new Date() 会当成毫秒时间戳解析，快了 100 万倍。
- 查出来的
ValueAt(0)是 float64 类型的纳秒时间戳，需除以1e6转毫秒再转time.Time - 用
query.TableResult.Next()迭代时，record.Values()第一个字段通常是_time，类型是string（RFC3339 格式），比手动算安全 - 如果用 Flux 查询，记得加
|> keep(columns: ["_time", "_value", "_field"])，否则默认带一堆元数据字段，反序列化易出错
defer client.Close() 必须在程序退出前调用，否则进程无法干净终止。还有就是 InfluxDB 的 retention policy 在 v2 里叫 bucket retention，配置位置和 v1 完全不同，别按老文档去改 influx.conf。 
