> ## Documentation Index > Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Dépannage d’Octoparse CLI > Résolvez les erreurs d’authentification, de Chrome, de profil, d’exécution, de détection des pages bloquées, de Linux arm64 et d’export. 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 ```bash theme={null} octoparse doctor --json octoparse browser status --json ``` 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 : ```bash theme={null} octoparse auth login octoparse auth status --json ``` 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](https://www.octoparse.fr/console/account-center/api-keys). 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 `. **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 : ```bash theme={null} apt-get install -y xvfb ``` 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 : ```bash theme={null} octoparse task validate ``` **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 : ```bash theme={null} octoparse local stop octoparse local cleanup ``` **Exécution détachée perdue ou obsolète** Nettoyez l’état des exécutions orphelines : ```bash theme={null} octoparse local cleanup ``` Consultez ensuite l’historique : ```bash theme={null} octoparse local history ``` **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 : ```bash theme={null} octoparse data history --source local --json octoparse data history --source cloud --json ``` Si vous avez utilisé `--output ./runs` pendant l’extraction, transmettez le même chemin pour l’historique et l’export : ```bash theme={null} octoparse data history --source local --output ./runs octoparse data export --source local --output ./runs --format xlsx ``` ## 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 : ```bash theme={null} octoparse local history --json ``` 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 : ```bash theme={null} octoparse detect --manual --save-session --session-name my-session ``` ## Obtenir de l’aide Exécutez `octoparse --help` ou `octoparse --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. Indiquez la version de votre CLI (`octoparse --version`) et joignez la sortie de `octoparse doctor --json`.