피드로 돌아가기
Dev.toDevOps
원문 읽기
PM2 Runtime Version Mismatch 해결을 통한 VPS 배포 환경 일치화
When Your Node.js App Works Locally but Fails on a VPS
AI 요약
Context
로컬 환경과 VPS의 OS 및 Node.js 버전이 동일함에도 불구하고 배포 후 애플리케이션이 비정상 작동하는 현상 발생. 터미널의 node -v 결과와 실제 Process Manager가 사용하는 Runtime 버전의 불일치로 인한 런타임 에러가 핵심 원인.
Technical Solution
- NVM 기반의 다중 버전 관리 환경에서 PM2가 설치 당시의 전역 바이너리 경로를 유지하는 구조적 특성 파악
pm2 show및pm2 env명령어를 통한 프로세스별 실제 할당 Runtime 버전 검증nvm use이후 PM2 재설치 및--update-env옵션을 통한 프로세스 환경 변수 갱신- Ecosystem 파일 내
interpreter경로를 절대 경로로 명시하여 런타임 의존성을 하드코딩하는 결정론적 설정 도입 - Shell 환경 변수와 PM2 내부 프로세스 환경의 격리 문제를 해결하기 위한 환경 동기화 절차 수립
실천 포인트
1. `node -v` 결과와 PM2 내부 런타임 버전의 일치 여부 확인
2. NVM 사용 시 PM2 설치 전 `nvm use`를 통한 타겟 버전 활성화
3. `pm2 restart all --update-env`를 통한 환경 변수 최신화
4. 프로덕션 환경의 일관성을 위해 Ecosystem 파일에 `interpreter` 경로 명시