容器下Java日志时间少8小时原因及解决

问题

在容器部署的 Java 应用中，控制台日志时间比真实时间少 8 小时，即 UTC 时间，虽然容器挂载了 /etc/localtime：

volumes:
  - /etc/localtime:/etc/localtime:ro

但日志仍然由 logback 输出为 UTC 时区。

原因

挂载 /etc/localtime 仅影响 Linux 系统层面的时区文件，而 Java 运行时（JVM）有自己独立的时区加载机制。如果 未显式指定 JVM 时区，容器中 Java 默认使用 UTC。

即使 /etc/localtime 正常，JVM 还是可能忽略系统默认时区。

1.快速验证方式（在容器里）
执行：

docker exec -it <容器ID> date

如果时间正常，再执行 Java 代码：

import java.util.TimeZone;
import java.text.SimpleDateFormat;
import java.util.Date;

public class TestTimeZone {
    public static void main(String[] args) {
        // 打印默认时区
        System.out.println("Default TimeZone: " + TimeZone.getDefault());

        // 打印原始偏移量（毫秒）
        System.out.println("Raw Offset (ms): " + TimeZone.getDefault().getRawOffset());

        // 格式化当前时间输出
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        System.out.println("Current Time: " + sdf.format(new Date()));
    }
}

java 1.java

若输出 UTC，则说明 JVM无视系统时区。

解决

1.在 docker-compose.yml 或 Kubernetes 中设置 JVM 参数：

JAVA_OPTS: "-Duser.timezone=Asia/Shanghai"

完整示例：

environment:
  - TZ=Asia/Shanghai
  - JAVA_OPTS=-Duser.timezone=Asia/Shanghai

2.如果是 Dockerfile，加入：

建议仅仅加入TZ即可解决问题

ENV TZ=Asia/Shanghai
ENV JAVA_OPTS="-Duser.timezone=Asia/Shanghai"

3.也可以在 logback-spring.xml 加入时区指定（不推荐只改这一层）：

<timestamp key="bySecond" datePattern="yyyy-MM-dd'T'HH:mm:ss" timeZone="Asia/Shanghai"/>

容器时区处理流程

flowchart TD
    A[容器启动] --> B[挂载 /etc/localtime]
    B --> C[设置 TZ=Asia/Shanghai]
    C --> D[JVM 启动加载时区]
    D --> E{是否显式配置 user.timezone?}
    E -->|是| F[Java 使用指定时区]
    E -->|否| G[Java 默认UTC]
    G --> H[日志时间偏差8小时]
    F --> I[日志时间正确]

容器挂载 /etc/localtime 不保证 Java 获取系统时区，需要同时 显式设置 -Duser.timezone 或环境变量 TZ 才能彻底避免时间偏差，达到可预测的日志输出行为。