Node.js In-process Cron의 런타임 안정성 확보 및 Race Condition 해결 전략

Context

node-cron 기반의 In-process 스케줄링 도입 시 발생하는 프로세스 크래시 및 상태 손실 문제 분석. 단일 스레드 기반 Node.js 환경에서 예외 처리 미흡으로 인한 전체 서비스 중단과 작업 중복 실행에 따른 데이터 정합성 훼손 가능성 식별.

Technical Solution

• Unhandled Exception으로 인한 프로세스 종료 방지를 위해 try-catch 기반의 Safe Wrapper 함수 도입
• Server Local Time 의존성 제거를 위한 explicit Timezone 설정 및 UTC 오프셋 계산 적용
• 작업 실행 시간과 주기 불일치로 인한 Overlapping Run 방지를 위해 File-based Lock 메커니즘 설계
• 프로세스 재시작 시 작업 누락 방지를 위한 File-system 기반의 Last Run State 영속화 구조 구현
• Graceful Shutdown 로직을 통한 SIGTERM 수신 시 진행 중인 Task의 안전한 정지 및 프로세스 종료 처리
• systemd Service 설정을 통한 프로세스 자동 재시작 및 Production 환경의 가용성 확보