Destination folder exists no WordPress: como corrigir

Tipo Erro interno do WP

Nome do erro Destination folder already exists EN: Destination folder already exists

Severidade Atenção

Descrição Destination folder already exists aparece quando você instala um plugin ou tema cuja pasta de destino já existe em wp-content. O WordPress se recusa a sobrescrever a pasta existente e interrompe a instalação. Costuma ocorrer após uma instalação ou atualização anterior que falhou no meio e deixou a pasta para trás.

O que é o erro Destination folder already exists?

Ao instalar um plugin ou tema, o WordPress descompacta o pacote e cria uma pasta dentro de wp-content/plugins ou wp-content/themes. Para evitar perder dados, ele não sobrescreve uma pasta que já exista com o mesmo nome: em vez disso, aborta com Destination folder already exists. A causa quase sempre é uma instalação anterior interrompida (por timeout ou falta de memória) que deixou a pasta de destino meio criada. O site continua funcionando; só a nova instalação fica travada até a pasta antiga ser removida.

Como identificar

Mensagem “Destination folder already exists.” seguida de “Plugin installation failed.” ao instalar pelo painel.
Em sites em português, a mensagem “A pasta de destino já existe.”.
O caminho citado na mensagem aponta para wp-content/plugins/nome-do-plugin ou wp-content/themes/nome-do-tema.
A tentativa anterior de instalar ou atualizar o mesmo item havia falhado por timeout ou erro de memória.

Antes de começar: Antes de apagar a pasta de um plugin que guarda dados em arquivo (como alguns plugins de cache, galeria ou formulário), confirme se não há configurações ou uploads dentro dela. Renomear em vez de apagar protege contra a perda acidental desses arquivos.

Como prevenir

Aumente o limite de memória e o tempo de execução do PHP para as instalações não falharem no meio
Sempre desinstale plugins pelo painel, que remove a pasta junto, em vez de apenas desativar
Evite subir a pasta do plugin por FTP e instalar pelo painel ao mesmo tempo, para não duplicar o destino

Causa

Instalação ou atualização anterior do plugin ou tema interrompida no meio, deixando a pasta de destino criada mas incompleta.
Upload manual da pasta via FTP feito antes de tentar a instalação pelo painel, gerando duplicidade.
Atualização que esgotou o tempo de execução ou a memória do PHP antes de mover os arquivos finais.
Pasta órfã de uma versão antiga do plugin que não foi removida ao desinstalar pelo painel.
Restauração parcial de backup que recolocou a pasta do plugin sem registrar a instalação no WordPress.

Como resolver

Anote o nome exato da pasta: leia o caminho na mensagem Destination folder already exists. Ele indica a pasta exata em wp-content/plugins ou wp-content/themes que está bloqueando a instalação.
Conecte via FTP ou gerenciador de arquivos: acesse o servidor pelo cliente FTP ou pelo gerenciador de arquivos da hospedagem e navegue até wp-content/plugins (ou wp-content/themes), onde a pasta órfã está.
Renomeie a pasta antes de apagar: como precaução, renomeie a pasta para algo como nome-do-plugin-old em vez de apagar direto. Assim, se algo der errado, você consegue voltar atrás sem perder nada.
Remova a pasta e instale de novo: confirmada a renomeação, apague a pasta órfã e volte ao painel para instalar o plugin ou tema novamente. Sem a pasta de destino, o WordPress conclui a instalação.
Use WP-CLI se preferir a linha de comando: com acesso SSH, o WP-CLI instala sobrescrevendo a pasta existente com a flag de força, sem precisar apagar manualmente. Veja o comando no bloco de código.

BASH

# Via SSH com WP-CLI: instala/atualiza sobrescrevendo a pasta que ja existe.
# Troque "nome-do-plugin" pelo slug real do plugin.
wp plugin install nome-do-plugin --force

# Para um tema, o equivalente e:
wp theme install nome-do-tema --force

# Sem WP-CLI, remova a pasta orfa manualmente antes de reinstalar pelo painel:
rm -rf wp-content/plugins/nome-do-plugin

Perguntas frequentes

Por que o WordPress não sobrescreve a pasta sozinho?

Para proteger seus dados. Se ele sobrescrevesse uma pasta existente, poderia apagar configurações ou uploads guardados ali por uma instalação anterior. Por segurança, ele aborta com Destination folder already exists e deixa você decidir o que fazer com a pasta.

É seguro apagar a pasta que aparece no erro?

Na maioria dos casos sim, porque é uma pasta órfã de uma instalação que falhou. Mas alguns plugins guardam dados dentro da própria pasta. Por isso o ideal é renomear para nome-do-plugin-old antes de apagar, garantindo que você possa voltar atrás se precisar.

O erro apareceu durante uma atualização. O que houve?

A atualização provavelmente esgotou o tempo de execução ou a memória do PHP antes de terminar de mover os arquivos, deixando a pasta de destino criada mas incompleta. Remover essa pasta e instalar de novo, com mais memória disponível, resolve.

Dá para resolver sem FTP?

Dá, se você tem acesso SSH com WP-CLI: o comando wp plugin install com a flag --force sobrescreve a pasta existente automaticamente. Sem FTP nem SSH, o gerenciador de arquivos do painel da hospedagem também permite renomear e apagar a pasta órfã.

Apaguei a pasta e o plugin sumiu da lista. Perdi as configurações?

As configurações da maioria dos plugins ficam no banco de dados, não na pasta, então elas costumam voltar ao reinstalar a mesma versão. Apenas plugins que guardam dados em arquivo dentro da própria pasta perdem esses dados, por isso o passo de renomear antes é importante.

Como evito que esse erro volte a acontecer?

Garanta memória e tempo de execução suficientes no PHP para as instalações concluírem sem timeout. Sempre desinstale plugins pelo painel, que remove a pasta junto, e evite subir a pasta por FTP e instalar pelo painel ao mesmo tempo, o que duplica o destino.

Atenção

Como corrigir Missing a temporary folder

Missing a temporary folder aparece quando o PHP não encontra a pasta temporária onde guarda os arquivos durante um upload. Sem esse diretório, ou sem permissão de escrita nele, o WordPress não consegue receber imagens, plugins ou temas e devolve esse erro.

Grave

Como corrigir permalinks retornando 404

Permalinks retornando 404 é quando só a página inicial abre e todos os posts e páginas internas dão erro 404. Quase sempre as regras de reescrita do WordPress foram perdidas ou o .htaccess ficou sem as linhas que traduzem as URLs amigáveis para o WordPress.

Atenção

Como corrigir o loop Update WordPress Database

O loop Update WordPress Database acontece quando o WordPress pede para atualizar o banco a cada visita e a tela nunca é superada, mesmo depois de clicar no botão. Em geral é causado por cache servindo a tela antiga ou por um descompasso na versão do banco que a rotina de atualização não consegue gravar.

Grave

Como sair do modo de manutenção travado

O modo de manutenção travado acontece quando uma atualização de plugin, tema ou núcleo é interrompida no meio e o WordPress não chega a remover o arquivo .maintenance da raiz do site. Com esse arquivo presente, o site mostra a mensagem de manutenção a todos os visitantes até que o arquivo seja apagado manualmente.

Grave

Como corrigir mídia que não faz upload no WordPress

Quando o upload de mídia no WordPress falha, a imagem ou arquivo não chega à Biblioteca de Mídia. As causas mais comuns são permissões erradas na pasta wp-content/uploads, o limite de tamanho de upload do servidor abaixo do arquivo enviado, ou memória PHP insuficiente para processar a imagem.

Grave

Como corrigir atualização automática do WordPress que falha

A atualização automática falha quando o WordPress não consegue concluir sozinho a atualização de núcleo, plugins ou temas. As causas mais comuns são permissões de arquivo que bloqueiam a escrita, o WP-Cron que não dispara e a falta de acesso direto ao sistema de arquivos do servidor.

Setores

Extensões

Integrações

Como corrigir Destination folder already exists no WordPress

O que é o erro Destination folder already exists?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir Missing a temporary folder

Como corrigir permalinks retornando 404

Como corrigir o loop Update WordPress Database

Como sair do modo de manutenção travado

Como corrigir mídia que não faz upload no WordPress

Como corrigir atualização automática do WordPress que falha

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos