오류 메시지

관리도구에서 자주 표시되는 오류·경고 메시지의 의미와 대응 방법입니다.

로그인 / 인증

메시지	의미	대응
ID 또는 비밀번호가 일치하지 않습니다	입력값 불일치	오타 확인. 누적 시 잠금 가능
계정이 잠겼습니다	비밀번호 오입력 누적	다른 관리자에게 잠금 해제 요청
접속이 차단된 IP입니다	IP 정책에 의해 차단	IP 차단 시 참고
세션이 만료되었습니다	자동 로그아웃	재로그인 (세션과 자동 로그아웃)

컬렉션 / 색인

메시지	의미	대응
NAME은 영문 시작 · 영문·숫자·언더스코어만 허용됩니다	NAME 형식 오류	규칙에 맞게 다시 입력
이미 실행 중인 작업이 있습니다	동일 컬렉션 동시 실행 시도	진행 중 작업 완료 후 재시도
수집 실패 / 색인 실패	원본 연결 또는 데이터 오류	[구동 상태] 탭의 에러 로그 확인
DB 연결 테스트 실패	JDBC URL · 계정 · 네트워크 오류	연결 정보 재확인, 방화벽 점검

검색엔진 / 컴포넌트

메시지	의미	대응
비정상동작중	일부 프로세스 중단 또는 중복 실행	검색엔진 상태에서 정지 → 시작으로 재기동
검색엔진 시작 실패	시작 스크립트 오류	런타임 로그 확인, 시스템 자원·라이선스 확인
컴포넌트 DOWN	API/MSA 컴포넌트 응답 없음	컴포넌트 상태에서 상세 사유 확인

사전

메시지	의미	대응
키워드를 입력하세요	필수 입력 누락	키워드 입력 후 저장
분해 음절수를 입력하세요	복합명사 사전 필수값 누락	음절수 규칙대로 입력
엑셀 파일 형식이 올바르지 않습니다	업로드 파일 검증 실패	다운로드 양식과 동일한 구조로 작성 후 재업로드
분석 결과가 없습니다	형태소 분석 결과 0건	한국어 문장으로 재시도

UI / 부가기능

메시지	의미	대응
URL 형식이 올바르지 않습니다	바로가기·테마검색 URL 형식 오류	http://·https://로 시작하는 정상 URL
검증 실패	필수 입력 누락 또는 형식 오류	안내된 항목 확인 후 재시도

일반

메시지	의미	대응
권한이 없습니다	본인 권한 범위 밖 동작 시도	권한이 있는 다른 관리자에게 요청
데이터를 불러오지 못했습니다	서버 통신 오류	새로고침 재시도. 반복되면 운영팀 확인
저장에 실패했습니다	서버 처리 실패	입력값 확인 후 재시도. 반복되면 운영팀 확인

🚨 일반 권장 사항

• 오류 메시지에 토스트로 추가 사유가 표시되면 그 내용을 함께 기록해 운영팀에 공유하세요.
• 반복되는 오류는 발생 시각·메뉴 경로·입력값·브라우저를 함께 정리하면 빠른 분석에 도움이 됩니다.