生产环境下node-cron定时任务未执行问题求助

根据你描述的现象——本地正常、生产环境仅短周期（每分钟）任务正常，长周期任务当天执行后次日失效或延迟任务不执行，结合o2Switch+Cpanel的Node.js部署特性，给出以下排查和解决思路：

核心原因分析 #

你的应用大概率是通过Cpanel的Passenger模块托管的，Passenger作为应用进程管理器，存在进程回收/休眠机制，同时应用级的node-cron依赖主进程存活，一旦主进程被重启或进入休眠（即使API请求看似正常，可能是Passenger快速唤醒进程，但定时任务的调度会被中断），就会导致长周期任务失效。另外，时区配置不一致、日志输出不可靠也可能是诱因。

具体解决方案 #

1. 改用Cpanel系统级Cron Jobs替代node-cron（最可靠方案） #

应用级定时任务受进程生命周期影响，系统级Cron完全独立于应用进程，稳定性更高：

• 创建独立的任务脚本（比如/home/你的用户名/public_html/scripts/run-cron-task.js），把原来的定时任务逻辑移进去，确保脚本可以独立运行（直接执行node run-cron-task.js测试）；
• 登录Cpanel，找到「Cron Jobs」工具：
  • 选择时区为Europe/Paris（先在Cpanel设置里确认全局时区，或手动转换时间到服务器时区）；
  • 添加Cron命令：node /home/你的用户名/public_html/scripts/run-cron-task.js；
  • 设置时间规则为00 20 * * *（对应巴黎时间每天20点）。

2. 调整Passenger进程休眠设置（坚持用node-cron的话） #

需确保Passenger不会中断主进程的持续运行：

• 进入Cpanel的「Setup Node.js App」，找到你的应用点击「Edit」；
• 在「Passenger Application Pool」设置中，将「Idle Timeout」改为0（禁用自动休眠），同时调大「Max Requests」值，避免因请求量触发进程重启；
• 重启Node.js应用使设置生效。

3. 验证时区一致性 #

• 登录服务器终端（Cpanel的「Terminal」工具），执行date命令查看系统时区是否为Europe/Paris；
• 如果服务器是UTC时区，需确认node-cron的时区转换是否正确：比如巴黎时间20点对应UTC18点，可临时把定时任务改为00 18 * * *测试是否执行；
• 升级node-cron到最新版本（执行npm install node-cron@latest），旧版本存在时区解析bug。

4. 优化日志记录，确认任务真实执行状态 #

生产环境console.log的输出可能未被捕获到日志，改为写入文件验证：

// scripts/myscript.js
const cron = require('node-cron');
const fs = require('fs');
const logPath = '/home/你的用户名/cron-task-logs.txt';

const script = cron.schedule('00 20 * * *', async () =>  {
    const logContent = `[${new Date().toLocaleString('fr-FR', {timeZone: 'Europe/Paris'})}] 任务执行成功\n`;
    fs.appendFileSync(logPath, logContent, {encoding: 'utf8'});
},
{
    scheduled: true,
    timezone: "Europe/Paris"
});

script.start();

执行后查看日志文件，确认任务是真的未执行，还是日志输出未被捕获。

5. 检查应用进程重启记录 #

进入Cpanel的「Setup Node.js App」，点击应用的「Logs」按钮，查看是否有进程重启的记录（比如Passenger因资源限制或服务器自动维护重启进程），如果存在，需联系o2Switch客服调整服务器进程配置。

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