JSON解析后字段类型不匹配导致InfluxDB写入失败：timestamp需用time.Parse转为time.Time，fields值须手动判断类型并转为float64/int64/bool，不可直传interface{}；measurement必填且需清洗非法字符，tags必须为map[string]string，批量写入需调大HTTP超时、控制批次大小并校验UTF-8。
JSON解析后字段类型不匹配，写入InfluxDB失败
Go写InfluxDB最常卡在这步：JSON里的"timestamp"是字符串，"value"可能是数字或字符串，但InfluxDB的WritePoint要求时间必须是time.Time，数值字段必须是float64、int64或bool。直接用json.Unmarshal进map[string]interface{}再强转，容易panic——比如把"123"当float64转，实际是string类型。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 定义结构体显式声明字段类型，比用
map[string]interface{}更安全，例如：type Metric struct { Measurement string `json:"measurement"` Tags map[string]string `json:"tags"` Fields map[string]interface{} `json:"fields"` Timestamp string `json:"timestamp"` } -
Timestamp字段解析后用time.Parse转成time.Time，别依赖InfluxDB自动解析；常见格式如"2024-05-20T14:23:11Z"对应time.RFC3339 -
Fields里每个值手动判断类型：v, ok := val.(float64)、val.(int64)、val.(string)再转——InfluxDB不接受json.Number或interface{}直传
用influxdb-client-go写入时point构造易出错
官方influxdb-client-go v2+不支持直接传map，必须用client.WriteAPI配合influxdb2.NewPoint逐个构造。很多人漏掉measurement名或把tags和fields位置弄反，导致数据写进去了却查不到。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
measurement是必填项，且不能含空格、等号、逗号、换行符；建议提前用strings.TrimSpace清洗 -
tags必须是map[string]string，非字符串值（如int）要先fmt.Sprintf转；fields支持string/float64/int64/bool，但同名字段不能混类型 - 构造
Point时，时间参数传time.Time，不要传int64纳秒戳——除非你明确调用WithTime并确认单位 - 示例关键片段：
p := influxdb2.NewPoint( metric.Measurement, metric.Tags, metric.Fields, t, // t 是 time.Time 类型 )
批量写入JSON数据时连接和超时配置被忽略
单条写入看着没问题，一跑批量就丢点或报context deadline exceeded——根本原因是默认HTTP客户端超时只有5秒，而InfluxDB服务端批量接收、索引、持久化需要时间，尤其字段多或QPS高时。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 初始化
client.NewClient时，必须自定义http.Client，把Timeout设为至少30秒：httpClient := &http.Client{ Timeout: 30 * time.Second, } client := influxdb2.NewClientWithOptions(url, token, influxdb2.DefaultOptions().SetHTTPClient(httpClient)) - 用
WriteAPIBlocking而非WriteAPI，避免goroutine泄漏；若坚持用非阻塞API，必须调用Flush并检查Errors() - 每批次控制在1000–5000个point之间；超过会触发InfluxDB的
max-body-size限制（默认25MB），报413 Request Entity Too Large
中文tag或field值写入后查询乱码或过滤失效
InfluxDB本身支持UTF-8，但Go客户端对URL编码和header处理不透明，如果tag值含中文，直接塞进map[string]string再写入，可能被错误编码或截断，导致WHERE tag = '中文'查不到。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不对tag/field值做额外URL编码——
influxdb-client-go内部已处理；只需确保原始字符串是合法UTF-8（utf8.ValidString(s)可校验） - 避免在tag中使用高频率变动的值（如用户ID带中文名），tag应尽量简短、静态；高频变动内容放
fields里 - 查询时，CLI或Flux中用双引号包裹中文值：
filter(fn: (r) => r._field == "温度" && r.设备 == "服务器A")；SQL模式下需加ESCAPE或改用参数化查询
InfluxDB对point的schema是弱约束，但字段类型一旦写错（比如该是float64写了string），后续同名field再写其他类型就会静默失败——这点非常隐蔽，得靠influx bucket schema命令或查看_field_keys系统表确认。
