Résolution des problèmes

Erreurs courantes, leurs causes et comment les corriger. Chaque section répertorie d'abord le message d'erreur ou le problème, puis ce qu'il signifie et ce qu'il faut faire.

Installation

uip: commande introuvable après npm install -g

Le préfixe global npm ne se trouve pas sur votre PATH. Rechercher:

npm config get prefix

Sur macOS/Linux, ajoutez le préfixe renvoyé + /bin à votre profil shell (~/.zshrc, ~/.bashrc). Sous Windows, %APPDATA%\npm devrait être activé par défaut sur PATH — ouvrez un nouveau terminal pour récupérer la mise à jour.

Référence complète: Installation de la UiPath CLI — Résolution des problèmes.

EACCES: autorisation refusée lors de l’installation

Vous essayez d’écrire dans un préfixe npm appartenant au système. N'utilisez pas sudo. Définissez plutôt un préfixe local pour l'utilisateur:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm install -g @uipath/cli

Authentification

ErreurAuthentification (code de sortie 2) à chaque commande

Aucune session valide. Soit:

• Exécutez uip login pour démarrer une session interactive, ou
• Dans CI, transmettez Informations d'identification de l'application externe: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT", ou
• Pour les conteneurs avec un jeton pré-émis: définissez UIPATH_CLI_ENABLE_ENV_AUTH=true plus les variables UIPATH_CLI_AUTH_TOKEN / UIPATH_CLI_ORGANIZATION_* / UIPATH_CLI_TENANT_* .

Statut de vérification: uip login status.

Voir Authentification.

Jeton expiré ou expiré dans le statut de connexion uip

Le jeton d’actualisation n’est plus valide, généralement après des semaines d’inactivité ou une déconnexion forcée par l’administrateur. Réexécutez uip login.

Pour l'authentification env-var, le jeton est Opaque à uip; Faites pivoter UIPATH_CLI_AUTH_TOKEN du côté émetteur.

Aucun locataire sélectionné après la connexion à l’UIP

La connexion s'est effectuée sans choix de locataire — le sélecteur a été annulé ou --tenant a réussi, mais la valeur ne correspond à aucun locataire accessible. Réessayez avec uip login --interactive pour choisir dans une liste, ou uip login --tenant <exact-name>.

Les variables d’environnement UIPATH_CLient_ID / UIPATH_CLient_SECRET env semblent être ignorées

Ils sont. La CLI UiPath a supprimé la lecture d’Env-var implicite pour ces valeurs. Transmettez explicitement:

uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT"

Le préfixe env. indique uip de se résoudre à partir de l'environnement au moment du runtime, sans exposer la valeur sur la ligne de commande.

Outils

Outil ' non installé — tentative d'installation automatique

Information: l’hôte télécharge un outil lors de la première utilisation. Les appels suivants réutilisent la copie installée. Pour éviter ce message de journal dans CI, préinstallez:

uip tools install @uipath/orchestrator-tool @uipath/solution-tool

Voir Contrôle de l'installation automatique de l'outil.

Échec de l’installation automatique '

Le téléchargement de l’outil a échoué. Causes courantes:

• Pas de réseau — vérifiez la connectivité ou les paramètres du proxy.
• Blocs de proxy d'entreprise npm — set HTTPS_PROXY=http://proxy.example.com:8080.
• registre npm ne peut pas être résolu — vérifiez npm config get registry points à un endroit accessible.

Réessayer manuellement: uip tools install <verb>.

Les commandes d'outils disparaissent de uip --help après une mise à niveau

La version de l’outil est incompatible avec l’hôte. Correctif:

uip tools update

Cela met chaque outil installé à la dernière version dans la ligne MAJOR.MINIOR de l'hôte. Voir Contrôle des versions et stabilité.

ErreurValidation: package « ne figure pas sur la liste blanche

Vous avez essayé d’installer un outil qui n’est pas @uipath/. 1.x ne prend en charge que l'ensemble de la liste blanche; les outils tiers ne sont pas encore disponibles.

Sortie et filtrage

ErreurValidation: non valide --output-filter (sortie 3)

L’expression JMESPath n’a pas pu être analysée. La CLI valide au moment de l'analyse avant d'exécuter la commande — corrigez le filtre et réessayez. Référence JMESPath: jmespath.org.

Erreur fréquente: --output-filter "Data.Jobs[0].Key" fonctionne, mais --output-filter "Data.Jobs[-1].Key" ne l'est pas — JMESPath [-1] n'est pas pris en charge. Utilisez Data.Jobs | [-1:][0].Key à la place ou effectuez un post-traitement avec jq

J'essayais de disposer d'une table, mais j'ai obtenu JSON

La sortie par défaut est JSON. Transmettez --output table pour obtenir la vue conviviale en lecture. Voir Formats de sortie.

L’étape du pipeline ne parvient pas à analyser JSON — le texte non-JSON apparaît dans stdout

Les journaux, les barres de progression et certains messages d'erreur vont vers stderr, et non stdout. Si quelque chose de non-JSON est sur stdout, vous avez probablement redirigé les deux flux dans le même fichier. Redirigez-les séparément:

uip or folders list > folders.json 2> uip.log

Commandes et codes de sortie

La commande se termine par la valeur 0, mais je m'attendais à ce qu'elle échoue

Une exception Success Result correspond au code de sortie 0 même lorsque la charge utile est vide. Par exemple, uip or folders list --all --name Nonexistent quitte 0 avec Data: []. Branche au niveau de la forme de la charge utile:

COUNT=$(uip or folders list --all --name Foo --output-filter "length(Data)" --output plain)
[[ "$COUNT" -eq 0 ]] && { echo "no match"; exit 1; }

uip tm se termine par 2 — l'authentification a-t-elle échoué?

Non. tm wait réutilise le code de sortie 2 pour le délai d’expiration, et non pour l’authentification. Cochez Result dans l'enveloppe pour désambiguer (AuthenticationError vs TimeoutError). Cette réutilisation spécifique à un domaine est répertoriée dans la section Codes de sortie.

L’exécution des ensembles de tests uip tm a réussi, mais mes tests échouent

Corrigé par conception. tm testsets run quitte 0 une fois qu'Orchestrator a accepté l'exécution — le verbe sera rendu ultérieurement. Chaînez l'ID en trois étapes:

EXEC_ID=$(uip tm testsets run --test-set-key "$TESTSET" --output-filter "Data.ExecutionId" --output plain)
uip tm wait --execution-id "$EXEC_ID" --timeout 1800
FAILED=$(uip tm report get --execution-id "$EXEC_ID" --output-filter "Data.Failed" --output plain)
[[ "$FAILED" -gt 0 ]] && { echo "$FAILED tests failed"; exit 1; }

Voir Modèles de scripts, ensembles de tests uip tm et exécutions uip tm.

Configuration

Les modifications des variables d'environnement ne prennent pas effet

Un processus de longue durée (un agent, un script surveillé) lit son environnement une fois au démarrage. Redémarrez le processus après avoir modifié les variables d’environnement. Pour les commandes à usage unique, une nouvelle invocation de uip lit toujours l'environnement actuel.

Vérifiez la priorité: indicateur CLI > variable d'environnement > valeur intégrée par défaut. Voir Configuration.

Achèvement de l’shell

L'achèvement de l'onglet ne se termine pas

Ouvrez un nouveau terminal après uip completion afin que le fichier rc du shell soit source. Si le bloc est toujours manquant, exécutez uip completion --print pour voir quel bloc uip suppose être installé; comparer avec votre ~/.zshrc / ~/.bashrc / $PROFILE.

téléchargement d’uip ou de packages --package-name ne suggère pas de noms

L'achèvement dynamique de la valeur d'indicateur est zsh uniquement et nécessite jq sur le PATH Installez jq ou basculez sur zsh. La sous-commande statique + la complétion de nom d'option fonctionne dans l'ensemble des quatre shells, indépendamment.

Intégration du shell et du CI

L’étape CI est suspendue à la connexion uip ou à l’installation des compétences uip

La commande attend une invite interactive. Transmettez les indicateurs nécessaires:

• uip login --tenant <name> (ignorer le sélecteur de locataires)
• uip skills install --agent <name> (ignorer le sélecteur d’agent)

Si vous ne savez pas quelle invite est interactive, exécutez la commande défaillante sous uip --log-level debug … localement dans un contexte non TType (redirection stdout) et inspectez quelle invite est apparue.

uip ou le démarrage des tâches renvoie immédiatement - Je veux qu'il attende

Par défaut, jobs start accepte l'exécution et se quitte. Ajouter --wait-for-completion:

uip or jobs start <process-key> --wait-for-completion --timeout 600

Quelque chose que je n’ai pas trouvé ici

Consultez la page de référence de la commande que vous exécutez - chacune a ses propres codes de sortie et section d'exemples. Recherchez ensuite les notes de version pour un problème similaire. Si rien ne correspond, rassemblez:

• uip --version
• uip tools list
• La commande exacte et le fichier stderr/stdout complet
• Le champ Result de l'enveloppe JSON.

…et ouvrez un problème avec l’équipe de la UiPath CLI.

Voir également

• Codes de sortie - ce que signifie chaque code, y compris le cas spécial tm wait .
• Modèles de script — réessai, interrogation, séparation des flux, pipelines idempotents.
• Authentification — les trois flux d'authentification en détail.
• Installation de la UiPath CLI — Dépannage — erreurs spécifiques à l'installation.