[error/NestJS] npm install 패키지 설치 시 Cannot read properties of null (reading 'matches') 에러

◾에러 파악하기

✔️Background

cron 기능을 NestJS(NodeJS) 에서 사용하기 위해 npm install @nestjs/schedule 명령어를 통해 설치를 시도하였다.

✔️에러 발생 상황

그런데 패키지가 설치가 되지 않고, 다음과 같은 에러가 발생했다.
이 패키지에 국한된 문제는 아니고, 그 외에도 npm install 시 가끔 발생하는 에러라고 한다.

PS D:\workspace\apple_server> npm install @nestjs/schedule
npm ERR! Cannot read properties of null (reading 'matches')

npm ERR! A complete log of this run can be found in: C:\Users\user\AppData\Local\npm-cache\_logs\2025-12-05T06_30_33_139Z-debug-0.log

◾에러 해결하기

🔨시도1 : 캐시 초기화

PS D:\workspace\apple_server> npm cache clean --force
npm WARN using --force Recommended protections disabled.

깨진 캐시 때문에 이런 일이 발생하기도 한다고 해서 npm캐시를 완전 초기화 하는 명령어를 실행해보았다.

이렇게 캐시를 지우고, 다시 설치 명령어를 실행해보았으나 같은 에러가 발생했다.

🔨시도2 : node_modules와 package-lock.json 제거 (성공)

두 번째는 package-lock.json파일과 node_modules 폴더를 삭제 후 재설치 하는 것이다. 시간은 조금 걸릴 수 있지만 확실한 방법이다.

• package-lock.json 파일, node_module폴더 삭제

rm -rf node_modules package-lock.json 
npm install

이렇게 삭제하고 재설치를 진행한 후, 필요한 패키지를 설치해보니 정상적으로 설치되었다!

참고로 버전 불일치 때문에 위와 같은 에러가 일어나기도 한다고 한다. 나의 경우 캐시 삭제는 해결되지 않았고, 노드 모듈 폴더와 락 파일 삭제가 효과가 있었다.