Expo에서 'os.availableParallelism is not a function' 오류 해결하기

Expo에서 'os.availableParallelism is not a function' 오류 해결하기

 

문제 상황

오늘 Expo 프로젝트에서 npm run start 명령어를 실행했을 때 다음과 같은 에러가 발생했습니다.

TypeError: os.availableParallelism is not a function

 

원인 분석

이 오류의 원인은 Node.js 버전 호환성 문제였습니다. os.availableParallelism()은 Node.js 19 버전부터 도입된 함수인데, 저는 Node.js 18 버전을 사용하고 있었습니다.

해결 방법

Expo 깃허브 이슈(#34946)를 확인한 결과, 최신 LTS 버전의 Node.js로 업그레이드하는 것이 해결책이었습니다.

다음 명령어로 최신 LTS 버전을 설치하고 적용했습니다:

nvm install 22.14.0
nvm use 22.14.0

업그레이드 후 Expo 프로젝트가 정상적으로 실행되었습니다.

 

결론

Expo와 같은 최신 JavaScript 프레임워크를 사용할 때는 Node.js 버전 호환성에 항상 주의해야 합니다. 공식 문서나 깃허브 이슈를 확인하면 비슷한 문제를 빠르게 해결할 수 있습니다.

항상 프로젝트 시작 전에 권장 Node.js 버전을 확인하는 습관을 들이는 것이 좋겠습니다.

---

참고 자료: Expo GitHub Issue #34946

 

Expo: TypeError: os.availableParallelism is not a function · Issue #34946 · expo/expo