Crontab定时PHP脚本误判停机时间的调试方法咨询

问题背景 #

在RHEL系统中配置了每5分钟执行一次的Crontab任务，运行的PHP脚本包含以下功能：

• 从MySQL获取信息
• 通过Graph API收集O365收件箱邮件
• 系统心跳邮件检查：若每小时发送的心跳邮件1.5小时内未送达则触发告警

为避免停用系统误告警，MySQL表中新增JSON字段存储停机时间，格式示例：

{
    "1":{"0":["06:50:00","07:10:00"]},
    "2":{"0":["06:50:00","07:10:00"]},
    "3":{"0":["06:50:00","07:10:00"]},
    "4":{"0":["06:50:00","07:10:00"]},
    "5":{"0":["06:50:00","07:10:00"]},
    "6":{"0":["06:50:00","07:10:00"]},
    "7":{"0":["06:50:00","07:10:00"]}
}

通过is_downtime函数结合isBetween函数判断当前时间是否处于停机时段，多数情况正常，但偶发误判（如周五16:35被判定为停机，事后用相同参数测试函数返回正常），无固定复现规律，难以调试。

调试方案 #

1. 完善关键参数日志记录 #

在is_downtime函数执行前后，强制写入独立日志文件（避免与其他日志混淆），记录以下核心信息：

• 当前毫秒级时间戳、格式化日期时间（如Y-m-d H:i:s.u）
• 从MySQL读取的原始JSON停机配置
• 解析后的停机时段数组
• isBetween函数的输入参数（当前时间、时段起止时间）
• 函数最终返回结果
• 脚本运行的时区设置（date_default_timezone_get()输出）

日志示例格式：

[2024-05-24 16:35:00.123456] TIMEZONE: Asia/Shanghai
[2024-05-24 16:35:00.123456] CURRENT_TIME: 1716549300 (2024-05-24 16:35:00)
[2024-05-24 16:35:00.123456] DOWNTIME_JSON: {"1":{"0":["06:50:00","07:10:00"]},...}
[2024-05-24 16:35:00.123456] CHECKING_PERIOD: 06:50:00 - 07:10:00
[2024-05-24 16:35:00.123456] IS_DOWNTIME_RESULT: true

下次误判发生时，可直接通过日志对比参数，定位是时间解析、配置读取还是函数逻辑的问题。

2. 校验全链路时区一致性 #

时间类偶发问题大概率与时区不一致有关：

• Crontab任务开头添加TZ='Asia/Shanghai'强制指定时区，避免与PHP脚本时区冲突
• PHP脚本开头显式设置date_default_timezone_set('Asia/Shanghai')，不依赖系统默认
• 执行SELECT @@global.time_zone, @@session.time_zone;检查MySQL时区，确保与PHP、系统时区统一

3. 覆盖边界条件的测试 #

编写单元测试用例，覆盖以下场景：

• 时段切换临界点（如07:10:00整、06:49:59、07:10:01）
• 跨天停机时段（若存在）
• 不同星期几的时段判断（验证JSON中数字与星期几的对应关系，比如"5"是否确实对应周五）
• 夏令时切换前后的时间判断（若所在时区有夏令时）

同时在脚本中加入0-59秒的随机延迟，模拟Crontab执行时的时间波动，测试是否触发误判。

4. 排查isBetween函数逻辑 #

如果isBetween是自定义函数，重点检查：

• 24小时制时间比较逻辑（比如16:35与06:50的比较是否逻辑正确）
• 字符串转时间戳时的精度丢失问题（是否忽略秒数导致误判）
• 星期索引的对应关系（部分系统星期一是0，部分是1，确认JSON中的数字与实际星期几匹配）

5. 验证MySQL JSON读取一致性 #

偶发的配置读取异常也可能导致误判：

• 读取JSON字段后，用json_last_error()检查解析是否存在错误
• 对比读取到的JSON与数据库存储的原始内容，排查字符编码或转义问题
• 考虑将JSON字段改为结构化存储（比如单独表存储星期几、时段起止时间），减少JSON解析的潜在风险

6. 监控系统时间同步状态 #

执行timedatectl status检查RHEL系统NTP服务状态，确保系统时间始终准确同步。系统时间回拨或跳跃可能导致时间判断逻辑异常。

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