[General] Nx CLI 오류: The Nx CLI could not find or load the native binary for your supported platform (win32-ia32) 해결 방법

Nx CLI를 실행하는 과정에서 다음과 같은 오류가 발생했습니다.

The Nx CLI could not find or load the native binary for your supported platform (win32-ia32).

이 오류는 Nx CLI가 실행 환경에 맞는 네이티브 바이너리를 찾지 못할 때 발생합니다. 특히, Windows 운영 체제에서 32비트 버전의 Node.js가 실행될 경우 이 문제가 나타날 수 있습니다.

문제 원인 분석

1. 먼저, nvm list 명령어를 실행하여 사용 중인 Node.js 버전을 확인했습니다.
2. 출력된 Node.js 버전은 정상적으로 보였지만, 운영 체제에서 32비트 기준의 Node.js를 사용하고 있었습니다.
3. 결과적으로, Nx CLI가 올바른 바이너리를 찾지 못해 실행되지 않았습니다.

해결 방법

1. 기존 Node.js 버전 삭제

우선, 현재 설치된 Node.js 버전을 삭제해야 합니다.

• NVM을 사용 중이라면 다음 명령어를 실행하여 특정 버전을 제거할 수 있습니다.예를 들어, 사용 중인 버전이 16.20.0이라면 다음과 같이 실행합니다.
• nvm uninstall 16.20.0
• nvm uninstall <버전>
• 만약 직접 설치한 Node.js라면 제어판 > 프로그램 제거에서 삭제합니다.

2. 운영 체제에 맞는 Node.js 버전 재설치

내 운영 체제가 64비트인지 확인한 후, 올바른 버전을 다시 설치해야 합니다.

(1) 운영 체제 확인 방법

Windows에서 실행:

wmic os get osarchitecture

만약 64-bit가 출력된다면, 64비트 Node.js를 설치해야 합니다.

(2) 올바른 Node.js 버전 설치

• NVM을 사용하는 경우:예를 들어, 16.20.0 버전의 64비트 Node.js를 설치하려면 다음과 같이 실행합니다.
• nvm install 16.20.0 64 nvm use 16.20.0
• nvm install <버전> 64 nvm use <버전>
• 공식 사이트에서 직접 설치하는 경우:
  1. Node.js 공식 사이트에서 64비트 설치 파일을 다운로드합니다.
  2. 설치 후, node -v로 정상적으로 버전이 출력되는지 확인합니다.

3. Nx CLI 실행 확인

Node.js를 올바르게 설치한 후, Nx CLI를 다시 실행하여 오류가 해결되었는지 확인합니다.

nx --version
nx serve

저는 위 과정을 통해 정상적으로 Nx CLI를 실행할 수 있었습니다. 만약 같은 오류가 발생한다면 node_modules를 삭제하고 다시 설치하는 방법도 시도해볼 수 있습니다.

rm -rf node_modules package-lock.json
npm cache clean --force
npm install