Upload de mídia no WordPress: corrigir quando falha

Tipo Erro interno do WP

Nome do erro Upload de mídia não funciona EN: Media upload not working

Severidade Grave

Descrição 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.

O que é o upload de mídia que não funciona?

O upload de mídia que não funciona é quando o WordPress recusa ou interrompe o envio de um arquivo para a Biblioteca de Mídia. O fluxo de upload depende de três coisas no servidor: a pasta wp-content/uploads precisa ter permissão de escrita, o arquivo precisa caber nos limites de tamanho do PHP, e precisa haver memória suficiente para o WordPress gerar as miniaturas. Se qualquer uma falha, o envio para sem completar.

Como identificar

Mensagem “Unable to create directory uploads. Is its parent directory writable by the server?”.
Mensagem “The uploaded file could not be moved to wp-content/uploads.”.
A barra de progresso do upload chega ao fim e o arquivo simplesmente não aparece na biblioteca.
Imagens grandes falham, mas arquivos pequenos sobem normalmente (sintoma de limite de tamanho).

Antes de começar: Nunca use permissão 777 na pasta uploads para forçar o upload: isso deixa o diretório gravável por qualquer um e é uma porta para malware. O valor correto é 755 para a pasta com o dono certo. Faça backup antes de alterar permissões em massa.

Como prevenir

Mantenha wp-content/uploads em 755 com o dono correto após cada migração de hospedagem
Deixe upload_max_filesize e post_max_size com folga (64M ou mais) para imagens grandes
Redimensione fotos antes de enviar e use otimização de imagem para não esbarrar nos limites

Causa

Permissões erradas na pasta wp-content/uploads (precisa ser 755 e pertencer ao usuário do servidor web).
Limite upload_max_filesize ou post_max_size do PHP menor que o arquivo enviado.
Memória PHP insuficiente para o WordPress redimensionar a imagem e gerar miniaturas.
Dono (ownership) do diretório incorreto após uma migração de hospedagem.
Plugin de segurança ou de otimização de imagem interceptando e bloqueando o upload.

Como resolver

Cheque o limite de tamanho: em Mídia > Adicionar nova, veja o "Tamanho máximo de upload". Se o seu arquivo for maior que esse valor, o limite do servidor é a causa e precisa ser elevado.
Corrija as permissões via FTP: aplique a permissão padrão na pasta de uploads, recursivamente:
```
chmod 755 wp-content/uploads
chmod 644 nos arquivos dentro de uploads
```
Confirme o dono da pasta: peça ao suporte da hospedagem para verificar se wp-content/uploads pertence ao usuário do servidor web (geralmente www-data). Dono errado bloqueia a escrita mesmo com 755.
Aumente a memória PHP: edite o wp-config.php para dar memória suficiente ao processamento da imagem:
```
define('WP_MEMORY_LIMIT', '256M');
```
Teste sem plugins: desative plugins de segurança e de otimização de imagem via FTP. Se o upload voltar, reative um a um para achar qual intercepta o envio.

INI

; php.ini (ou .user.ini na raiz) — eleva os limites que travam o upload de midia
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300
max_input_time = 300

Perguntas frequentes

O que significa Unable to create directory uploads?

Significa que o WordPress tentou criar ou gravar na pasta wp-content/uploads e o servidor recusou por falta de permissão de escrita. Quase sempre é permissão diferente de 755 ou dono (ownership) errado no diretório.

Só imagens grandes falham no upload. Por quê?

É o limite de tamanho do servidor. Quando arquivos pequenos sobem e os grandes falham, o upload_max_filesize ou o post_max_size do PHP está menor que a imagem. Eleve esses dois valores no php.ini ou .user.ini.

Como descubro o tamanho máximo de upload do meu site?

Vá em Mídia > Adicionar nova: o WordPress mostra o "Tamanho máximo de upload" calculado a partir dos limites do PHP. Esse número diz exatamente até quantos MB o servidor aceita por arquivo.

Permissão 777 resolve o problema de upload?

Resolve o sintoma, mas cria um risco grave de segurança: 777 deixa a pasta gravável por qualquer processo, abrindo caminho para malware. Use 755 com o dono correto do diretório, que é o valor seguro e suficiente.

Falta de memória PHP pode impedir o upload?

Sim. Depois de receber o arquivo, o WordPress precisa de memória para redimensionar a imagem e gerar miniaturas. Se o WP_MEMORY_LIMIT for baixo, o processamento falha no meio e a imagem não entra na biblioteca.

O upload parou logo após migrar de hospedagem. O que mudou?

Na migração, o dono e as permissões da pasta uploads costumam mudar. O novo servidor pode usar outro usuário web. Reaplique 755 na pasta, 644 nos arquivos e confirme o ownership com o suporte do host.

Grave

Como corrigir Publishing failed / Updating failed (REST API)

A falha ao publicar no WordPress (Publishing failed / Updating failed) acontece quando o editor de blocos não consegue falar com a REST API. O Gutenberg salva o post por uma chamada à REST API em /wp-json/; quando essa rota é bloqueada ou responde algo diferente de JSON, o editor exibe o erro mesmo com o conteúdo correto.

Atenção

Como corrigir widgets que desapareceram após atualização

Widgets que desapareceram no WordPress após uma atualização costumam ser efeito da tela de widgets em blocos, introduzida no WordPress 5.8. Os widgets continuam no banco; o que muda é a interface, e às vezes um tema FSE remove de vez as áreas de widget clássicas.

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.

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 Destination folder already exists no WordPress

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.

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.

Setores

Extensões

Integrações

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

O que é o upload de mídia que não funciona?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir Publishing failed / Updating failed (REST API)

Como corrigir widgets que desapareceram após atualização

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

Como corrigir permalinks retornando 404

Como corrigir Destination folder already exists no WordPress

Como corrigir o loop Update WordPress Database

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