개발 도중 Cursor의 Chat 기능을 잘 사용하고 있었는데, 어느 순간부터 창이 응답하지 않습니다라는 팝업과 함께 기능이 멈춰버렸습니다. 프로그램을 껐다 켜도, 심지어 PC를 재부팅해도 문제는 그대로였습니다. 반복되는 무한 로딩, 일시적인 장애로 넘기기엔 작업 흐름이 완전히 끊기게 되었습니다.
이 글에서는 해당 이슈의 증상부터 원인, 그리고 우리가 적용한 해결 방법을 순서대로 정리해 보았습니다.
문제 상황: 끝나지 않는 Chat 로딩
처음에는 단순히 응답 지연이겠거니 했습니다. 하지만 시간이 지나도 Chat 탭은 아무 반응이 없고, 아래와 같은 시스템 팝업이 반복적으로 나타났습니다.
창이 응답하지 않습니다. 창을 다시 열거나, 닫거나, 계속 기다릴 수 있습니다.
→ 다시 열기를 눌러도 상태는 동일했습니다.
이 현상은 특정 프로젝트나 상황에서 반복적으로 발생할 수 있으며, 일정 조건에서 Cursor의 Chat 기능이 정상 작동하지 않는 문제로 이어졌습니다.
처음에는 단순한 일시적 오류로 생각해 프로그램을 재시작하고, 시스템을 재부팅하는 등의 일반적인 대응을 시도했습니다. 하지만 문제는 재현 가능했고, 같은 프로젝트를 열 때마다 동일한 증상이 반복되었습니다.
원인 추정: 임시 저장소(workspaceStorage) 충돌
Cursor에서 프로젝트 상태나 편집 기록 등은 workspaceStorage라는 경로에 임시로 저장됩니다.
이 폴더에 저장된 데이터가 손상되거나 충돌하는 경우, Cursor 내부의 상태 머신이 초기화되지 못하고 무한 로딩 루프에 빠지는 것으로 보였습니다.
사실 이 문제는 Cursor 포럼에서도 보고된 바 있고, 임시 데이터를 삭제해 해결했다는 유저 피드백이 있었습니다.
해결 방법: 임시 저장소 폴더 정리
⚠️ 주의: 해당 폴더를 삭제하면 해당 프로젝트에서 진행 중이던 Chat 세션 기록이 모두 초기화됩니다.
저장된 코드 자체에는 영향이 없지만, 이전 대화 기록이 중요하다면 백업을 고려해야 합니다.
해결 과정은 다음과 같습니다.
1. Chat 기능 데이터를 저장하는 workspaceStorage 찾기
Cursor는 각 프로젝트별 작업 상태나 Chat 기록 등을 workspaceStorage 폴더 내에 저장합니다. 해당 경로는 운영체제별로 다음과 같습니다:
Windows: %APPDATA%\Cursor\User\workspaceStorage
macOS: ~/Library/Application Support/Cursor/User/workspaceStorage
Linux: ~/.config/Cursor/User/workspaceStorage
2. 해당 프로젝트의 workspace 해시 찾기
Cursor는 각 프로젝트별로 해시값을 기준으로 workspace를 관리합니다. 어떤 폴더가 어느 프로젝트인지 구분하기 위해선 다음 명령어로 workspace 파일 내 문자열을 검색합니다.
grep -rl "{프로젝트 이름}" */workspace.json이 명령어를 통해 특정 프로젝트와 매칭되는 workspace 해시 폴더를 식별할 수 있습니다.
3. 해당 해시 폴더 삭제
문제가 발생한 프로젝트의 해시 폴더를 찾아서 삭제합니다.
삭제 대상에는 주로 workspace.json, state.vscdb 등의 내부 상태 캐시가 포함되어 있습니다.
4. 다시 프로젝트 열기 (해시 자동 재생성)
Cursor에서 Open Project를 통해 해당 프로젝트 폴더를 다시 열면,
삭제한 해시값 대신 새로운 workspaceStorage가 자동으로 생성됩니다.
마무리하며
이번 경험을 통해 우리가 얻은 가장 큰 교훈은 단순합니다.
개발자가 도구를 이해하려는 노력을 멈추지 않을 때, 문제는 더 이상 장애물이 아니라 실험 대상이 된다는 점입니다.
기술은 계속 바뀌고, 도구도 계속 진화합니다. 그 흐름에서 중요한 건 단지 새로운 기능을 빠르게 익히는 속도가 아니라, 문제와 마주했을 때 직접 구조를 살피고 대응해보는 자세라고 생각합니다.
끝으로, 기술은 끊임없이 바뀌고, 문제는 언제든 다시 생기기 마련입니다.
그 흐름 속에서 어떤 태도를 취할지는 결국 각자의 몫이라는 점에서, 기억에 남는 문장을 하나 인용하며 글을 마무리합니다.
"에러를 겁내는 대신, 디버깅하는 법을 배운 사람만이 다음 단계를 본다."
감사합니다.
참고
- 관련 이슈: Cursor Forum - Endless Chat Loading
- 재현 및 테스트 환경: Cursor 버전 1.1.6
'오성찬' 카테고리의 다른 글
| 지란스터디 4기 계획 (2) | 2025.08.03 |
|---|