Skip to main content
Verwenden Sie diese Seite, wenn ein Befehl fehlschlägt und die Ursache unklar ist. Beginnen Sie mit octoparse doctor --json, um eine strukturierte Übersicht Ihrer Umgebung zu erhalten.

​
Umgebung diagnostizieren

Suchen Sie nach Prüfungen mit "ok": false und beheben Sie die markierte Abhängigkeit, bevor Sie es erneut versuchen.

​
Authentifizierungsfehler

AUTH_REQUIRED oder AUTH_INVALID Die CLI konnte keine gültigen Anmeldedaten finden. Führen Sie Folgendes aus:
Prüfen Sie in CI-Umgebungen, ob OCTO_ENGINE_API_KEY oder OCTO_ENGINE_ACCESS_TOKEN gesetzt und nicht abgelaufen ist. API-Schlüssel wird nicht gespeichert Die CLI überprüft Schlüssel vor dem Speichern. Wird Ihr Schlüssel abgelehnt, bestätigen Sie, dass er in der Octoparse-Konsole aktiv ist. Prüfen Sie bei Verwendung von --stdin, dass dem Schlüssel keine zusätzlichen Leerzeichen oder Zeilenumbrüche angefügt sind. OAuth-Sitzung abgelaufen Führen Sie octoparse auth login --oauth erneut aus, um die Token zu aktualisieren.

​
Chrome- und Browserfehler

Chrome kann nicht heruntergeladen werden Die CLI lädt Chrome for Testing automatisch von einem CDN herunter. Wenn der Download fehlschlägt:
  • Prüfen Sie Ihre Netzwerk-, Proxy- oder VPN-Einstellungen.
  • Verwenden Sie ein lokal installiertes Chrome: octoparse doctor --chrome-path /path/to/chrome
  • Stellen Sie auf Linux-Servern sicher, dass das CDN erreichbar ist, und versuchen Sie es erneut.
LINUX_ARM64_UNSUPPORTED Lokale Extraktion (run, detect) wird unter Linux arm64 nicht unterstützt. Für Chrome for Testing gibt es kein Linux-arm64-Paket. Optionen:
  • Verwenden Sie eine Linux-x64-Umgebung oder einen entsprechenden Container.
  • Verwenden Sie stattdessen die Cloud-Extraktion: octoparse cloud start <taskId>.
Chrome startet auf Linux-Servern nicht Auf monitorlosen Linux-Servern ohne Anzeige verwendet detect im nicht manuellen Modus automatisch Xvfb, sofern verfügbar. Installieren Sie es bei Bedarf:
Die manuelle Erkennung (--manual) erfordert eine interaktive Anzeige. Verwenden Sie für manuelle Workflows unter Linux einen Desktop oder eine VNC-Sitzung.

​
Aufgaben- und Lauffehler

TASK_INVALID oder Exit-Code 3 Die Aufgabe verwendet einen Kernel-Browser oder einen älteren Workflow, der von CLI v1 nicht unterstützt wird. Erstellen Sie die Aufgabe in der aktuellen Octoparse-Desktop-App neu und validieren Sie sie anschließend mit:
Lokaler Lauf wird bereits ausgeführt Pro Aufgaben-ID kann jeweils nur ein lokaler Lauf aktiv sein. Stoppen Sie zuerst den vorhandenen Lauf:
Losgelöster Lauf verloren oder veraltet Bereinigen Sie verwaiste Laufzustände:
Prüfen Sie danach den Verlauf:
Lauf wird abgeschlossen, aber Daten scheinen zu fehlen Prüfen Sie die Exportquelle. Lokale und Cloud-Daten sind getrennt:
Wenn Sie während der Extraktion --output ./runs verwendet haben, geben Sie für Verlauf und Export denselben Pfad an:

​
Exportfehler

UNSUPPORTED_EXPORT_FORMAT Unterstützte Formate sind xlsx, csv, html, json und xml. Prüfen Sie den Wert für --format. Exportdatei ist leer Vergewissern Sie sich vor dem Export, dass die Aufgabe Zeilen erfasst hat. Prüfen Sie den Verlauf lokaler Läufe:
Suchen Sie im neuesten Laufeintrag nach savedRows > 0.

​
Erkennungsfehler

DETECT_PAGE_BLOCKED Die CLI hat das Ziel als CAPTCHA, Sicherheitsabfrage, zugriffsbeschränkte Seite oder Dienstfehlerseite erkannt. Sie stoppt vor der Aufgabenerstellung, damit die resultierende Datei nicht den Verifizierungs- oder Fehlerbildschirm beschreibt.
  • Lösen Sie das CAPTCHA oder die Zugriffsbeschränkung und versuchen Sie es erneut.
  • Verwenden Sie --manual, wenn die erforderliche Interaktion im Browser abgeschlossen werden kann.
  • Geben Sie eine direkt zugängliche URL an, wenn die aktuelle URL immer auf eine blockierte Seite weiterleitet.
DETECT_FAILED oder keine Kandidaten gefunden Möglicherweise hat die Seite den automatisierten Zugriff blockiert, eine Anmeldeschranke angezeigt oder Inhalte dynamisch geladen. Versuchen Sie Folgendes:
  • Verwenden Sie --manual, um Anmeldung oder Pop-ups selbst zu bearbeiten.
  • Geben Sie mit --goal ein klareres Extraktionsziel vor.
  • Prüfen Sie den erzeugten Screenshot im Agentenkontext (context.screenshot.path).
LOGIN_SESSION_REQUIRED Verwenden Sie die manuelle Erkennung mit Sitzungsspeicherung:

​
Hilfe erhalten

Führen Sie octoparse --help oder octoparse <command> --help aus, um Nutzungsdetails anzuzeigen. Geben Sie bei der Meldung von Umgebungsproblemen die Ausgabe von octoparse doctor --json an den Octoparse-Support weiter.

Octoparse-Support kontaktieren

Geben Sie Ihre CLI-Version (octoparse --version) und die Ausgabe von octoparse doctor --json an.