Fehlersuche und ‑behebung

Häufige Fehler, ihre Ursachen und deren Behebung. In jedem Abschnitt ist zuerst die Fehlermeldung oder das Symptom aufgelistet, dann was es bedeutet und was zu tun ist.

Installation

uip: Befehl nach npm-Installation -g nicht gefunden

Das globale Präfix „npm“ befindet sich nicht auf Ihrem PATH. Zu finden:

npm config get prefix

Fügen Sie unter macOS/Linux das zurückgegebene Präfix + /bin zu Ihrem Shell-Profil (~/.zshrc, ~/.bashrc) hinzu. Unter Windows sollte %APPDATA%\npm standardmäßig auf PATH sein – öffnen Sie ein neues Terminal, um das Update aufzunehmen.

Vollständige Referenz: Installieren von UiPath CLI – Fehlerbehebung.

EACCES: Berechtigung während der Installation verweigert

Sie versuchen, in ein systemeigenes npm-Präfix zu schreiben. Verwenden Sie nicht sudo. Legen Sie stattdessen ein benutzerlokales Präfix fest:

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

Authentication

Authentifizierungsfehler (Exitcode 2) bei jedem Befehl

Keine gültige Sitzung. Entweder:

• Führen Sie uip login aus, um eine interaktive Sitzung zu starten, oder
• Übergeben Sie in CI externe App-Anmeldeinformationen: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT" oder
• Für Container mit einem vorab ausgegebenen Token: Legen Sie UIPATH_CLI_ENABLE_ENV_AUTH=true sowie die Variablen UIPATH_CLI_AUTH_TOKEN / UIPATH_CLI_ORGANIZATION_* / UIPATH_CLI_TENANT_* fest.

Status überprüfen: uip login status.

Siehe Authentifizierung.

Token abgelaufen oder Abgelaufen im UIP-Anmeldestatus

Das Aktualisierungstoken ist nicht mehr gültig – normalerweise nach wochenlanger Inaktivität oder einer vom Administrator erzwungenen Abmeldung. Führen Sie uip login erneut aus.

Für die env-var-Authentifizierung ist das Token für uip undurchsichtig; Rotieren Sie UIPATH_CLI_AUTH_TOKEN von der ausstellenden Seite.

Kein Mandant nach UIP-Anmeldung ausgewählt

Die Anmeldung wurde ohne Mandantenauswahl abgeschlossen – entweder wurde die Auswahl abgebrochen oder --tenant wurde übergeben, aber der Wert stimmt mit keinem zugänglichen Mandanten überein. Versuchen Sie es mit uip login --interactive erneut, um aus einer Liste auszuwählen, oder uip login --tenant <exact-name>.

UIPATH_CLIENT_ID/UIPATH_CLIENT_SECRET env-Variablen scheinen ignoriert zu werden

Sie sind. Die UiPath CLI hat das implizite env-var-Lesen für diese Werte entfernt. Explizit übergeben:

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

Das Präfix env. weist uip an, die Umgebung zur Runtime aufzulösen, ohne den Wert in der Befehlszeile verfügbar zu machen.

Tools

Tool „ nicht installiert – die automatische Installation wird versucht

Informativ – Der Host lädt ein Tool bei der ersten Verwendung herunter. Nachfolgende Aufrufe verwenden die installierte Kopie wieder. Um diese Protokollmeldung in CI zu vermeiden, installieren Sie Folgendes vor:

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

Siehe Steuern der automatischen Installation des Tools.

Fehler bei der automatischen Installation '

Fehler beim Herunterladen des Tools. Häufige Ursachen:

• Kein Netzwerk – Überprüfen Sie die Verbindung oder Proxyeinstellungen.
• Enterprise Proxy-Blöcke npm – HTTPS_PROXY=http://proxy.example.com:8080 festlegen.
• npm-Registrierung ist nicht auflösbar – überprüfen Sie npm config get registry Punkte an einem Ort, an dem sie erreichbar sind.

Manuell wiederholen: uip tools install <verb>.

Toolbefehle werden nach einem Upgrade aus „uip --help“ entfernt

Die Tool-Version stimmt nicht mit dem Host überein. Beheben:

uip tools update

Dadurch wird jedes installierte Tool auf die neueste Version innerhalb der Zeile MaJOR.MINOR des Hosts aktualisiert. Siehe Versionierung und Stabilität.

Validierungsfehler: Paket „ steht nicht auf der weißen Liste

Sie haben versucht, ein Tool zu installieren, das nicht @uipath/ ist. 1.x unterstützt nur den Satz auf der weißen Liste; Tools von Drittanbietern sind noch nicht verfügbar.

Ausgabe und Filterung

Validierungsfehler: Ungültiger --output-filter (Exit 3)

Der JMESPath-Ausdruck konnte nicht geparst werden. Die CLI validiert zur Parsezeit, bevor der Befehl ausgeführt wird – korrigieren Sie den Filter und versuchen Sie es erneut. JMESPath-Referenz: jMESPath.org.

Eine häufige Gefahr: --output-filter "Data.Jobs[0].Key" funktioniert, aber --output-filter "Data.Jobs[-1].Key" nicht – JMESPath [-1] wird nicht unterstützt. Verwenden Sie stattdessen Data.Jobs | [-1:][0].Key oder verarbeiten Sie mit jq nach.

Ich habe eine Tabelle erwartet, aber ich habe JSON erhalten

Die Standardausgabe ist JSON. Übergeben Sie --output table für die lesbare Ansicht. Siehe Ausgabeformate.

Der Pipelineschritt kann JSON nicht parsen – Nicht-JSON-Text wird in Standardausgabe angezeigt

Protokolle, Fortschrittsleisten und einige Fehlermeldungen werden in stderr und nicht in hdout gespeichert. Wenn etwas Nicht-JSON auf Standardausgabe festgelegt ist, haben Sie wahrscheinlich beide Streams in dieselbe Datei umgeleitet. Leiten Sie sie separat um:

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

Befehle und Exitcodes

Der Befehl wird mit 0 beendet, aber ich habe erwartet, dass er fehlschlägt

Ein Success Result wird dem Exitcode 0 zugeordnet, auch wenn die Nutzlast leer ist. Beispiel: uip or folders list --all --name Nonexistent beendet 0 mit Data: []. Verzweigung bei Nutzlastform:

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

uip tm Wait wird mit 2 beendet – ist die Authentifizierung fehlgeschlagen?

Nein. tm wait verwendet den Exitcode 2 für die Zeitüberschreitung wieder, nicht für die Authentifizierung. Überprüfen Sie Result im Umschlag, um sie eindeutiger zu machen (AuthenticationError vs TimeoutError). Diese domain-spezifische Wiederverwendung wird unter Exit-Codes aufgeführt.

Die Ausführung der uip-tm-testsets war erfolgreich, aber meine Tests schlagen fehl

Von Natur aus korrekt. tm testsets run beendet 0 , sobald der Orchestrator die Ausführung akzeptiert – das Ergebnis kommt später. Verketten Sie die dreistufige Anleitung:

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; }

Siehe Skriptmuster, UIP-TM-Testsätze und UIP-TM-Ausführungen.

Konfiguration

Änderungen der Umgebungsvariablen werden nicht wirksam

Ein Prozess mit langer Ausführungszeit (ein Agent, ein überwachtes Skript) liest seine Umgebung einmal beim Start. Starten Sie den Prozess nach dem Ändern der Umgebungsvariablen neu. Bei One-Shot-Befehlen liest ein neuer uip -Aufruf immer die aktuelle Umgebung.

Überprüfen Sie den Präfix: CLI-Flag > Umgebungsvariable > integrierter Standard. Siehe Konfiguration.

Shell-Vervollständigung

Die Registerkartenvervollständigung wird nicht abgeschlossen

Öffnen Sie nach uip completion ein neues Terminal, damit die Shell-RC-Datei neu erstellt wird. Wenn es immer noch fehlt, führen Sie uip completion --print aus, um zu sehen, welcher Block uip installiert ist; Vergleichen Sie diese mit Ihrem ~/.zshrc / ~/.bashrc / $PROFILE.

UIP oder Paketupload --Paketname schlägt keine Namen vor

Die dynamische Flag-Wert-Vervollständigung ist nur zsh und erfordert jq auf PATH. Installieren Sie jq , oder wechseln Sie zu zsh. Die statische Vervollständigung von Unterbefehl + Optionsname funktioniert unabhängig in allen vier Shells.

Shell- und CI-Integration

CI-Schritt hängt bei UIP-Anmeldung oder UIP-Fähigkeiten installiert ab

Der Befehl wartet auf eine interaktive Eingabeaufforderung. Übergeben Sie die erforderlichen Flags:

• uip login --tenant <name> (Mandantenauswahl überspringen)
• uip skills install --agent <name> (Agent-Auswahl überspringen)

Wenn Sie nicht sicher sind, welcher Prompt interaktiv ist, führen Sie den fehlgeschlagenen Befehl unter uip --log-level debug … lokal in einem Nicht-Tty-Kontext aus (redirect standard) und überprüfen Sie, welcher Prompt angezeigt wurde.

Uip oder Jobs Start wird sofort zurückgegeben – ich möchte, dass er wartet

Standardmäßig akzeptiert jobs start die Ausführung und wird beendet. --wait-for-completion hinzufügen:

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

Etwas, das ich hier nicht finden konnte

Überprüfen Sie die Referenzseite für den ausgeführten Befehl – jeder hat seine eigenen Exitcodes und einen eigenen Abschnitt mit Beispielen. Durchsuchen Sie dann die Versionshinweise nach einem ähnlichen Symptom. Wenn nichts übereinstimmt, erfassen Sie:

• uip --version
• uip tools list
• Der genaue Befehl und das vollständige ständigrr/stdout
• Das Feld Result aus dem JSON-Umschlag

…und öffnen Sie ein Problem mit dem UiPath-CLI-Team.

Siehe auch

• Beendigungscodes – was jeder Code bedeutet, einschließlich des Sonderfalls tm wait .
• Skriptingmuster – Wiederholung, Abfragen, Streamtrennung, idempotente Pipelines.
• Authentifizierung – die drei Authentifizierungsflüsse im Detail.
• Installieren von UiPath CLI – Fehlerbehebung – installieren Sie spezifische Fehler.