Use efficient cache lifetimes no Lighthouse: como corrigir
O que o insight do Lighthouse lista, o que visitantes recorrentes ganham com um ano nos arquivos estáticos e onde configurar no host, plugin ou CDN.
Compartilhar
O que o Use efficient cache lifetimes quer do servidor?
O Use efficient cache lifetimes, chamado de "Serve static assets with an efficient cache policy" antes do Lighthouse 13 e de "Leverage browser caching" nas versões antigas do PageSpeed Insights, lista os arquivos da página que os navegadores podem reter por menos de 30 dias. "A long cache lifetime can speed up repeat visits to your page", mas o primeiro acesso e a pontuação continuam iguais. Arquivos estáticos recebem um ano, max-age=31536000; arquivo que muda ganha um novo nome.
Quer só a solução rápida? Pule para WordPress, Shopify, Cloudflare, Apache ou nginx.
O que significam "Cache TTL" e "None" no relatório do Lighthouse?
O Lighthouse lista todos os scripts, stylesheets, fontes, imagens e vídeos que o navegador pode manter por menos de 30 dias, tanto do seu domínio quanto de outros hosts.
Request é a URL do arquivo. Cache TTL é o tempo de vida que o servidor enviou com ele: "4h" é max-age=14400, quatro horas, o padrão da Cloudflare quando o servidor não envia nenhum tempo de vida. "None" significa que o servidor não enviou tempo de vida algum.

Uma página de produto no WooCommerce sem tempo de vida de cache nos próprios arquivos e com o Meta Pixel. Lighthouse 13.5, celular, throttling simulado como no PageSpeed Insights.
"Est savings of 444 KiB" é a estimativa do Lighthouse para os bytes que um visitante recorrente baixa de novo. O Lighthouse também converte esses bytes em ganho no first paint (FCP) e no LCP. Quando esse ganho é de 50 ms ou mais, o insight aparece em vermelho, perto do topo da lista. Mesmo assim, ele não tem peso na pontuação de Performance, calculada em um carregamento com cache vazio.
Por que um visitante recorrente espera por arquivos que o celular já tem?
Um visitante que volta uma semana depois pode encarar uma tela branca quase pelo mesmo tempo da primeira visita, enquanto os stylesheets, fontes e scripts continuam no celular.
O navegador armazena cada arquivo com o tempo de vida do cabeçalho Cache-Control (max-age, em segundos). Enquanto a cópia local estiver dentro desse prazo, o navegador a usa sem consultar o servidor, e a página só precisa esperar pelo HTML.
Quando a cópia passa desse tempo, o navegador pergunta ao servidor se o arquivo mudou. A resposta, 304 Not Modified, tem algumas centenas de bytes, mas ainda exige um round trip completo — e, em uma conexão móvel, o round trip é a parte lenta. Os stylesheets no head travam o first paint até que essas respostas cheguem (Render-blocking requests explica o motivo).
Sem nenhum tempo de vida, o Chrome deduz um prazo pela idade do arquivo, geralmente curto, e o Lighthouse exibe isso como "None".
Quanto uma visita de retorno fica mais rápida quando os arquivos duram um ano?
Em uma página de produto no WooCommerce que criei para uma loja de artigos esportivos, medi o first paint (FCP) em um celular emulado no perfil Slow 4G do DevTools, com quatro cabeçalhos diferentes nos arquivos da própria loja. A primeira visita renderizou aos 2,13 segundos com todos os cabeçalhos, porque ainda não havia nada no cache.
| Cabeçalho nos arquivos da loja | Próxima página | Uma semana depois |
|---|---|---|
Um ano, max-age=31536000 | 0,79 s | 0,78 s |
| Quatro horas (padrão da Cloudflare) | 0,80 s | 1,94 s |
| Sem cabeçalho de cache | 0,79 s | 1,94 s |
no-cache | 1,93 s | 1,94 s |
Com todos os arquivos dentro do tempo de vida, a página renderizou em cerca de 0,8 s. Na visita de retorno com cache de um ano, o LCP veio no mesmo instante, porque a foto do produto também estava no cache.
Uma semana depois, as quatro horas e a estimativa do Chrome para arquivos sem cabeçalho já tinham expirado. As respostas 304 reduziram o download de 404 kB para cerca de 1 kB, mas a página ainda renderizou aos 1,94 s enquanto cada stylesheet esperava pelo seu round trip. Só o prazo de um ano cobriu tanto a próxima página quanto o visitante que retornou.

Antes: sem tempo de vida de cache

Depois: um ano
A mesma página de produto em uma visita de retorno uma semana depois, 0,8 s após o toque, Slow 4G como aplicado pelo DevTools.
O Lighthouse carrega a página uma vez, com o cache vazio; o seu field data guarda todas as visitas, incluindo os visitantes recorrentes. No CoreDash, trace o LCP e o TTFB (Time to First Byte) por dia em Custom Timelines, uma vez para visitantes recorrentes e outra para novos visitantes:

Visitantes recorrentes

Novos visitantes
CoreDash Custom Timelines para acme-pagespeed.com, todos os dispositivos, p75 por dia. Cada gráfico tem sua própria escala.
Em cada gráfico, o espaço entre a linha do TTFB e a linha do LCP é o tempo de espera após o primeiro byte, o que inclui a espera pelos arquivos. Analise na escala de cada gráfico: esse intervalo deve ser menor para visitantes recorrentes, que já têm os arquivos no cache do navegador.
Como definir o tempo de vida de cache dos seus arquivos?
O tempo de vida vem de quem serve o arquivo: o servidor web, as configurações da hospedagem, um plugin de cache que grava regras no servidor ou uma CDN à frente que as sobrescreve. Comece pela coluna Request: arquivos no seu próprio domínio dependem de você; arquivos em outro host trazem o cabeçalho daquele fornecedor (Arquivos em outro host).
- Arquivos estáticos (CSS, JavaScript, fontes, imagens): um ano,
Cache-Control: max-age=31536000. - Arquivo que muda ganha uma nova URL: o ?ver=6.6 do WordPress, um hash como app.3f9a1c.js, um novo nome para um novo logo. O navegador mantém uma cópia por URL, então baixa o novo arquivo imediatamente.
- CSS e JavaScript sem versão na URL: adicione a versão primeiro. Um ano em um stylesheet cuja URL nunca muda mantém o layout antigo no celular dos visitantes recorrentes depois que você alterar o arquivo.
Dê um ano aos arquivos estáticos em vez de no-cache ou no-store. Os dois também esvaziam a lista, mas forçam cada página a consultar o servidor novamente ou baixar tudo de novo (veja a linha no-cache na tabela acima).
WordPress
Verifique a hospedagem primeiro. Kinsta, WP Engine, WordPress VIP e WordPress.com já enviam um ano ou mais para arquivos estáticos. Em hospedagem compartilhada ou no seu próprio servidor, um plugin de cache pode gravar as regras:
- WP Rocket grava as regras no .htaccess no Apache e no LiteSpeed quando você o ativa (CSS e JavaScript por um ano, imagens e fontes por quatro meses). No nginx ele não grava nada: adicione o bloco de nginx abaixo.
- LiteSpeed Cache vem com isso desativado por padrão. Ative o Browser Cache em LiteSpeed Cache > Cache > Browser; com isso ele passa a enviar um ano.
- W3 Total Cache vem com o Browser Cache ativado por padrão. No nginx ele gera um arquivo nginx.conf que precisa ser incluído na configuração do servidor.
Temas e plugins colocam o próprio número de versão no ?ver=, então a URL muda quando eles são atualizados. O stylesheet de um child theme editado manualmente mantém a versão fixa, e os visitantes recorrentes continuam com o CSS antigo. Vincule a versão ao horário de modificação do arquivo no functions.php do child theme:
add_action( 'wp_enqueue_scripts', function () {
wp_enqueue_style(
'child-style',
get_stylesheet_uri(),
array(),
filemtime( get_stylesheet_directory() . '/style.css' )
);
} ); O Storefront já carrega o stylesheet do child theme como storefront-child-style: use esse handle.
O WordPress dá um novo nome a arquivos enviados novamente (photo-1.jpg), então um ano é seguro também para uploads.
Shopify
Arquivos do tema, uploads e imagens de produtos já recebem um ano, então não há nada para configurar. Os arquivos que continuam na lista pertencem à Shopify e aos seus apps: /cdn/shopifycloud/portable-wallets/ (os botões de checkout dinâmico, 5 minutos, servidos pelo seu próprio domínio para parecerem arquivos seus), shop-js (30 minutos) e o web pixels manager (1 minuto). A Shopify define esses cabeçalhos; deixe-os na lista.
Cloudflare
A Cloudflare define um Browser Cache TTL de 4 horas para todos os arquivos, em qualquer plano, quando o servidor não envia nenhum tempo de vida ou envia um valor menor. Configure os tempos de vida no servidor (veja Apache ou nginx abaixo) e defina o Browser Cache TTL em Caching > Configuration como Respect Existing Headers. Ou, assim que o CSS e o JavaScript tiverem versão, adicione uma Cache Rule para os tipos de arquivos estáticos com o Browser TTL em "Override origin" definido para um ano. Não aumente o Browser Cache TTL de toda a zona para um ano: isso cobriria também o CSS e o JavaScript sem versão. As outras configurações estão em configurar a Cloudflare para o Core Web Vitals.
O Email Address Obfuscation da Cloudflare adiciona o email-decode.min.js ao seu domínio com um tempo de vida de dois dias que não pode ser alterado. Desative o recurso se não precisar dele (mais sobre a ofuscação de e-mail da Cloudflare).
Apache
Em hospedagem compartilhada, isso vai no arquivo .htaccess na raiz do site, a menos que um plugin de cache já tenha gravado lá. O mod_expires envia tanto o cabeçalho Expires quanto o Cache-Control max-age:
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType text/css "access plus 1 year"
ExpiresByType text/javascript "access plus 1 year"
ExpiresByType application/javascript "access plus 1 year"
ExpiresByType font/woff2 "access plus 1 year"
ExpiresByType image/jpeg "access plus 1 year"
ExpiresByType image/png "access plus 1 year"
ExpiresByType image/gif "access plus 1 year"
ExpiresByType image/webp "access plus 1 year"
ExpiresByType image/avif "access plus 1 year"
ExpiresByType image/svg+xml "access plus 1 year"
</IfModule> Cada tipo precisa corresponder ao Content-Type enviado pelo servidor (clique no arquivo no painel Network do DevTools para ver). Deixe o ExpiresDefault de fora: ele define um tempo de vida também para as páginas HTML, e os visitantes passarão a ver uma versão desatualizada de páginas que você alterou.
nginx
Em hospedagens que gerenciam o nginx para você, fale com o suporte: normalmente não é possível editar a configuração por conta própria. No seu próprio servidor, adicione isto dentro do bloco server:
server {
# CSS, JavaScript, fonts and images: a changed file gets a new name
location ~* \.(?:css|js|mjs|woff2|png|jpe?g|gif|webp|avif|svg|ico)$ {
expires 1y;
}
} O nginx usa o primeiro location com regex compatível. Se a sua configuração já tiver um para essas extensões, coloque a linha com expires dentro dele. Use expires em vez de add_header para isso: um add_header dentro de um location faz o nginx descartar as linhas add_header do bloco server (HSTS, CSP) para esses arquivos.
Next.js
O Next.js envia public, max-age=31536000, immutable em tudo que está sob /_next/static/ e não permite alterar isso. Em um site Next.js, os arquivos da lista costumam vir de outro host ou de uma CDN ou proxy na frente da aplicação que reescreve o cabeçalho. Faça um curl em um arquivo diretamente da aplicação e outro através da CDN: a diferença no cabeçalho indica a camada que precisa ser alterada.
Arquivos em outro host
Um arquivo em outro domínio traz o cabeçalho daquele fornecedor: o pixel da Meta (fbevents.js, 20 minutos), o antigo analytics.js do Google Analytics (2 horas), Hotjar (1 minuto), Stripe (2 minutos). Os fornecedores mantêm esses prazos curtos para que qualquer alteração do lado deles chegue rápido a todos os sites. Deixe esses arquivos na lista, mantenha scripts de carregamento como o fbevents.js no host do fornecedor para que recebam essas atualizações e remova tags que ninguém mais usa.
Bibliotecas ou fontes vindas de uma CDN pública funcionam de forma diferente. Com a versão exata na URL (jquery@3.7.1), cdnjs, jsDelivr e code.jquery.com enviam um ano. Já uma faixa de versão como swiper@11 recebe 7 dias no jsDelivr e 60 segundos no unpkg: fixe a versão exata ou hospede o arquivo no seu servidor para aplicar o seu próprio tempo de vida.
Como ver se o navegador agora reutiliza seus arquivos?
Verifique o cabeçalho primeiro, no analisador de cabeçalhos ou pela linha de comando. Cada arquivo deve mostrar o novo max-age:
curl -sI "https://www.example.com/wp-content/themes/your-theme/style.css?ver=1.2" | grep -i cache-control Depois, abra o painel Network do DevTools com Disable cache desmarcado (as configurações que eu uso) e carregue uma página do site. Clique em um arquivo: a linha cache-control em Response Headers mostra se o novo tempo de vida chegou ao navegador. Em seguida, acesse uma segunda página do site. A coluna Size exibirá (disk cache) ou (memory cache) para cada arquivo aproveitado da cópia local, e o Status 304 indica que ele ainda consultou o servidor.

Antes: 304 nos arquivos da loja

Depois: vindo do disk cache
A mesma página de produto em uma visita de retorno uma semana depois no painel Network, Slow 4G como aplicado pelo DevTools.
Rode o Lighthouse no celular novamente: o que restar na lista deve ser apenas arquivos em outros hosts e arquivos da própria plataforma. A pontuação continuará a mesma. Uma pontuação que varia alguns pontos entre execuções não tem nada a ver com o cabeçalho (por que a pontuação varia). O CoreDash mostra as visitas de retorno mais rápidas conforme elas acontecem; o Search Console leva até 28 dias.
Quando o cabeçalho vem de um painel de hospedagem inacessível, ou quando uma CDN à frente continua reescrevendo o que o servidor envia, agende uma Core Web Vitals power hour. Eu analiso os cabeçalhos com você e mostro qual camada define cada um e onde alterá-lo; se todos os arquivos que sobrarem na lista forem de fornecedores externos, aproveitamos o restante da hora no seu elemento LCP.

Precisa de um site mais rápido?
Sou o Arjen e há 17 anos conserto sites lentos. Se você está com problemas que não consegue resolver sozinho, me envie sua URL e vamos conversar.
Me envie sua URL
Por que nosso fix não está funcionando?
Às vezes a CDN ainda entrega o HTML antigo, ou o fix entrou no template de desktop e o celular usa outro. Me envie sua URL e o problema, e eu respondo com alguns horários. Primeiro analiso o field data, depois dedicamos uma hora ao seu site, e em até um dia você tem minhas anotações por escrito. €350 sem IVA.
Me envie sua URLSem desenvolvedor para fazer o fix? Eu mesmo faço o trabalho, em uma cópia do seu site.