Apache IoTDB插入时序数据时时间戳始终为起始时间的原因及调整方法

核心原因分析 #

你遇到的问题本质是时间戳单位不匹配：IoTDB默认以毫秒作为时间戳的解析单位，若你传入的是秒级时间戳（比如500000这类数值），会被当作毫秒解析，对应到1970年附近的早期时间，也就是你看到的1970-01-20T23:40:41.335+08:00。

具体修复步骤 #

1. 转换时间戳单位适配默认配置

如果你的原始时间戳是秒级，直接乘以1000转成毫秒后再写入，示例代码（Java客户端）：

// 错误写法：传入秒级时间戳
session.insertRecord("root.test.device1", 1690000000, new String[]{"temp"}, new Object[]{25.5});
// 正确写法：转成毫秒单位
session.insertRecord("root.test.device1", 1690000000 * 1000, new String[]{"temp"}, new Object[]{25.5});

如果是微秒/纳秒级时间戳，需对应转换为毫秒（微秒÷1000，纳秒÷1000000）。

2. 修改IoTDB全局时间戳单位（可选）

若业务统一使用非毫秒单位（比如秒），可修改iotdb-engine.properties配置文件：

• 找到timestamp_precision配置项，将默认值ms改为s（秒）、us（微秒）或ns（纳秒）
• 重启IoTDB服务后生效

3. 写入时指定时间戳单位（部分客户端支持）

部分客户端允许写入时直接指定单位，示例代码（Python客户端）：

from iotdb.Session import Session
session = Session("127.0.0.1", 6667, "root", "root")
session.open(False)
# 指定时间戳单位为秒
session.insert_record("root.test.device1", 1690000000, ["temp"], [25.5], timestamp_precision="s")
session.close()

4. 验证写入结果

执行查询语句确认时间戳是否正常：

SELECT * FROM root.test.device1 LIMIT 10;

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