Skip to main content
Usa questa pagina quando un comando non riesce e non sai perché. Inizia con octoparse doctor --json per ottenere una vista strutturata del tuo ambiente.

​
Diagnostica l’ambiente

Cerca qualsiasi controllo con "ok": false e risolvi la dipendenza segnalata prima di riprovare.

​
Errori di autenticazione

AUTH_REQUIRED o AUTH_INVALID La CLI non ha trovato credenziali valide. Esegui:
Se operi in CI, controlla che OCTO_ENGINE_API_KEY o OCTO_ENGINE_ACCESS_TOKEN sia impostato e non scaduto. La chiave API non viene salvata La CLI verifica le chiavi prima di salvarle. Se la chiave viene rifiutata, verifica che sia attiva nella console Octoparse. Se usi --stdin, verifica che la chiave non contenga spazi vuoti o nuove righe aggiuntivi. Sessione OAuth scaduta Esegui nuovamente octoparse auth login --oauth per aggiornare i token.

​
Errori di Chrome e del browser

Download di Chrome non riuscito La CLI scarica automaticamente Chrome for Testing da una CDN. Se il download non riesce:
  • Controlla le impostazioni di rete, Proxy o VPN.
  • Usa un Chrome installato localmente: octoparse doctor --chrome-path /path/to/chrome
  • Sui server Linux, verifica che la CDN sia raggiungibile e riprova.
LINUX_ARM64_UNSUPPORTED L’estrazione locale (run, detect) non è supportata su Linux arm64. Chrome for Testing non dispone di un pacchetto per Linux arm64. Opzioni:
  • Usa un ambiente o un container Linux x64.
  • Usa invece l’estrazione cloud: octoparse cloud start <taskId>.
Chrome non si avvia sui server Linux Sui server Linux headless senza display, detect in modalità non manuale usa automaticamente Xvfb quando disponibile. Installalo se necessario:
Il rilevamento manuale (--manual) richiede un display interattivo. Usa una sessione desktop o VNC per i flussi di lavoro manuali su Linux.

​
Errori delle attività e delle esecuzioni

TASK_INVALID o codice di uscita 3 L’attività usa il browser kernel o un flusso di lavoro legacy non supportato dalla CLI v1. Ricrea l’attività nell’app desktop Octoparse corrente, quindi convalidala con:
Esecuzione locale già in corso Può essere attiva una sola esecuzione locale per ciascun ID attività. Interrompi prima l’esecuzione esistente:
Esecuzione scollegata persa o obsoleta Pulisci lo stato delle esecuzioni orfane:
Quindi controlla la cronologia:
L’esecuzione termina ma alcuni dati sembrano mancanti Controlla la sorgente dell’esportazione. I dati locali e cloud sono separati:
Se hai usato --output ./runs durante l’estrazione, passa lo stesso percorso alla cronologia e all’esportazione:

​
Errori di esportazione

UNSUPPORTED_EXPORT_FORMAT I formati supportati sono xlsx, csv, html, json e xml. Controlla il valore di --format. Il file esportato è vuoto Prima dell’esportazione, verifica che l’attività abbia raccolto delle righe. Controlla la cronologia delle esecuzioni locali:
Cerca savedRows > 0 nella voce dell’esecuzione più recente.

​
Errori di detect

DETECT_PAGE_BLOCKED La CLI ha identificato la destinazione come CAPTCHA, verifica di sicurezza, pagina con accesso limitato o pagina di errore del servizio. Si interrompe prima di creare un’attività, affinché il file risultante non descriva la schermata di verifica o di errore.
  • Risolvi il CAPTCHA o la limitazione di accesso e riprova.
  • Usa --manual quando l’interazione richiesta può essere completata nel browser.
  • Fornisci un URL direttamente accessibile quando quello corrente reindirizza sempre a una pagina bloccata.
DETECT_FAILED o nessun candidato trovato La pagina potrebbe aver bloccato l’accesso automatizzato, mostrato una schermata di accesso o caricato il contenuto in modo dinamico. Prova:
  • --manual per gestire personalmente l’accesso o i popup.
  • --goal per fornire alla CLI un obiettivo di estrazione più chiaro.
  • Controllare lo screenshot generato nel contesto dell’agente (context.screenshot.path).
LOGIN_SESSION_REQUIRED Usa il rilevamento manuale con salvataggio della sessione:

​
Ottieni assistenza

Esegui octoparse --help o octoparse <command> --help per i dettagli sull’utilizzo. Quando segnali problemi dell’ambiente, condividi con l’assistenza Octoparse l’output di octoparse doctor --json.

Contatta l'assistenza Octoparse

Includi la versione della CLI (octoparse --version) e l’output di octoparse doctor --json.