Windows11下Python influxdb-client写入InfluxDBv2自定义时间戳失败

问题描述 #

使用Python的influxdb-client向InfluxDBv2写入自定义时间戳时，Windows11环境下出现异常：要么无数据写入，要么InfluxDB中_time字段显示主机当前时间而非指定时间。相同代码在Linux环境下运行正常，Python执行无报错，尝试多种时间格式均无效。

用户代码示例：

time = local_time_to_unix(2024,5,2,4,1,1)

current_time = datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ')

print(time)

p = Point("Solar_data").tag("Project", "777").tag("Installation", 1223).field("total_consumption", 0.5 ).time('1996-02-25T21:20:00.001001231Z')

解决方案 #

1. 传入带UTC时区的datetime对象替代字符串 #

Windows和Linux对时间字符串的解析逻辑存在差异，直接传递带时区信息的datetime对象可避免跨平台解析问题：

from datetime import datetime, timezone

# 构造UTC时区的时间对象
custom_time = datetime(1996, 2, 25, 21, 20, 0, 100123, tzinfo=timezone.utc)
p = Point("Solar_data")\
    .tag("Project", "777")\
    .tag("Installation", 1223)\
    .field("total_consumption", 0.5)\
    .time(custom_time)

2. 升级influxdb-client到最新稳定版 #

旧版本客户端在Windows下存在时间解析的已知bug，升级可修复：

pip install --upgrade influxdb-client

3. 验证Point对象的序列化结果 #

写入前打印Point的Line Protocol格式，确认时间戳是否正确：

print(p.to_line_protocol())

正常输出示例：Solar_data,Project=777,Installation=1223 total_consumption=0.5 825302400001001231，末尾数字为指定时间对应的纳秒级Epoch时间。若此处时间错误，说明客户端处理异常，需升级版本。

4. 检查Windows系统时区设置 #

确保Windows系统时区配置正确，避免系统层面的时间偏移影响客户端处理。可临时切换为UTC时区测试，确认时间戳是否正常写入。

内容的提问来源于stack exchange，提问作者Piewtix