Solución de problemas

Errores comunes, sus causas y cómo solucionarlos. Cada sección enumera primero el mensaje de error o síntoma, luego lo que significa y qué hacer.

Instalación

uip: comando no encontrado después de npm install -g

El prefijo global npm no está en su PATH. Encuéntralo:

npm config get prefix

En macOS/Linux, añade el prefijo devuelto + /bin a tu perfil de shell (~/.zshrc, ~/.bashrc). En Windows, %APPDATA%\npm debería estar activado PATH de forma predeterminada: abre un nuevo terminal para recoger la actualización.

Referencia completa: Instalar UiPath CLI — Solución de problemas.

EACCES: permiso denegado durante la instalación

Está intentando escribir en un prefijo npm propiedad del sistema. No utilices sudo. En su lugar, establece un prefijo local de usuario:

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

Autenticación

ErrorDeAutenticación (código de salida 2) en cada comando

No hay sesión válida. O bien:

• Ejecuta uip login para iniciar una sesión interactiva, o
• En CI, pasa Credenciales de aplicación externa: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT", o
• Para contenedores con un token preemitido: establece UIPATH_CLI_ENABLE_ENV_AUTH=true más las variables UIPATH_CLI_AUTH_TOKEN / UIPATH_CLI_ORGANIZATION_* / UIPATH_CLI_TENANT_* .

Comprobar estado: uip login status.

Consulta Autenticación.

Token caducado o caducado en estado de inicio de sesión de UIP

El token de actualización ya no es válido, generalmente después de semanas de inactividad o un cierre de sesión forzado por el administrador. Vuelve a ejecutar uip login.

Para env-var auth, el token es uip a; rotar UIPATH_CLI_AUTH_TOKEN desde el lado emisor.

No se ha seleccionado ningún tenant después de iniciar sesión en UIP

El inicio de sesión se completó sin una opción de tenant: se canceló el selector o se pasó --tenant pero el valor no coincide con ningún tenant accesible. Vuelva a intentarlo con uip login --interactive para elegir de una lista, o uip login --tenant <exact-name>.

UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET env vars parecen ignorarse

Lo son. UiPath CLI eliminó la lectura implícita de env-var para estos valores. Pasa explícitamente:

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

El prefijo env. indica uip que resuelva desde el entorno en tiempo de ejecución, sin exponer el valor en la línea de comandos.

Herramientas

Herramienta ' no instalado: intentando instalar automáticamente

Informativo: el host está descargando una herramienta en el primer uso. Las llamadas posteriores reutilizan la copia instalada. Para evitar este mensaje de registro en CI, preinstala:

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

Consulta Controlar la instalación automática de la herramienta.

Error al instalar automáticamente ' '

Error en la descarga de la herramienta. Causas comunes:

• Sin red : compruebe la conectividad o la configuración de proxy.
• El proxy corporativo bloquea npm : establece HTTPS_PROXY=http://proxy.example.com:8080.
• Registro npm no resoluble : verifique npm config get registry puntos en algún lugar accesible.

Reintentar manualmente: uip tools install <verb>.

Los comandos de herramientas desaparecen de uip --help después de una actualización

La versión de la herramienta no está en consonancia con la del host. Corrección:

uip tools update

Esto lleva cada herramienta instalada a la última versión dentro de la línea MAYOR.MENOR del host. Consulta Control de versiones y estabilidad.

ErrorDeValidación: paquete ' ' no está en la lista blanca

Ha intentado instalar una herramienta que no es @uipath/. 1.x solo admite el conjunto en la lista blanca; las herramientas de terceros aún no están disponibles.

Salida y filtrado

ErrorDeValidación: no válido --filtro de salida (salida 3)

No se pudo analizar la expresión JMESPath. La CLI valida en tiempo de análisis antes de ejecutar el comando: corrige el filtro y vuelve a intentarlo. Referencia de JMESPath: jmespath.org.

Un error común: --output-filter "Data.Jobs[0].Key" funciona, pero --output-filter "Data.Jobs[-1].Key" no: JMESPath [-1] no es compatible. Usa Data.Jobs | [-1:][0].Key en su lugar o posprocesa con jq.

Esperaba una tabla, pero obtuve JSON

La salida predeterminada es JSON. Pase --output table para la vista de lectura fácil. Consulta Formatos de salida.

El paso del proceso no puede analizar JSON: aparece texto que no es JSON en la salida estándar

Los registros, las barras de progreso y algunos mensajes de error van a stderr, no a stdout. Si hay algo que no es JSON en la salida estándar, probablemente hayas redirigido ambos flujos al mismo archivo. Redirigirlos por separado:

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

Comandos y códigos de salida

El comando sale con 0, pero esperaba que fallara

Un Success Result se asigna al código de salida 0 incluso cuando la carga útil está vacía. Por ejemplo, uip or folders list --all --name Nonexistent sale de 0 con Data: []. Rama en forma de carga útil:

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

uip tmwait sale con 2: ¿falló la autenticación?

No. tm wait reutiliza el código de salida 2 para el tiempo de espera, no para la autenticación. Marque Result en el sobre para eliminar la ambigüedad (AuthenticationError frente a TimeoutError). Esta reutilización específica del dominio se enumera en Códigos de salida.

la ejecución de los conjuntos de pruebas de uip tm se realizó correctamente, pero mis pruebas fallan

Corregir por diseño. tm testsets run sale de 0 una vez que Orchestrator acepta la ejecución; el veredicto llega más tarde. Encadena el idioma de tres pasos:

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

Consulta Patrones de scripts, conjuntos de pruebas de uip tm y ejecuciones de uip tm.

Configuración

Los cambios en las variables de entorno no tienen efecto

Un proceso de larga duración (un agente, un script observado) lee su entorno una vez al inicio. Reinicia el proceso después de cambiar las variables de entorno. Para los comandos de un solo uso, una nueva invocación uip siempre lee el entorno actual.

Verifica la prioridad: indicador CLI > variable de entorno > valor predeterminado integrado. Consulta Configuración.

Finalización del shell

La finalización de la pestaña no se completa

Abre un nuevo terminal después de uip completion para que se vuelva a asignar el origen al archivo rc del shell. Si aún falta, ejecuta uip completion --print para ver qué bloque uip cree que está instalado; compáralo con tu ~/.zshrc / ~/.bashrc / $PROFILE.

uip o carga de paquetes --package-name no sugiere nombres

La finalización dinámica del valor del marcador es solo zsh y necesita jq en el PATH. Instala jq o cambia a zsh. El subcomando estático + la finalización del nombre de la opción funciona en los cuatro shells independientemente.

Integración de Shell y CI

El paso de CI se bloquea al iniciar sesión en UIP o en la instalación de habilidades de UIP

El comando está esperando una solicitud interactiva. Pasa los marcadores necesarios:

• uip login --tenant <name> (omitir selector de tenant)
• uip skills install --agent <name> (omitir selector de agente)

Si no estás seguro de qué solicitud es interactiva, ejecuta el comando que falla en uip --log-level debug … localmente en un contexto no TTY (redireccionar stdout) e inspecciona qué solicitud apareció.

uip o job start devuelve inmediatamente: quería que esperara

De forma predeterminada, jobs start acepta la ejecución y sale. Añadir --wait-for-completion:

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

Algo que no pude encontrar aquí

Consulta la página de referencia del comando que estás ejecutando: cada uno tiene su propia sección de códigos de salida y ejemplos. A continuación, busca en las notas de la versión un síntoma similar. Si nada coincide, recopila:

• uip --version
• uip tools list
• El comando exacto y el stderr/stdout completo
• El campo Result del sobre JSON

…y abre una incidencia con el equipo de UiPath CLI.

Ver también

• Códigos de salida : lo que significa cada código, incluido el caso especial tm wait .
• Patrones de scripting : reintento, sondeo, separación de flujo, procesos idempotentes.
• Autenticación : los tres flujos de autenticación en detalle.
• Instalar UiPath CLI — Resolución de problemas — errores específicos de la instalación.