如何退出Node.js脚本使Kubernetes Job被判定为已完成

核心原因说明 #

process.exit(0)执行后Job未标记完成的问题，90%以上的场景是两类原因导致：

1. Docker容器启动时用shell模式运行Node进程，Node退出后作为PID1的shell进程没有退出，导致容器持续运行
2. Node进程退出前仍持有未释放的IO句柄、异步任务、网络连接，导致进程实际未完全终止

正确实现步骤 #

• 第一步：修正Dockerfile启动指令为exec模式
  不要使用shell模式的启动写法：

  # 错误写法：会用sh作为父进程启动Node，sh不会转发退出信号
  CMD node index.js
  

  替换为exec模式写法，让Node进程直接作为容器PID1进程：

  # 正确写法
  CMD ["node", "index.js"]
  

• 第二步：退出前清理所有持有的资源
  调用process.exit(0)之前必须完成所有资源清理：

  // 示例清理逻辑
  async function shutDown() {
    // 1. 关闭数据库连接
    await dbClient.close()
    // 2. 停止HTTP服务
    await new Promise(resolve => httpServer.close(resolve))
    // 3. 清空所有定时器
    for (const id of timerList) clearInterval(id)
    // 4. 等待所有 pending 异步任务完成
    await Promise.all(pendingTasks)
    // 最后再执行退出
    process.exit(0)
  }
  

• 第三步：匹配Kubernetes Job的退出码规则
  任务正常完成固定返回0退出码：process.exit(0)，任务执行失败需要Job重试的场景返回非0退出码，比如process.exit(1)

额外排查项 #

如果完成上述配置后问题仍存在，按顺序排查：

• 检查Job的spec.completions配置，默认值为1，如果你配置为N，则需要N个Pod全部成功退出才会标记Job完成
• 执行kubectl describe pod <对应Pod名>检查Pod是否存在sidecar容器未退出的情况，比如服务网格、日志采集sidecar持续运行会导致整Pod无法终止
• 检查KEDA的缩容触发器配置，确认触发器关联的是Job的完成状态指标

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