TDengine多客户端使用interval(1d)时Windows与Docker时间差8小时问题

注意：TDengine的interval时间窗口切分基准由查询生效的时区决定，和数据写入时的时区无关联，即使写入时间戳正确，查询时区不一致也会导致窗口返回时间差8小时。

排查思路 #

• 核查TDengine服务端实际生效时区：执行show variables like 'timezone'确认，部分默认部署场景下服务端会使用UTC时区，仅修改客户端时区不会改变聚合窗口的切分基准
• 核查不同客户端的TDengine连接器版本：低于2.6.0.30版本的Windows连接器存在时区解析bug，会将系统的"北京时间"标识错误识别为UTC，未做8小时偏移转换
• 对比两端返回结果的原始Unix时间戳：如果时间戳数值一致，属于客户端显示层的时区转换问题；如果数值差28800秒（8*3600），属于聚合逻辑的时区基准不一致
• 核查Docker客户端的时区配置有效性：仅配置TZ环境变量未挂载/etc/localtime文件时，TDengine客户端可能读取到的实际时区仍为UTC
• 核查查询语句是否显式指定时区参数：TDengine 2.4及以上版本支持interval(1d) timezone 'xxx'语法，未显式指定时会优先取服务端时区，部分场景下会和客户端配置冲突

解决方案 #

• 统一全链路时区配置：服务端taos.cfg配置文件中添加timezone Asia/Shanghai，重启服务生效；Docker客户端启动时添加参数-e TZ=Asia/Shanghai -v /etc/localtime:/etc/localtime:ro保证时区生效；Windows端升级TDengine连接器到2.6.0.30及以上稳定版本
• 所有interval聚合查询显式指定时区：修改查询语句为select [字段] from [表名] interval(1d) timezone 'Asia/Shanghai'，强制所有端的聚合窗口切分基准统一，不依赖各端默认配置
• 若仅需显示层面统一：在客户端初始化连接时显式传入时区参数，各类语言的官方连接器均支持该配置，强制客户端返回的时间字符串按东八区转换

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