大家好，我是大华！

最近把 XXL-Job 定时任务迁移到新服务器时，遇到了一个让人困惑的问题：任务设置在上午10点执行，但执行调度和执行却显示晚上18点。经过排查，发现问题根源是 A 服务器的时间少了8个小时 ！

所有任务执行时间都多了8小时，如图：

问题分析

执行时间线

1.我设置的时间 ：10:00（我以为的北京时间） 2.A 服务器理解的时间 ：10:00 UTC（相当于北京时间18:00） 3.触发任务 ：A 服务器在 UTC 时间10:00向 B 服务器发送请求 4.B 服务器接收时刻 ：北京时间18:00（UTC 10:00 + 8小时） 5.执行任务 ：北京时间18:00

解决方案：修复A服务器时间 #后端

第一步：检查B服务器时区配置

登录 B 服务器，执行以下命令：

# 查看当前时间和时区

date timedatectl

# 预期正确输出（北京时间）：

# Wed May 15 10:00:00 CST 2024

# 错误输出示例：

# Wed May 15 02:00:00 UTC 2024

第二步：修正B服务器时区

CentOS/RedHat 系统：

# 设置时区为上海

timedatectl set-timezone Asia/Shanghai

# 验证设置

date

Ubuntu/Debian 系统：

# 交互式设置时区

sudo dpkg-reconfigure tzdata

# 选择 Asia -> Shanghai

第三步：确保时间同步

# 安装并配置NTP时间同步

yum install -y ntp # CentOS

sudo apt-get update # Ubuntu

# 验证当前时间状态

timedatectl status

# 确认为Time zone: Asia/Shanghai (CST, +0800)

第四步：验证B服务器配置

虽然问题主要出在 A 服务器，但确保环境一致性很重大：

# 在A服务器上也执行同样的检查

date timedatectl

确保 B 服务器也使用 Asia/Shanghai 时区。

最后必定要记得重启定时任务。

在XXL-Job管理界面中确认

登录 XXL-Job Admin 管理后台，查看调度日志：

1.调度时间 ：反映 A 服务器（调度中心）的触发时间 2.执行时间 ：来自 B 服务器（执行器）上报的时间

修复前后对比：修复前 ：调度时间 10:00，执行时间 18:00 修复后 ：调度时间 10:00，执行时间 10:00

实践提议

1.环境标准化

• 所有服务器统一使用 Asia/Shanghai 时区
• 使用一样的时间同步服务

2.日志规范

• 在业务日志中明确输出时区信息
• 思考使用UTC时间存储日志，展示时按需转换

总结

这个问题本质上是一个环境配置一致性问题。在分布式系统中，时间一致性是常常被忽视却又至关重大的基础配置。XXL-Job 作为一个优秀的分布式任务调度框架，其本身的时间机制是清晰的，问题往往出目前环境配置层面。

下次当你发现定时任务执行时间对不上时，第一检查服务器的时区和时间同步配置，这可能会为你节省大量的排查时间。

本文首发于公众号：程序员刘大华，专注分享前后端开发的实战笔记。关注我，少走弯路，一起进步！

扩展阅读：

《SpringBoot+Vue3 整合 SSE 实现实时消息推送》

《这20条 SQL 优化方案，让你的数据库查询速度提升10倍》

《SpringBoot 动态菜单权限系统设计的企业级解决方案》

《Vue3 + ElementPlus 动态菜单实现：一套代码完美适配多角色权限系统》