# Como corrigir o erro de Local Google Fonts no Perfmatters

O erro de Local Google Fonts no Perfmatters acontece quando a opção de hospedar fontes localmente não captura as fontes carregadas pelo tema, page builder ou outro plugin, deixando as requisições ainda apontarem para o Google ou quebrando a tipografia do site.

## 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.

**Antes de começar:** Antes de alterar a tipografia do tema, ajustar permissões de pasta por SSH ou desativar plugins de otimização em produção, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso o layout ou as fontes quebrem.

## 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.

Erros relacionados

- [Como corrigir o conflito de fontes entre Perfmatters e Astra Pro](https://full.services/wp-fixer/corrigir-conflito-fontes-perfmatters-astra/)
- [Como corrigir a remoção de query strings no Perfmatters](https://full.services/wp-fixer/corrigir-query-strings-perfmatters/)
- [Como corrigir o erro de carregamento de fontes no WordPress](https://full.services/wp-fixer/corrigir-font-loading-wordpress/)

## 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

1. 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
```

2. 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
```

3. 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)
```

4. 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
```

5. 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
```


## Código

```php
<?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
    );
}
```

## Perguntas frequentes

### Por que as fontes do Google ainda carregam externas com o Local Google Fonts ativado

Na maioria das vezes o tema ou o page builder carrega a fonte pelo próprio painel de tipografia ou por um @import no CSS, caminhos que o Perfmatters não inspeciona. Enfileire a fonte pelo WordPress e limpe o cache para o plugin conseguir localizá-la.

### Onde fica a opção Local Google Fonts no Perfmatters

Ela fica na aba Fonts das configurações do Perfmatters, em Configurações e Perfmatters. Lá você marca a opção Local Google Fonts e salva, e pode limpar o cache de fontes pela aba Tools.

### Ativar o Local Google Fonts ajuda na conformidade com a LGPD e o GDPR

Sim. Ao hospedar as fontes no seu próprio servidor, o navegador deixa de buscar os arquivos no Google e para de enviar o IP do visitante para servidores externos, o que reduz a exposição de dados pessoais a terceiros.

### Por que minha fonte mudou depois de ativar o Local Google Fonts

Isso acontece quando o Perfmatters não detecta a fonte original e o site recorre a uma fonte de sistema, ou quando só alguns pesos foram localizados. Garanta que a fonte seja carregada por um caminho detectável e regenere o cache de fontes.

### Preciso limpar o cache depois de ativar o Local Google Fonts

Sim. Uma página salva em cache antes da ativação continua entregando o CSS com as URLs do Google. Limpe o cache do Perfmatters, do plugin de cache e do CDN para que as próximas requisições usem os arquivos locais.

### O Local Google Fonts do Perfmatters conflita com o WP Rocket

Pode conflitar se os dois tentarem manipular as fontes ao mesmo tempo. Deixe apenas o Perfmatters cuidar das Google Fonts e não use a remoção ou otimização de fontes do outro plugin em paralelo para evitar CSS sobrescrito.

### Onde o Perfmatters salva os arquivos de fonte locais

Os arquivos baixados ficam em uma subpasta dentro de wp-content/uploads do seu site. Se essa pasta não tiver permissão de escrita, o plugin não consegue salvar os arquivos e a fonte volta a ser carregada do Google.

**Fonte:** [Perfmatters — Documentação oficial](https://perfmatters.io/docs/)