피드로 돌아가기
Node.js 18.18.1 (LTS)
Node.js BlogNode.js Blog
Backend

Node.js 18.18.1이 18.18.0의 libuv 업데이트 회귀로 인한 Windows 파일명 처리 및 Docker 빌드 오류를 롤백으로 해결

Node.js 18.18.1 (LTS)

2023년 10월 10일3intermediate

Context

Node.js 18.18.0에서 libuv 1.45.0과 1.46.0으로 업데이트한 이후 Windows에서 특정 문자를 포함한 파일명 처리 오류, Docker 이미지 재빌드 후 'Text file busy' 에러, webpack thread-loader 호환성 문제 등 여러 회귀 버그가 발생했다.

Technical Solution

  • libuv 1.45.0과 1.46.0 업데이트를 18.18.0에서 임시로 롤백: 이전 안정적인 libuv 버전으로 복구
  • Windows 32비트/64비트 바이너리 및 설치 프로그램 배포
  • macOS Intel/Apple Silicon 바이너리 제공
  • Linux 64비트, PPC LE, s390x, ARMv7/ARMv8 바이너리 제공
  • AIX 64비트 바이너리 포함 다중 플랫폼 지원

Impact

아티클에 정량적 수치가 명시되지 않음.

Key Takeaway

주요 의존성 업데이트는 다양한 플랫폼과 워크로드에 대한 충분한 회귀 테스트를 거친 후 배포해야 하며, 문제 발생 시 빠른 롤백 능력이 안정성 유지의 핵심이다.


Node.js LTS 버전을 사용하는 프로덕션 환경에서는 마이너 버전 업데이트 후 Docker 빌드, Windows 파일 시스템 작업, webpack 번들링 등의 워크로드를 검증한 후 적용하면 예상치 못한 회귀 버그로 인한 배포 중단을 방지할 수 있다.

원문 읽기