트러블슈팅
자주 발생하는 문제를 사용자 언어로 해결하는 가이드
트러블슈팅
아래 순서대로 진행하면 대부분 빠르게 복구할 수 있어요: 증상 확인 → 가능한 원인 확인 → 단계별 해결
1) 작업 공간이 시작되지 않아요
증상
- 작업 공간이 준비 중 상태에서 멈춤.
가능한 원인
- 일시적인 서비스 지연
- 인터넷 연결 불안정
- 이전 작업이 정상적으로 종료되지 않음
해결 방법
- 1~2분 기다린 뒤 화면을 새로고침
- 브라우저 탭을 닫았다가 다시 열기
- 작업 공간을 다시 열기
- 반복되면 새 작업 공간으로 먼저 진행
2) 연결이 자주 끊겨요
증상
- 사용 중 갑자기 멈추거나 다시 연결하라는 안내가 보여요.
가능한 원인
- 와이파이 품질 저하
- 회사 보안 프로그램 또는 VPN 영향
- 브라우저 절전 기능
해결 방법
- 인터넷 속도와 지연 상태 확인
- VPN을 잠시 끄고 다시 시도
- 다른 브라우저에서 동일한지 확인
- 절전/탭 자동중지 기능 끄기
3) 결제가 실패해요
증상
- 결제 단계에서 실패 또는 거절 안내가 떠요.
가능한 원인
- 카드 한도 또는 사용 제한
- 카드사 승인 실패
- 결제 정보 입력 실수
해결 방법
- 카드 정보 다시 확인
- 카드사 앱에서 결제 제한 상태 확인
- 다른 카드로 다시 시도
- 계속 실패하면 결제사 고객센터 문의
4) 프로젝트가 열리지 않아요
증상
- 프로젝트를 눌러도 열리지 않거나 오래 걸려요.
가능한 원인
- 로그인 상태 불일치
- 브라우저 임시 데이터 문제
- 일시적인 서비스 지연
해결 방법
- 강력 새로고침
- 로그아웃 후 다시 로그인
- 다른 프로젝트가 열리는지 확인
- 같은 문제가 반복되면 관리자에게 문의
5) AI가 응답하지 않아요
증상
- 메시지를 보낸 뒤 답변이 오래 지연되거나 멈춰요.
가능한 원인
- 일시적인 AI 처리 지연
- 한 번에 너무 긴 요청 입력
- 외부 도구 연결 상태 불안정
해결 방법
- 질문을 더 짧게 나눠 전송
- 잠시 기다린 뒤 다시 시도
- 다른 작업 흐름으로 전환
- 외부 도구를 쓴 경우 연결 상태 점검
6) 배포가 실패해요
증상
- 배포가 완료되지 않고 실패로 끝나요.
가능한 원인
- 필수 입력값 누락
- 최근 변경 내용의 충돌
- 연동 서비스 인증 실패
해결 방법
- 필수 입력값을 다시 확인
- 최근 바꾼 내용을 하나씩 되돌려 점검
- 안내 메시지의 첫 오류부터 순서대로 해결
- 작은 변경 단위로 다시 배포
7) 단축키가 작동하지 않아요
증상
- 단축키를 눌러도 반응이 없어요.
가능한 원인
- 브라우저 기본 단축키와 충돌
- 입력 위치(포커스) 문제
- 같은 단축키가 중복 설정됨
해결 방법
Alt기반 조합으로 변경- 중복 단축키 해제
- 저장 후 페이지 새로고침
8) 알림이 오지 않아요
증상
- 완료/실패 안내가 화면에 보이지 않아요.
가능한 원인
- 브라우저 알림 권한 거부
- 운영체제 알림 차단
- 앱 내 알림 토글 꺼짐
해결 방법
- 브라우저 알림 권한 허용
- 운영체제 알림 설정 점검
- 앱의 알림 설정 켜기
- 테스트 알림으로 확인
9) 외부 도구 연결이 불안정해요
증상
- 어떤 때는 되고 어떤 때는 실패해요.
가능한 원인
- 연결 대상 서비스 지연
- 인증 정보 만료
- 동시에 많은 요청 처리
해결 방법
- 연결 대상 서비스 상태 확인
- 인증 정보 재발급 후 다시 연결
- 잠시 뒤 재시도
- 반복되면 사용량이 적은 시간대에 진행
10) 화면이 느려요
증상
- 화면 전환이나 입력 반응이 느려요.
가능한 원인
- 브라우저 탭 과다
- 확장 프로그램 과다
- 인터넷 지연
해결 방법
- 불필요한 탭 정리
- 브라우저 확장 기능 최소화
- 다른 네트워크에서 속도 비교
- 재현 상황을 기록해 지원 요청
지원 요청 템플릿
문제가 생긴 시간, 화면 이름, 재현 순서, 표시된 안내 문구, 브라우저/운영체제 정보를 함께 전달하면 해결이 훨씬 빨라져요.