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
- Muestre las versiones al inicio del job (
node --version,docker --version) para que una herramienta ausente falle de forma rápida y clara. - Instale las herramientas con actions de configuración con versión fijada en lugar de suponer que están presentes.
- Mantenga los scripts ejecutables y con terminación LF mediante
.gitattributes. - 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.
Relacionado
- Proceso completado con código de salida 1: cómo depurarlo"Process completed with exit code 1" en GitHub Actions indica que un comando ha fallado. Cómo encontrar el error real, depurarlo y corregir causas comunes.
- Process Completed With Exit Code 143: SIGTERM FixCorrija "Process completed with exit code 143" en GitHub Actions: SIGTERM por cancelación, timeouts, apagado del runner o docker stop, y cómo gestionarlo.
- El proceso '/usr/bin/git' falló con el código de salida 128Corrija "The process '/usr/bin/git' failed with exit code 128" en GitHub Actions: autenticación, refs ausentes, clones superficiales y propiedad dudosa.
- Código de salida 137 en GitHub Actions: solución de memoriaProcess completed with exit code 137 en GitHub Actions indica SIGKILL, normalmente por falta de memoria. Soluciones para Node, Jest, Gradle y Docker.