Saltar al contenido

El proceso '/usr/bin/git' falló con el código de salida 128

Última actualización:

The process '/usr/bin/git' failed with exit code 128 significa que git encontró un error fatal y se detuvo. El código 128 de git corresponde a "fatal"; la causa aparece en la línea fatal: justo encima. Suele deberse a actions/checkout o a un comando git en un paso run, y las causas habituales son la autenticación, una referencia inexistente, un clon superficial sin historial o la propiedad de los archivos en un contenedor.

El mensaje exacto

Error: The process '/usr/bin/git' failed with exit code 128

Lea la línea anterior. Las causas más comunes se indican a continuación, cada una con su solución.

fatal: could not read Username o Authentication failed

El trabajo necesita credenciales para un repositorio privado. Consulte could not read Username y Permission denied (publickey).

fatal: repository '...' not found

El valor de la entrada repository: es incorrecto, el repositorio se renombró o se eliminó, o el token no tiene acceso a él. GitHub indica "not found" cuando se trata de un repositorio privado al que no se puede acceder. Compruebe la ortografía y los permisos del token.

fatal: couldn't find remote ref o pathspec ... did not match

La rama, la etiqueta o el SHA solicitados no existen en ese repositorio. Esto ocurre cuando se eliminó una rama tras fusionar una pull request, cuando ref: apunta a un nombre obsoleto o cuando una etiqueta nunca se subió.

- uses: actions/checkout@v4
  with:
    ref: ${{ github.event.pull_request.head.sha }}

En las pull requests desde forks, la rama de origen está en el fork, así que use repository: ${{ github.event.pull_request.head.repo.full_name }} junto con la referencia, y tenga en cuenta las implicaciones de seguridad de ejecutar código de un fork con secretos.

fatal: ... unknown revision tras un clon superficial

Por defecto, actions/checkout obtiene un único commit. Comandos como git log main..HEAD, git describe, git diff origin/main o un generador de changelogs fallan entonces por falta de historial. Obtenga más historial:

- uses: actions/checkout@v4
  with:
    fetch-depth: 0   # full history and tags

fetch-depth: 0 obtiene todo el historial, lo que es más lento en repositorios grandes. Si solo necesita un poco más, indique un número como fetch-depth: 50, o ejecute git fetch --depth=200 origin main antes del comando.

fatal: detected dubious ownership in repository

En un trabajo que se ejecuta en un container:, el espacio de trabajo pertenece a un usuario distinto del que ejecuta git, y git se niega a trabajar en él. Márquelo como seguro:

- run: git config --global --add safe.directory "$GITHUB_WORKSPACE"

Las versiones recientes de actions/checkout lo hacen automáticamente en la mayoría de los casos, así que compruebe también que usa una versión principal actual.

fatal: not a git repository

El paso se ejecutó antes de un checkout o en un directorio incorrecto. Añada primero actions/checkout y revise working-directory.

fatal: unable to access ... The requested URL returned error: 403

Normalmente se debe a un push o fetch sin el permiso adecuado del token. Consulte [Permission denied to github-actions[bot]](/errors/permission-to-repo-denied-to-github-actions-bot).

Submódulos

Un fallo al obtener un submódulo también termina con el código de salida 128. La URL del submódulo puede ser privada (necesita un token), apuntar a un commit que ya no existe en el origen o usar SSH. Ejecute git submodule status en local y compruebe que cada commit fijado existe en su remoto.

Cómo prevenirlo

  1. Fije actions/checkout a una versión principal actual y lea la línea fatal:, no solo el código de salida.
  2. Defina fetch-depth de forma deliberada en los pasos que leen el historial.
  3. Use un token con alcance limitado para cualquier repositorio distinto del actual.
  4. Elimine de los workflows las referencias a ramas que se borran, y use SHA en las compilaciones de pull requests.
  5. Mantenga los punteros de los submódulos en commits que estén subidos.

Preguntas frecuentes

¿Qué significa el código de salida 128 en git?

Un error fatal. Git muestra un mensaje fatal: que lo explica y termina con 128.

¿Por qué aparece /usr/bin/git?

actions/checkout y otras actions ejecutan git como proceso hijo, y el runner indica qué proceso falló y con qué código.

¿Es una caída de GitHub?

Si fallan muchos workflows no relacionados al obtener código al mismo tiempo, consulte la página de estado de GitHub. En caso contrario, la línea fatal: apunta a su configuración.

¿Debo volver a ejecutarlo?

Solo si el mensaje parece un error de red o del servidor (como RPC failed o early EOF). Los errores de autenticación y de referencias inexistentes volverán a fallar.