Saltar al contenido

Process Completed With Exit Code 127: Command Not Found

Última actualización:

Process completed with exit code 127 significa que el shell no pudo encontrar el comando que se le pidió ejecutar. Busque unas líneas más arriba command not found o No such file or directory. Las causas son una herramienta que no está instalada en el runner, un PATH que no la incluye, una ruta de script incorrecta o un archivo de script con saltos de línea de Windows.

El mensaje exacto

/home/runner/work/_temp/abc123.sh: line 1: pnpm: command not found
Error: Process completed with exit code 127.
./deploy.sh: No such file or directory
Error: Process completed with exit code 127.

Causa 1: la herramienta no está instalada en el runner

Las imágenes alojadas incluyen muchas herramientas, pero no todas. Consulte la lista de software de las imágenes de runner para la etiqueta runs-on que utiliza, e instale lo que falte con una action de configuración o un gestor de paquetes:

- uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
  with:
    node-version: 22
    cache: pnpm
- run: pnpm install --frozen-lockfile

Para paquetes del sistema en Ubuntu:

- run: sudo apt-get update && sudo apt-get install -y jq

Si pasó de ubuntu-latest a un runner autoalojado o de terceros, es posible que la imagen no tenga algunas herramientas que sí incluye la imagen de GitHub. Compare ambas antes de cambiar.

Causa 2: está instalada, pero no en PATH

Una herramienta instalada en un paso no está en PATH en el siguiente, a menos que agregue su directorio al archivo GITHUB_PATH. No utilice export PATH=... para esto, porque solo afecta al paso actual:

- run: |
    curl -fsSL https://example.com/tool.tar.gz | tar xz -C "$HOME/tool"
    echo "$HOME/tool/bin" >> "$GITHUB_PATH"
- run: tool --version

Causa 3: ruta de script incorrecta o falta el bit de ejecución

./script.sh: No such file or directory y Permission denied indican que la ruta es incorrecta respecto al directorio de trabajo, o que el archivo no es ejecutable. Revise working-directory y haga el archivo ejecutable en git:

chmod +x scripts/deploy.sh
git update-index --chmod=+x scripts/deploy.sh

O llámelo a través del intérprete, lo que no requiere el bit de ejecución: run: bash scripts/deploy.sh.

Causa 4: saltos de línea de Windows (CRLF)

Un script guardado con saltos de línea CRLF tiene un retorno de carro oculto en su línea shebang, así que el sistema busca un intérprete llamado bash\r e informa "No such file or directory" aunque el archivo exista. Conviértalo:

sed -i 's/\r$//' scripts/deploy.sh

y evite que vuelva a ocurrir con un archivo .gitattributes:

*.sh text eol=lf

Causa 5: una errata o un shell incorrecto

Los nombres de los comandos distinguen mayúsculas y minúsculas en Linux. Un paso con shell: pwsh ejecuta PowerShell, que tiene comandos distintos a bash, y un paso con shell: cmd no puede ejecutar sintaxis de bash.

Causa 6: falta un binario dentro de un job en contenedor

Cuando un job usa container:, las herramientas proceden de esa imagen, no del runner. Utilice una imagen que incluya lo que necesita.

Cómo prevenirlo

  1. Muestre las versiones al inicio del job (node --version, docker --version) para que una herramienta ausente falle de forma rápida y clara.
  2. Instale las herramientas con actions de configuración con versión fijada en lugar de suponer que están presentes.
  3. Mantenga los scripts ejecutables y con terminación LF mediante .gitattributes.
  4. Ejecute el mismo paso en un contenedor limpio de forma local para detectar suposiciones sobre su equipo.

Preguntas frecuentes

¿Qué significa el código de salida 127?

"Command not found" en los shells POSIX. Se devuelve cuando el shell no puede encontrar o ejecutar el programa.

¿Por qué el comando funciona en mi equipo?

Su equipo tiene la herramienta instalada y en PATH. Un runner está limpio y cada paso se inicia en un shell nuevo.

¿Cuál es la diferencia entre 126 y 127?

126 significa que el archivo se encontró pero no se pudo ejecutar, a menudo por permisos. 127 significa que no se encontró en absoluto.

¿La configuración difiere en los runners de Windows y macOS?

Sí. Las listas de herramientas varían según la imagen, así que consulte la lista de software de la etiqueta que utiliza.