가장 해결이 오래걸렸던 에러

필자가 개발자가 된 이래로, 그리 긴 시간은 아니었지만 이 오류를 해결하는 데 무려 5일이 걸렸던 것 같다. 모든 방법과 구글링을 동원해보았지만 끝끝내 해결에 실패하였고, 머릿 속에 번뜩이는 아이디어 하나에 오류를 해결하였다. 이번 포스트에서는 에러가 발생했던 시점에서부터 필자가 해결하기 위한 노력들을 쭉 적어보았다.

---

상황

next js로 dev 모드에서 개발 도중, 간헐적으로 터미널창에 위 사진과 같은 오류 메세지가 출력되면서, next.js가 작동을 멈춘다. 해당 오류가 발동되는 조건, 시기, 이유 등을 알아내기 위해 지속적으로 분석해보고 계속 시도해보았지만 알아내지는 못했다. 단지 구글링에서 나오는 것은..

하지만 빈번하게 발생하는 것 치고는 짧게는 20초, 길게는 10분에 한번씩 발생하는 이 오류를 매번 로컬을 종료하고 `npm run dev` 하면서 다시 실행시킬 순 없었다. 반드시 해결하고자 하였고, 어떻게든 해결방법을 알아내고자 했다. stackoverflow나 github issue, 그리고 velog 사이트들을 통해서 나와 비슷한 에러를 직면한 사람들을 여럿 보았고, 그들에게 추천받은 방법은 다음과 같다.

1. vscode 재시작
2. npm cache clear --force 명령어를 실행하여 캐시를 강제로 비우기
3. npm cahce verfiy 명령어를 실행하여 캐시를 검사하고 손상된 것 복구하기
4. node_modules 폴더 삭제 후 재설치
5. node 버전 다운그레이드 및 최신 업그레이드
6. nextjs canary 버전으로 설치
7. .next 폴더 삭제
8. 프로젝트를 다른 폴더로 이동 후 재실행
9. 네트워크 공유기 변경
10. 컴퓨터 포맷

문제를 해결하기 위해, 위의 10가지 과정들을 거치며 시도를 해봤지만 돌아오는 것은 오류 화면이었다. 이 오류에 직면하면서 느꼈던 이상한 점은, 데스크탑 pc에서만 발생했고 개인 노트북에서는 발생하지 않았던 것이었다. 때문에 컴퓨터를 포맷하면 해결되겠지 싶어 포멧 후 재실행 해보았지만 그럼에도 해결되지 않았다. 매우 의아했던 상황이었다. next.js의 깃허브 issue 게시판에 직접 질문을 남기기도 했지만, 답이 달리진 않았다.

설마?

이대로 next.js를 접고 react로 다시 갈아타야하나 고민 도중, 갑자기 화면 우측 하단에 광고가 떴다. 며칠전에 설치한 백신 프로그램인 알약의 광고였다. 하지만 그때, 불현듯 머리에 스친 것이 있었다.

"설마 이 백신 프로그램 때문인가?"

그대로 알약을 삭제한 후 next 프로그램을 가동해보았다. 그리고 놀랍게도, 더이상의 오류는 발생하지 않았다. 그 어떠한 해결 방법을 시도해봐도 실패했었는데, 생각치도 못한 백신 프로그램이 문제였다는 것은 허탈한 사실이었다. 컴퓨터 백신 프로그램이 개발용 소프트웨어 프로그램에 예상치 못한 영향을 줄 수 있는 것일까? chat gpt에 물어보았고, 다음의 답변을 주었다.

chat gpt : 컴퓨터 백신 프로그램은 프로젝트 개발 및 빌드 프로세스에 영향을 줄 수 있습니다. 주로 실시간 파일 검사, 가짜 양성 감지, 파일 변경 추적 등으로 인해 발생할 수 있는 문제들이 있습니다. 개발 환경에서는 이러한 영향을 최소화하기 위해 몇 가지 조치를 취할 수 있습니다.

• 실시간 검사 비활성화:
  백신 프로그램 설정에서 개발 환경의 프로젝트 디렉토리를 제외하거나 실시간 파일 검사를 비활성화하는 옵션을 찾아보세요.
• 예외 규칙 추가
  백신 프로그램 설정에서 개발 환경의 프로젝트 디렉토리를 예외로 추가하여 파일 검사에서 제외할 수 있습니다.
• 특정 파일 유형 제외
  백신 프로그램이 특정 파일 유형을 실시간으로 검사하고 문제가 발생하는 경우, 해당 파일 유형을 예외로 추가하는 것도 고려할 수 있습니다.

물론 next.js도, 알약 프로그램도 모두 이 에러를 의도한 것은 아니겠지만, 아무래도 두 소프트웨어간의 알 수 없는 충돌로 에러가 발생했던 것 같다. 이 글이 널리 퍼져 나와 비슷한 오류에 직면한 사람들이 빨리 해결했으면 하는 바람이다.