Skip to main content
명령어가 실패했지만 원인을 알 수 없을 때 이 페이지를 참고하세요. 먼저 octoparse doctor --json을 실행해 환경의 구조화된 진단 결과를 확인하세요.

​
환경 진단

"ok": false인 검사를 찾아 표시된 종속성 문제를 해결한 뒤 재시도하세요.

​
인증 오류

AUTH_REQUIRED or AUTH_INVALID CLI가 유효한 자격 증명을 찾지 못했습니다. 다음을 실행하세요.
CI 환경에서는 OCTO_ENGINE_API_KEY 또는 OCTO_ENGINE_ACCESS_TOKEN이 설정되어 있고 만료되지 않았는지 확인하세요. API 키가 저장되지 않음 CLI는 저장하기 전에 키를 검증합니다. 키가 거부되면 Octoparse 콘솔에서 활성 상태인지 확인하세요. --stdin을 사용한다면 키 앞뒤에 불필요한 공백이나 줄바꿈이 없는지 확인하세요. OAuth 세션 만료 토큰을 갱신하려면 octoparse auth login --oauth를 다시 실행하세요.

​
Chrome 및 브라우저 오류

Chrome 다운로드 실패 CLI는 CDN에서 Chrome for Testing을 자동으로 다운로드합니다. 다운로드에 실패하면 다음을 확인하세요.
  • 네트워크, 프록시 또는 VPN 설정을 확인합니다.
  • 로컬에 설치된 Chrome을 사용합니다: octoparse doctor --chrome-path /path/to/chrome
  • Linux 서버에서는 CDN에 연결할 수 있는지 확인한 뒤 재시도합니다.
LINUX_ARM64_UNSUPPORTED Linux arm64에서는 로컬 추출(run, detect)이 지원되지 않습니다. Chrome for Testing은 Linux arm64 패키지를 제공하지 않습니다. 해결 방법:
  • Linux x64 환경 또는 컨테이너를 사용합니다.
  • 대신 클라우드 추출을 사용합니다: octoparse cloud start <taskId>.
Linux 서버에서 Chrome 실행 실패 디스플레이가 없는 헤드리스 Linux 서버에서 비수동 모드의 detect는 Xvfb가 있으면 자동으로 사용합니다. 필요하면 다음과 같이 설치하세요.
수동 감지(--manual)에는 대화형 디스플레이가 필요합니다. Linux에서 수동 워크플로를 사용할 때는 데스크톱 또는 VNC 세션을 이용하세요.

​
작업 및 실행 오류

TASK_INVALID or exit code 3 작업이 CLI v1에서 지원하지 않는 커널 브라우저 또는 레거시 워크플로를 사용합니다. 최신 Octoparse 데스크톱 앱에서 작업을 다시 만든 뒤 다음 명령어로 검증하세요.
로컬 실행이 이미 진행 중 작업 ID당 한 번에 하나의 로컬 실행만 활성화할 수 있습니다. 먼저 기존 실행을 중지하세요.
분리 실행이 유실되었거나 오래됨 고립된 실행 상태를 정리하세요.
그런 다음 기록을 확인하세요.
실행은 완료되었지만 데이터가 보이지 않음 내보내기 소스를 확인하세요. 로컬 데이터와 클라우드 데이터는 별도로 관리됩니다.
추출할 때 --output ./runs를 사용했다면 기록 조회와 내보내기에도 같은 경로를 전달하세요.

​
내보내기 오류

UNSUPPORTED_EXPORT_FORMAT 지원 형식은 xlsx, csv, html, json, xml입니다. --format 값을 확인하세요. 내보낸 파일이 비어 있음 내보내기 전에 작업이 행을 수집했는지 확인하세요. 로컬 실행 기록을 조회합니다.
가장 최근 실행 항목에서 savedRows > 0인지 확인하세요.

​
감지 오류

DETECT_PAGE_BLOCKED CLI가 대상 페이지를 CAPTCHA, 보안 확인, 접근 제한 또는 서비스 오류 페이지로 식별했습니다. 결과 파일이 인증 또는 오류 화면을 대상으로 생성되지 않도록 작업 생성 전에 중지합니다.
  • CAPTCHA 또는 접근 제한을 해결한 뒤 재시도합니다.
  • 필요한 상호작용을 브라우저에서 완료할 수 있다면 --manual을 사용합니다.
  • 현재 URL이 항상 차단 페이지로 리디렉션된다면 직접 접근 가능한 URL을 제공합니다.
DETECT_FAILED or no candidates found 페이지가 자동 접근을 차단했거나 로그인 화면을 표시했거나 콘텐츠를 동적으로 불러왔을 수 있습니다. 다음을 시도하세요.
  • --manual로 로그인 또는 팝업을 직접 처리합니다.
  • --goal로 CLI에 더 명확한 추출 대상을 지정합니다.
  • 에이전트 컨텍스트(context.screenshot.path)에서 생성된 스크린샷을 확인합니다.
LOGIN_SESSION_REQUIRED 세션 저장과 함께 수동 감지를 사용하세요.

​
도움받기

자세한 사용법은 octoparse --help 또는 octoparse <command> --help를 실행해 확인하세요. 환경 문제를 문의할 때는 octoparse doctor --json 출력을 Octoparse 지원팀에 전달하세요.

Octoparse 지원팀에 문의

CLI 버전(octoparse --version)과 octoparse doctor --json 출력을 포함하세요.