~ / hub / erros / git push rejected (non-fast-forward)
4 out 2026errosguia de solução

git push rejected (non-fast-forward)

O remoto tem commits que você não tem. Integre antes de enviar.

1. Significado

! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'github.com:equipe/repo.git'
hint: Updates were rejected because the remote contains work that you do not have locally.

Alguém (ou você, em outra máquina) enviou commits para essa branch depois da sua última sincronização. O Git recusa o push porque ele apagaria esse histórico do remoto.

2. Solução segura: integrar e enviar

git fetch origin
git log --oneline HEAD..origin/main     # o que chegou no remoto
git pull --rebase origin main           # reaplica seus commits por cima
git push origin main

Com --rebase, o histórico fica linear; com git pull padrão, cria-se um commit de merge. Ambos funcionam; a equipe deve combinar um padrão. Compare em merge vs rebase.

3. Se aparecerem conflitos

  • O rebase pausa no commit conflitante. Edite os arquivos, rode git add arquivo e continue com git rebase --continue.
  • Para desistir e voltar ao estado anterior: git rebase --abort.
  • Passo a passo em Merge conflict no Git.

4. Quando force push é aceitável

Depois de reescrever sua própria branch (rebase interativo, amend) e de ninguém mais usá-la:

git push --force-with-lease origin minha-branch

O --force-with-lease só sobrescreve se o remoto estiver exatamente como você o viu pela última vez, evitando apagar o trabalho de outra pessoa. Nunca use force push em main/master compartilhadas — e configure proteção de branch no GitHub/GitLab.

PREVENÇÃO Faça git pull --rebase antes de começar a trabalhar e antes de enviar. Branches curtas e commits pequenos reduzem conflitos. Fluxo recomendado: Git no fluxo de produção.

Continue explorando

← erros · Merge conflict · Detached HEAD · Merge vs rebase · Roadmap Git

Veja também o hub de conteúdo, o glossário e os cursos gratuitos.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →