Como corrigir o erro de Local Google Fonts no Perfmatters
O que é erro de Local Google Fonts no Perfmatters?
O Local Google Fonts é uma opção da aba Fonts do Perfmatters que baixa os arquivos das Google Fonts usadas na página e os serve a partir do seu próprio servidor, no diretório de uploads do WordPress. Em vez de o navegador buscar a fonte em fonts.googleapis.com e fonts.gstatic.com, ele passa a carregar o arquivo local, o que remove requisições externas, melhora o tempo de carregamento e ajuda na conformidade com a LGPD e o GDPR ao parar de enviar o IP do visitante para o Google.
O erro aparece quando essa captura falha. O Perfmatters localiza as fontes que ele consegue detectar no HTML e no CSS enfileirado, mas quando o tema, um page builder como Elementor ou Astra, ou outro plugin de cache carrega a fonte por um caminho que o Perfmatters não inspeciona, as requisições continuam indo para o Google, a fonte volta para uma fallback do sistema, ou a tipografia muda de forma inesperada. O resultado é a sensação de que o recurso simplesmente não funciona.
Como identificar
- No relatório do PageSpeed Insights ou na aba Network do navegador ainda aparecem requisições para ‘fonts.googleapis.com’ e ‘fonts.gstatic.com’ mesmo com o Local Google Fonts ativado.
- A tipografia do site muda depois de ativar a opção: o texto passa a usar uma fonte de sistema (fallback) em vez da fonte original do tema.
- Pesos ou estilos específicos da fonte (por exemplo o itálico ou o peso 700) somem, enquanto o peso regular continua aparecendo.
- O Console do navegador mostra erro 404 ao tentar carregar um arquivo de fonte dentro de ‘/wp-content/uploads/perfmatters/’.
- As fontes voltam ao normal quando o cache da página é limpo, mas a versão em cache antiga continua chamando o Google para outros visitantes.
Como prevenir
- Centralize o carregamento das Google Fonts em um único ponto, de preferência enfileirado pelo WordPress, para que o Perfmatters consiga detectar e localizar todas as fontes do site.
- Use apenas um plugin para otimizar fontes: deixe o Perfmatters cuidar das Google Fonts e desative essa mesma função em qualquer plugin de cache concorrente.
- Sempre limpe o cache do site e do CDN após ativar ou alterar a opção Local Google Fonts, para não servir CSS antigo que ainda aponta para o Google.
- Valide o resultado na aba Network do navegador e no PageSpeed Insights após cada mudança, confirmando que não restam requisições para fonts.googleapis.com nem fonts.gstatic.com.
Causa
- O tema ou page builder (como Elementor, Astra ou Oxygen) carrega a Google Font pelo próprio painel de tipografia, e não pela fila de estilos padrão do WordPress, então o Perfmatters não detecta essa fonte para baixá-la e localizá-la.
- A fonte é injetada por um '@import' dentro de um arquivo CSS do tema ou por uma tag link adicionada via JavaScript, caminhos que o Local Google Fonts não inspeciona, mantendo a requisição apontada para o Google.
- Um plugin de cache ou de otimização ativo ao mesmo tempo (WP Rocket, Autoptimize ou LiteSpeed) também manipula as fontes e serve um CSS antigo, sobrescrevendo ou ignorando os arquivos locais gerados pelo Perfmatters.
- O diretório '/wp-content/uploads/perfmatters/' não tem permissão de escrita, então o Perfmatters não consegue salvar os arquivos de fonte baixados e cai de volta para a versão remota do Google.
- A página foi salva em cache antes de o Local Google Fonts ser ativado, e essa cópia em cache continua entregando o CSS com as URLs originais do Google até o cache ser limpo.
Como resolver
- Confirme que o Local Google Fonts está ativado e regenere: Abra as configurações do Perfmatters, vá até a aba Fonts e confirme que a opção Local Google Fonts está marcada. Salve novamente para forçar o plugin a varrer a página e baixar os arquivos de fonte atualizados.
Painel WP -> Configurações -> Perfmatters -> aba Fonts Marque a opção 'Local Google Fonts' e clique em Save Changes - Limpe todo o cache do site: Uma cópia em cache antiga continua entregando o CSS com as URLs do Google. Limpe o cache do Perfmatters e o de qualquer plugin de cache adicional, além do cache do CDN se houver, para que a próxima requisição use os arquivos de fonte locais.
Painel WP -> Configurações -> Perfmatters -> aba Tools -> Clear Local Fonts Cache Limpe também o cache do plugin de cache ativo (WP Rocket, LiteSpeed ou similar) Purgue o cache do CDN ou do Cloudflare, se estiver em uso - Carregue a fonte pelo WordPress, não pelo tema: Se o tema ou page builder define a fonte no painel de tipografia, o Perfmatters não a captura. Configure a tipografia para usar uma fonte de sistema no builder e enfileire a Google Font pelo WordPress, para que o Perfmatters consiga detectá-la e localizá-la.
No Elementor: Configurações do Site -> Tipografia -> defina Default Fonts como System No Astra: Aparência -> Personalizar -> Tipografia -> evite o seletor de Google Fonts embutido Enfileire a fonte pelo functions.php com wp_enqueue_style (ver bloco de código) - Verifique a permissão do diretório de fontes: O Perfmatters salva os arquivos baixados em uma subpasta de uploads. Se a pasta não tiver permissão de escrita, nenhum arquivo local é criado e a fonte volta para o Google. Garanta a permissão de escrita no diretório.
Confirme que a pasta wp-content/uploads/perfmatters/ existe e é gravável Via SSH ou gerenciador de arquivos, ajuste a permissão da pasta para 755 chmod 755 wp-content/uploads/perfmatters - Isole conflito com outro plugin de otimização: Se outro plugin também manipula fontes ou CSS, os dois entram em conflito. Desative a otimização de fontes do outro plugin e deixe apenas o Perfmatters cuidar das Google Fonts, recarregando a página para confirmar que as requisições externas sumiram.
No WP Rocket: aba File Optimization -> não use a remoção de Google Fonts em paralelo Recarregue a página com cache limpo e abra a aba Network (F12) do navegador Confirme que não há mais chamadas a fonts.gstatic.com nem fonts.googleapis.com
<?php
// Enfileira a Google Font pelo WordPress para o Perfmatters detectar e localizar.
add_action( 'wp_enqueue_scripts', 'full_enqueue_google_font' );
function full_enqueue_google_font() {
wp_enqueue_style(
'full-google-font',
'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap',
array(),
null
);
}














