Node.js(Express.js)定时永久函数本地正常Heroku免费服务器异常问题

核心场景 #

• 需求：在Node.js(Express)中实现一个每50秒永久运行的定时函数，本地用nodemon运行正常，但部署到Heroku免费服务器后无法工作。
• 疑问：该函数能否在Heroku上持续运行？
• 问题：本地执行正常，Heroku免费环境下运行出错。

出错原因拆解 #

1. 日期变量作用域错误 #

now、startdate、enddate在全局作用域初始化，仅在应用启动时计算一次。后续每次执行DynamicDate都会复用旧的日期值，导致逻辑完全偏离预期（比如过了一天后，startdate还是启动当天的前一天）。

2. Heroku免费版休眠限制 #

Heroku免费dyno会在30分钟无请求后进入休眠状态，休眠期间所有定时任务都会暂停，直到有新的HTTP请求唤醒应用，这是免费版的硬性限制。

3. 未处理异步异常 #

DynamicDate是异步函数，但setInterval不会捕获它抛出的错误。一旦出现数据库连接失败、变量未定义等异常，任务会静默崩溃且无法自动恢复。

4. 缺失变量导入 #

代码中使用了ObjectId但未显式导入，本地可能因其他模块间接导入而不报错，但Heroku环境下会直接抛出ReferenceError。

疑问解答：能否持续运行？ #

• Heroku免费版：无法持续运行，30分钟无请求就会休眠，定时任务随之中断，需外部请求唤醒。
• Heroku付费版：可以持续运行，付费dyno无自动休眠机制，定时任务能稳定执行。

修复方案 #

1. 修正日期变量作用域 #

将日期计算移到DynamicDate函数内部，确保每次执行都使用最新日期：

const DynamicDate = async () => {
  // 每次执行重新计算日期
  const now = moment().format('L');
  const startdate = moment().subtract(1, "days").format('L');
  const enddate = moment().add(4, "days").format('L');
  
  console.log("任务运行中，当前日期：", now);
  // 后续逻辑...
}

2. 捕获异步错误 #

给异步函数添加错误捕获，避免任务静默失败：

const DynamicDate = async () => {
  try {
    const now = moment().format('L');
    const startdate = moment().subtract(1, "days").format('L');
    const enddate = moment().add(4, "days").format('L');
    
    console.log("任务运行中，当前日期：", now);
    const hospitaldoctorsCollection = client.db(process.env.DB).collection('hospitaldoctors');
    const doctors = await hospitaldoctorsCollection.find({}).toArray();
    
    for (const doctor of doctors) {
      const doctorAvialableSlot = doctor.availableSlots;
      if (doctorAvialableSlot[startdate] !== undefined) {
        delete doctorAvialableSlot[startdate];
        doctorAvialableSlot[enddate] = availableSlots;
        
        const filter = { _id: ObjectId(doctor._id) };
        const updateDoc = { $set: { availableSlots: doctorAvialableSlot } };
        await hospitaldoctorsCollection.updateOne(filter, updateDoc, { upsert: true });
        console.log(`已更新医生${doctor._id}的时段`);
      } else {
        console.log(`医生${doctor._id}的时段已处于最新状态`);
      }
    }
  } catch (err) {
    console.error("定时任务执行失败：", err);
    // 可在此添加告警逻辑（如邮件通知）
  }
}

3. 补全缺失导入 #

显式导入ObjectId：

// 根据你使用的驱动选择对应导入方式
const { ObjectId } = require('mongodb');
// 若使用Mongoose：const ObjectId = require('mongoose').Types.ObjectId;

4. 应对Heroku免费版休眠（可选） #

如果必须使用免费版，可通过外部定时服务（如UptimeRobot）每隔25分钟发送一次HTTP请求到你的应用，防止休眠。先在Express中添加健康检查路由：

app.get('/health', (req, res) => {
  res.status(200).send('OK');
});

再配置外部服务定时访问该路由，保持应用唤醒。

5. 优化定时任务（可选） #

用setTimeout替代setInterval，避免前一次任务未完成就启动新实例：

const runTaskLoop = async () => {
  await DynamicDate();
  // 前一次任务完成后，再设置下一次定时
  setTimeout(runTaskLoop, 50000);
}

// 启动任务循环
runTaskLoop();

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