统一所有服务时区为UTC是最直接有效的解决方式，通过容器环境变量、时区挂载、应用层时间对象规范、日志采集展示时区中立及验证机制实现全链路时间对齐。
统一所有服务的时区为 UTC 是最直接有效的解决方式，避免因本地时区差异造成日志时间戳无法对齐、排查困难的问题。
所有服务容器强制使用 UTC 时区
在 docker-compose.yml 中为每个服务显式设置环境变量和时区配置，不依赖基础镜像默认行为：
- 添加 TZ=UTC 环境变量（部分 Java/Node.js 应用会读取）
- 挂载宿主机的 /etc/timezone 和 /usr/share/zoneinfo/UTC（或直接复制 UTC 文件）
- 对于 Alpine 镜像，需额外安装 tzdata 包，并通过 ENV TZ=UTC + RUN ln -sf /usr/share/zoneinfo/UTC /etc/localtime 固化时区
应用层日志时间戳统一生成逻辑
避免依赖系统默认 new Date() 或 LocalDateTime.now()，改用明确带时区的时间对象：
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- Java：使用 ZonedDateTime.now(ZoneOffset.UTC) 或 Instant.now() 记录日志
- Go：用 time.Now().UTC()，日志库（如 zap）启用 EncodeTime(time.RFC3339Nano)
- Python：用 datetime.now(time.UTC)（3.12+）或 datetime.utcnow().replace(tzinfo=timezone.utc)
日志采集与展示环节保持时区中立
ELK、Loki、Datadog 等平台默认可能按本地时区解析时间字段，需主动约束：
- Filebeat / Fluentd 配置中指定日志时间字段的时区为 UTC（如
timezone: "UTC"） - Grafana 查询日志时，确认数据源时间范围使用的是 UTC，面板右上角时区设为 Browser 或 UTC，而非自动检测
- 确保日志中的时间字段是 ISO8601 格式且含 Z 后缀（如
"2024-06-15T08:23:45.123Z"），而非无时区的"2024-06-15 08:23:45"
验证与持续保障机制
上线前后必须验证各服务实际输出的时间是否一致：
- 进入容器执行 date 和 cat /etc/timezone，确认输出为 UTC
- 触发一次跨服务调用，在日志中比对关键 trace ID 对应的各服务时间戳，偏差应在毫秒级（非分钟级）
- CI 流程中加入检查项：扫描 docker-compose.yml 是否遗漏
TZ=UTC，或构建阶段是否执行了时区设置命令
