树莓派Node.js应用setInterval定时任务随机停止问题求助

基础问题场景 #

• 硬件运行环境为树莓派，开发的Node.js应用核心功能为每5分钟遍历预设URL列表，发送HTTP请求采集对应页面数据
• 核心定时逻辑代码：

setInterval(iterateItems,(1000*60*5),urlsList);

• 采用的后台启动命令：nohup node index.js > ~/logs/scraper.txt &
• 故障表现：应用可稳定连续运行3-4小时后突然终止进程；已确认业务代码本身无已知逻辑报错，进程退出时日志无任何错误堆栈输出，使用nohup启动也未解决该问题

排查方向与对应解决方案 #

系统层面排查 #

• 优先排查OOM（内存溢出）导致的内核杀进程问题：树莓派普遍内存容量偏低，若应用存在HTTP响应对象未释放、全局数据列表无限制累积的内存泄漏问题，系统触发内存阈值时会直接通过OOM Killer终止占用内存最高的进程，这一过程不会在应用自身的日志中留下任何错误记录。
  • 排查操作：执行dmesg | grep -i "out of memory"，若能匹配到故障时间点附近node进程被终止的记录，即可确认是内存不足被系统强制终止。
  • 对应优化：每次采集任务执行完成后，主动清理无用的临时缓存、HTTP响应对象，必要时通过Node.js启动参数--max-old-space-size设置合理的内存占用上限，避免无限制占用系统内存。
• 排查系统资源限制：查看系统日志/var/log/syslog中故障时间点的记录，确认是否存在cgroup资源配额限制、用户级进程运行时长阈值等配置，触发限制后系统会自动终止后台进程。

Node.js运行时排查 #

• 增加全局异常兜底捕获：由于已初步确认iterateItems内部的业务代码无已知报错，这类静默退出的问题大多是运行时层面的错误没有被捕获。Node.js进程遇到未捕获的同步异常、未处理的Promise拒绝时，会直接触发退出流程，在未配置全局错误监听的场景下，错误信息可能不会输出到指定的日志文件。
  • 优化操作：在应用入口文件最开头增加错误捕获逻辑，将所有未捕获的异常写入独立的错误日志：

const fs = require('fs')
process.on('uncaughtException', (err) => {
  fs.appendFileSync('./logs/runtime_error.log', `[${new Date().toLocaleString()}] 未捕获同步异常: ${err.stack}\n`)
})
process.on('unhandledRejection', (reason) => {
  fs.appendFileSync('./logs/runtime_error.log', `[${new Date().toLocaleString()}] 未处理Promise错误: ${reason}\n`)
})

• 排查定时器回调的错误扩散：给setInterval绑定的iterateItems函数外层增加try/catch包裹，确保单次任务执行中出现的边界场景错误不会扩散到Node.js运行时层面，导致整个进程退出。
• 排查HTTP请求资源泄漏：给所有发出的HTTP请求设置合理的超时时间，请求结束后主动释放socket连接资源，避免大量挂起的连接占用文件描述符上限，导致进程无法正常执行后续操作而静默退出。

运行方式优化 #

• 替换现有nohup的启动方式：nohup仅能保证进程不被终端挂断信号终止，既没有进程崩溃后的自动重启能力，也没有完善的异常监控能力，遇到进程意外退出时需要人工手动拉起。
  • 可通过Linux系统自带的systemd托管应用，配置进程退出自动重启、日志自动收集规则，从运行机制上降低进程异常退出带来的影响。

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