환경

• node.js 18.20.6
• npm 10.8.2
• Windows 10 x86_64

문제 상황

$ node install node-heapdump-oom

2977 verbose lifecycle windows-build-tools@5.2.2~postinstall: CWD: C:\Users\{USER_NAME}\AppData\Roaming\npm\node_modules\windows-build-tools
2978 silly lifecycle windows-build-tools@5.2.2~postinstall: Args: [ '/d /s /c', 'node ./dist/index.js' ]
2979 silly lifecycle windows-build-tools@5.2.2~postinstall: Returned: code: 1  signal: null
2980 info lifecycle windows-build-tools@5.2.2~postinstall: Failed to exec postinstall script
2981 timing action:postinstall Completed in 1390ms
2982 verbose unlock done using C:\Users\{USER_NAME}\AppData\Roaming\npm-cache\_locks\staging-f557abd08285b88f.lock for C:\Users\{USER_NAME}\AppData\Roaming\npm\node_modules\.staging
2983 timing stage:rollbackFailedOptional Completed in 150ms
2984 timing stage:runTopLevelLifecycles Completed in 8794ms
2985 verbose stack Error: windows-build-tools@5.2.2 postinstall: `node ./dist/index.js`
2985 verbose stack Exit status 1
2985 verbose stack     at EventEmitter.<anonymous> (C:\Users\{USER_NAME}\AppData\Roaming\npm\node_modules\npm\node_modules\npm-lifecycle\index.js:332:16)
2985 verbose stack     at EventEmitter.emit (node:events:513:28)
2985 verbose stack     at ChildProcess.<anonymous> (C:\Users\{USER_NAME}\AppData\Roaming\npm\node_modules\npm\node_modules\npm-lifecycle\lib\spawn.js:55:14)
2985 verbose stack     at ChildProcess.emit (node:events:513:28)
2985 verbose stack     at maybeClose (node:internal/child_process:1091:16)
2985 verbose stack     at ChildProcess._handle.onexit (node:internal/child_process:302:5)
2986 verbose pkgid windows-build-tools@5.2.2
2987 verbose cwd C:\Users\{USER_NAME}\IdeaProjects\project
2988 verbose Windows_NT 10.0.19045
2989 verbose argv "C:\\nvm4w\\nodejs\\node.exe" "C:\\Users\\{USER_NAME}\AppData\\Roaming\\npm\\node_modules\\npm\\bin\\npm-cli.js" "install" "--global" "windows-build-tools"
2990 verbose node v18.15.0
2991 verbose npm  v6.14.18
2992 error code ELIFECYCLE
2993 error errno 1
2994 error windows-build-tools@5.2.2 postinstall: `node ./dist/index.js`
2994 error Exit status 1
2995 error Failed at the windows-build-tools@5.2.2 postinstall script.
2995 error This is probably not a problem with npm. There is likely additional logging output above.
2996 verbose exit [ 1, true ]

자주 등장하는 패키지가 windows-build-tools@5.2.2 다.

windows-build-tools 정체는 뭘까?

nodejs는 C/C++ 함수를 사용하는 API 를 제공한다.
설치하고자 하는 패키지인 node-oom-heapdump 가 C/C++ API 를 사용하는 패키지를 참조하고 있기 때문에
C/C++ API 호출을 위한 binary 파일 빌드가 필요하다.

windows-build-tools 는 C/C++ binary 파일 빌드에 필요한 패키지를 제공한다.

windows-build-tools 쓰면 안된다.

흔히 이런 솔루션이 많은데 이젠 안통한다고 봐야한다.

# 예전 솔루션
node install --global windows-build-tools

2021-01-21 을 마지막으로 더 이상 업데이트 되지 않는
Archived 된 repository다.
windows-build-tools - github

최신 버전의 nodejs, 라이브러리에선 유효하지 않다.

해결 방법

Visual Studio 설치

https://visualstudio.microsoft.com/ko/downloads/

Visual Studio Installer > 수정 > Windows 10 또는 11 SDK 설치

앞서 필요한 C/C++ Binary 빌드를 위한 패키지를 설치하는 과정이다.

SDK 설치가 필요하다.

설치 완료

$ node install node-oom-heapdump