Skip to main content
Utilisez cette page lorsqu’une commande échoue sans cause évidente. Commencez par octoparse doctor --json pour obtenir une vue structurée de votre environnement.

​
Diagnostiquer votre environnement

Repérez les vérifications contenant "ok": false et corrigez la dépendance signalée avant de réessayer.

​
Erreurs d’authentification

AUTH_REQUIRED ou AUTH_INVALID La CLI n’a trouvé aucun identifiant valide. Exécutez :
Dans un environnement CI, vérifiez que OCTO_ENGINE_API_KEY ou OCTO_ENGINE_ACCESS_TOKEN est défini et n’a pas expiré. La clé API n’est pas enregistrée La CLI vérifie les clés avant de les enregistrer. Si votre clé est rejetée, vérifiez qu’elle est active dans la console Octoparse. Si vous utilisez --stdin, assurez-vous qu’aucune espace ni nouvelle ligne superflue n’entoure la clé. La session OAuth a expiré Exécutez de nouveau octoparse auth login --oauth pour actualiser les jetons.

​
Erreurs Chrome et de navigateur

Échec du téléchargement de Chrome La CLI télécharge automatiquement Chrome for Testing depuis un CDN. Si le téléchargement échoue :
  • Vérifiez les paramètres de votre réseau, Proxy ou VPN.
  • Utilisez une installation locale de Chrome : octoparse doctor --chrome-path /path/to/chrome.
  • Sur les serveurs Linux, vérifiez que le CDN est accessible, puis réessayez.
LINUX_ARM64_UNSUPPORTED L’Extraction locale (run, detect) n’est pas prise en charge sous Linux arm64. Chrome for Testing ne fournit aucun package pour Linux arm64. Solutions :
  • Utilisez un environnement ou un conteneur Linux x64.
  • Utilisez plutôt l’Extraction dans le cloud : octoparse cloud start <taskId>.
Chrome ne démarre pas sur les serveurs Linux Sur les serveurs Linux sans interface graphique et sans affichage, detect utilise automatiquement Xvfb, s’il est disponible, lorsqu’il n’est pas exécuté en mode manuel. Installez-le si nécessaire :
La détection manuelle (--manual) nécessite un affichage interactif. Utilisez un bureau ou une session VNC pour les Flux de travail manuels sous Linux.

​
Erreurs de tâche et d’exécution

TASK_INVALID ou code de sortie 3 La tâche utilise le navigateur du noyau ou un ancien Flux de travail non pris en charge par la version 1 de la CLI. Recréez la tâche dans la version actuelle de l’application de bureau Octoparse, puis validez-la avec :
Une exécution locale est déjà en cours Une seule exécution locale peut être active à la fois pour un même ID de tâche. Arrêtez d’abord l’exécution existante :
Exécution détachée perdue ou obsolète Nettoyez l’état des exécutions orphelines :
Consultez ensuite l’historique :
L’exécution se termine, mais des données semblent manquer Vérifiez la source de l’export. Les données locales et celles dans le Cloud sont distinctes :
Si vous avez utilisé --output ./runs pendant l’extraction, transmettez le même chemin pour l’historique et l’export :

​
Erreurs d’export

UNSUPPORTED_EXPORT_FORMAT Les formats pris en charge sont xlsx, csv, html, json et xml. Vérifiez la valeur de --format. Le fichier d’export est vide Vérifiez que la tâche a collecté des lignes avant de les exporter. Consultez l’historique des exécutions locales :
Recherchez savedRows > 0 dans l’entrée d’exécution la plus récente.

​
Erreurs de detect

DETECT_PAGE_BLOCKED La CLI a identifié la cible comme une page contenant un CAPTCHA, soumise à un contrôle de sécurité ou à des restrictions d’accès, ou affichant une erreur du service. Elle s’arrête avant de créer une tâche afin que le fichier obtenu ne décrive pas l’écran de vérification ou d’erreur.
  • Résolvez le CAPTCHA ou la restriction d’accès, puis réessayez.
  • Utilisez --manual lorsque l’interaction requise peut être effectuée dans le navigateur.
  • Indiquez une URL directement accessible si l’URL actuelle redirige systématiquement vers une page bloquée.
DETECT_FAILED ou aucun candidat trouvé La page peut avoir bloqué l’accès automatisé, affiché une demande de connexion ou chargé son contenu dynamiquement. Essayez les solutions suivantes :
  • Utilisez --manual pour gérer vous-même la connexion ou les fenêtres contextuelles.
  • Utilisez --goal pour fournir une cible d’extraction plus précise à la CLI.
  • Consultez la capture d’écran générée dans le contexte de l’agent (context.screenshot.path).
LOGIN_SESSION_REQUIRED Utilisez la détection manuelle et enregistrez la session :

​
Obtenir de l’aide

Exécutez octoparse --help ou octoparse <command> --help pour afficher les informations d’utilisation. Lorsque vous signalez un problème d’environnement, transmettez la sortie de octoparse doctor --json à l’assistance Octoparse.

Contacter l’assistance Octoparse

Indiquez la version de votre CLI (octoparse --version) et joignez la sortie de octoparse doctor --json.