Cómo solucionar el error 'git push rejected non-fast-forward' de forma segura

✨ Respuesta Rápida

El error [rejected - non-fast-forward] o updates were rejected because the remote contains work that you do not have locally ocurre cuando intentas enviar commits locales a una rama remota en Git, pero el servidor remoto contiene commits más recientes que tu rama local no posee.

El error [rejected - non-fast-forward] o updates were rejected because the remote contains work that you do not have locally ocurre cuando intentas enviar commits locales a una rama remota en Git, pero el servidor remoto contiene commits más recientes que tu rama local no posee.

El Diagnóstico Rápido

Causa

error: failed to push some refs ... [rejected - non-fast-forward]: El repositorio remoto tiene commits en la rama que no han sido integrados en tu copia local

Solución

Ejecutar git pull --rebase origin <rama> para aplicar los cambios remotos antes del git push

La Solución Paso a Paso

1. 1

   Paso 1: Obtener e integrar las actualizaciones remotas con Rebase

   En lugar de realizar un merge convencional que crea un commit de cruce desordenado, utiliza git pull --rebase para colocar tus nuevos commits locales encima del historial remoto actualizado:

   BASH Copiar

   # Reemplaza 'main' por el nombre de tu rama (p. ej., dev o feature/login)
   git pull --rebase origin main
   

   Si prefieres hacerlo en dos pasos separados para inspeccionar las diferencias antes de fusionar:

   BASH Copiar

   git fetch origin
   git rebase origin/main
   

2. 2

   Paso 2: Resolver posibles conflictos de código

   Si existen archivos modificados simultáneamente en local y remoto, Git pausará el proceso de rebase. Abre los archivos marcados con conflicto, resuelve las diferencias y ejecuta:

   BASH Copiar

   # Marcar los archivos resueltos
   git add .
   
   # Continuar el proceso de rebase
   git rebase --continue
   

3. 3

   Paso 3: Enviar tus cambios al servidor remoto

   Una vez que tu rama local esté sincronizada y rebasada sobre el último commit remoto, realiza el envío de tus cambios de forma segura:

   BASH Copiar

   git push origin main
   

   Si reescribiste commits locales existentes y necesitas actualizar el remoto en una rama de trabajo personal, evita git push --force y utiliza la opción segura:

   BASH Copiar

   git push origin main --force-with-lease