Solução de Problemas
Esta página contém soluções para problemas comuns que você pode encontrar ao usar o plugin Cloudflare R2 Media & Static CDN. Se você não encontrar a solução para seu problema aqui, não hesite em entrar em contato com nosso suporte.
Problemas de Instalação
O AWS SDK não está sendo reconhecido
Sintomas: Você recebe uma mensagem de erro informando que o AWS SDK não foi encontrado ou não está instalado corretamente.
Solução:
- Verifique se você instalou o AWS SDK corretamente no diretório do plugin.
- Certifique-se de que existe um arquivo 'autoload.php' na pasta vendor/ do plugin.
- Se a instalação automática falhou, tente instalar o SDK manualmente seguindo estas etapas:
- Via FTP:
- Baixe o AWS SDK de https://github.com/aws/aws-sdk-php/releases
- Extraia o arquivo baixado
- Crie uma pasta 'vendor' dentro do diretório do plugin (
wp-content/plugins/r2-assets-cdn/
) - Faça upload da pasta extraída para o diretório 'vendor'
- Certifique-se de que exista um arquivo 'autoload.php' em
vendor/
- Via SSH/Terminal:
cd wp-content/plugins/r2-assets-cdn/ composer require aws/aws-sdk-php
- Via FTP:
- Desative e reative o plugin após instalar o SDK.
Erro ao ativar o plugin
Sintomas: Ocorre um erro quando você tenta ativar o plugin ou o plugin é ativado mas não funciona corretamente.
Solução:
- Verifique se seu servidor atende aos requisitos mínimos (PHP 7.4+, WordPress 5.6+).
- Desative todos os outros plugins e reative-os um por um para identificar conflitos.
- Ative o modo de depuração do WordPress para obter mais informações sobre o erro:
- Edite o arquivo wp-config.php
- Encontre a linha
define('WP_DEBUG', false);
- Altere para
define('WP_DEBUG', true);
- Adicione também:
define('WP_DEBUG_LOG', true);
- Tente ativar o plugin novamente e verifique o arquivo de log debug.log em wp-content/
- Se o problema persistir, tente reinstalar o plugin com uma cópia nova do arquivo.
O plugin está ativo mas não aparece no menu lateral
Sintomas: O plugin está ativado, mas o menu "Cloudflare R2 Media & Static CDN" não aparece no painel administrativo.
Solução:
- Verifique se você está logado como administrador, pois o menu só é visível para usuários com permissões de administrador.
- Tente limpar o cache do navegador e atualizar a página.
- Verifique se há conflitos com outros plugins que modificam o menu administrativo.
- Desative e reative o plugin.
- Se o problema persistir, verifique o arquivo debug.log para possíveis erros.
Problemas de Conexão
Erro de conexão com o R2
Sintomas: O teste de conexão falha ou você recebe mensagens de erro ao tentar enviar arquivos para o R2.
Solução:
- Verifique se as credenciais R2 estão corretas:
- R2 Access Key
- R2 Secret Key
- Nome do bucket R2
- URL do endpoint R2
- Confirme se o bucket R2 existe e está acessível.
- Verifique se o seu servidor pode fazer conexões externas (algumas hospedagens restringem isso).
- Certifique-se de que o token API R2 tem permissões de leitura e escrita.
- Verifique se há firewalls ou regras de segurança bloqueando conexões externas.
Arquivos não estão sendo servidos pelo CDN
Sintomas: O upload de arquivos para o R2 funciona, mas os arquivos não estão sendo servidos pelo CDN.
Solução:
- Verifique se o CDN está ativado nas configurações do plugin.
- Limpe o cache do site e do navegador.
- Verifique se os arquivos foram realmente enviados para o R2:
- Acesse o painel da Cloudflare e verifique se os arquivos estão no bucket.
- Confira as estatísticas de upload no plugin para ver se os arquivos foram registrados como enviados.
- Confirme se a URL do CDN está configurada corretamente e que é acessível.
- Verifique as permissões do bucket R2 (deve ser configurado como público).
- Se você está usando um domínio personalizado para o CDN, verifique se o DNS está configurado corretamente.
Tempo limite excedido durante upload
Sintomas: O processo de upload para o R2 falha com erros de tempo limite.
Solução:
- Reduza o tamanho do lote nas configurações do plugin:
- Para arquivos estáticos, tente reduzir para 20-30 arquivos por lote.
- Para imagens, tente reduzir para 10-15 imagens por lote.
- Aumente o tempo limite do PHP se você tiver acesso ao php.ini ou wp-config.php:
set_time_limit(300);
oumax_execution_time = 300
- Verifique a velocidade de upload da sua conexão com a internet.
- Desative temporariamente a otimização de imagens durante o upload inicial (você pode reprocessá-las depois).
- Se o problema persistir, tente realizar o upload em diferentes momentos do dia quando a rede estiver menos congestionada.
Problemas com Imagens
Imagens não estão sendo convertidas para WebP/AVIF
Sintomas: A otimização de imagens está ativada, mas as imagens não estão sendo convertidas para WebP ou AVIF.
Solução:
- Verifique se a otimização de imagens está ativada (recurso premium).
- Confirme se as opções de conversão para WebP e/ou AVIF estão marcadas nas configurações.
- Verifique se o servidor tem as bibliotecas necessárias:
- GD com suporte a WebP
- Imagick com suporte a WebP/AVIF
- Execute a ferramenta de verificação de ambiente no plugin para confirmar se todas as extensões necessárias estão disponíveis.
- Algumas imagens podem não ser compatíveis com a conversão. Tente com diferentes tipos de imagens.
- Se você está reprocessando imagens existentes, certifique-se de que selecionou a opção de criar versões WebP/AVIF.
Imagens quebradas após ativar o CDN
Sintomas: Após ativar o CDN para imagens, algumas ou todas as imagens aparecem quebradas no site.
Solução:
- Verifique se todas as imagens foram enviadas para o R2 antes de ativar o CDN:
- Compare o número de imagens na biblioteca de mídia com o número de imagens enviadas nas estatísticas do plugin.
- Confirme se a URL do CDN está configurada corretamente.
- Verifique se o bucket R2 está configurado como público.
- Desative temporariamente o CDN para verificar se o problema está relacionado ao plugin:
- Desative o CDN nas configurações do plugin.
- Limpe qualquer cache de página.
- Verifique se as imagens aparecem normalmente a partir do servidor WordPress.
- Verifique se há conflitos com outros plugins de otimização de imagem ou CDN.
- Inspecione as URLs das imagens quebradas no navegador (clique com botão direito > Inspecionar) para ver se há algum erro na URL.
Erros de memória durante otimização de imagens
Sintomas: Durante o processo de otimização de imagens, você recebe erros de memória do PHP.
Solução:
- Aumente o limite de memória do PHP:
- Edite o arquivo wp-config.php e adicione:
define('WP_MEMORY_LIMIT', '256M');
- Se tiver acesso ao php.ini, aumente o valor de memory_limit:
memory_limit = 256M
- Edite o arquivo wp-config.php e adicione:
- Reduza o tamanho do lote nas configurações do plugin.
- Desative temporariamente formatos que exigem muita memória (como AVIF).
- Reduza a qualidade de otimização para imagens grandes.
- Processe as imagens em lotes menores ao longo do tempo.
- Se possível, otimize as imagens localmente antes de fazer upload para o WordPress.
Problemas de Desempenho
Upload de arquivos muito lento
Sintomas: O processo de upload para o R2 está funcionando, mas é extremamente lento.
Solução:
- Verifique a velocidade de upload da sua conexão de internet.
- Reduza o tamanho do lote se o seu servidor tiver recursos limitados.
- Verifique o uso de CPU e memória durante o upload (pode estar sobrecarregando o servidor).
- Desative temporariamente outros plugins intensivos em recursos.
- Tente realizar o upload em horários de menor tráfego.
- Se você está otimizando imagens durante o upload, considere desativar temporariamente essa opção e otimizá-las posteriormente.
- Verifique se há outras tarefas em segundo plano consumindo recursos do servidor.
Site mais lento após ativar o plugin
Sintomas: Após a ativação do plugin e configuração do CDN, o site parece mais lento do que antes.
Solução:
- Verifique se todos os arquivos foram realmente enviados para o R2 antes de ativar o CDN.
- Confirme se a URL do CDN está configurada corretamente.
- Limpe todos os caches (plugin de cache, navegador, etc.).
- Verifique se há conflitos com outros plugins de CDN ou otimização:
- Desative temporariamente outros plugins de CDN ou otimização.
- Verifique se há múltiplas substituições de URL ocorrendo simultaneamente.
- Utilize ferramentas como Google PageSpeed Insights, GTmetrix ou WebPageTest para identificar gargalos específicos.
- Verifique se o Cloudflare R2 está respondendo rapidamente (pode haver problemas regionais temporários).
- Compare o tempo de carregamento de arquivos diretamente do seu servidor e do CDN para identificar onde está o atraso.
Alto uso de CPU/memória durante operações do plugin
Sintomas: O servidor mostra alto uso de CPU ou memória durante operações como upload, escaneamento ou reprocessamento.
Solução:
- Reduza o tamanho do lote nas configurações do plugin.
- Aumentar os recursos do servidor, se possível.
- Agende operações intensivas para horários de baixo tráfego.
- Divida grandes operações em etapas menores.
- Desative temporariamente recursos que exigem muito processamento, como conversão para WebP/AVIF.
- Verifique se há outros processos ou plugins consumindo recursos simultaneamente.
- Considere usar a versão premium para acessar recursos de otimização mais eficientes.
Problemas de Licenciamento
Licença não é aceita
Sintomas: Ao tentar ativar sua licença premium, você recebe uma mensagem de erro informando que a licença é inválida.
Solução:
- Verifique se a chave de licença foi inserida corretamente (sem espaços extras ou caracteres inválidos).
- Confirme se o e-mail associado à licença está correto.
- Verifique se a licença já não está ativa em outro site (cada licença Single Site só pode ser usada em um site por vez).
- Certifique-se de que sua licença não expirou.
- Confirme se o seu site pode se conectar aos servidores de licenciamento (algumas configurações de firewall podem bloquear isso).
- Se o problema persistir, entre em contato com nosso suporte para verificar o status da sua licença.
Recursos premium não funcionam após ativação da licença
Sintomas: Sua licença está ativa, mas os recursos premium não estão disponíveis ou não funcionam corretamente.
Solução:
- Verifique o status da licença na aba de Licenciamento.
- Tente desativar e reativar a licença.
- Certifique-se de que você está usando a versão mais recente do plugin.
- Limpe o cache do WordPress e do navegador.
- Verifique se há conflitos com outros plugins.
- Em casos raros, pode ser necessário reinstalar o plugin (mantenha suas configurações salvando-as antes).