Document request latency: como corrigir as três verificações
Todos os ficheiros da página ficam à espera do HTML. O que significam as três verificações do aviso e a solução para WordPress, Shopify, Cloudflare e para o seu próprio servidor.
- Bom ≤ 0,8 s
- Precisa de melhorias ≤ 1,8 s
- Mau > 1,8 s
Partilhar
O que significam “Had redirects” e “Server responded slowly”?
O Document request latency, o aviso do Lighthouse que começa com "Your first network request is the most important", substituiu o Reduce initial server response time. Ambas as linhas significam que o HTML chega tarde, devido a um redirecionamento ou a um servidor lento, e todos os outros ficheiros ficam à espera dele. Aponte para o endereço https final, tenha uma cache de página a responder em menos de 600 ms e ative o gzip ou o Brotli.
Quer apenas a solução rápida? Salte para WordPress, Shopify, Cloudflare ou Apache e Nginx.
O que mede cada verificação do Document request latency?
O aviso diz respeito a um único ficheiro: o HTML da página testada, o primeiro pedido que o browser faz. O Lighthouse diz: "Your first network request is the most important. Reduce its latency by avoiding redirects, ensuring a fast server response, and enabling text compression." Logo por baixo surgem três verificações:

A página de teste antes de qualquer correção, com as definições que o PageSpeed Insights usa.
- "Had redirects (3 redirects, +271 ms)": o endereço testado encaminhou o browser para outro endereço antes de enviar a página, e basta um único redirecionamento para levar a cruz. Se pensa que o site não tem nenhum, olhe para o endereço que testou: escrito sem https ou www, é encaminhado para o endereço final, tal como acontece com qualquer visitante que o escreva diretamente ou siga um link antigo. Teste também o endereço final; os field data mostram com que redirecionamentos os visitantes se deparam.
- "Server responded slowly (observed 1304 ms)": o tempo entre o envio do pedido e o primeiro byte da resposta, medido uma vez nesta execução. A verificação falha acima dos 600 ms. Aponte para cerca de 100 ms; para isso, precisa de uma cache de página. Esta espera é uma das partes do Time to First Byte.
- "No compression applied": o HTML veio sem gzip, Brotli ou zstd. Apenas o HTML conta, pelo que um servidor que comprima as folhas de estilo e os scripts, mas não a própria página, falha esta verificação.
O vermelho significa que o Lighthouse prevê que o primeiro conteúdo (FCP) e o maior elemento (LCP) apareçam mais cedo sem os redirecionamentos ou o servidor lento. Apenas com a cruz da compressão, o aviso fica cor-de-laranja; e enquanto a compressão falhar, a indicação "Est savings" mostra kilobytes, mesmo ao lado de um servidor lento. Unscored: o aviso em si não afeta a pontuação, mas o FCP e o LCP afetam, e ambos ficam à espera do HTML. Antes do Lighthouse 13, estas três verificações eram auditorias separadas: Avoid multiple page redirects, Reduce initial server response time e Enable text compression.
Porque é que a página inteira fica à espera do HTML?
O visitante toca num link e fica a olhar para a página anterior, ou para um ecrã em branco, até o HTML chegar. Só depois a página aparece.

Antes

Depois
A página de teste, a programação de um teatro, numa ligação móvel, 2 segundos após o toque.
As folhas de estilo, os scripts e as fotos vêm identificados dentro do HTML, e os tipos de letra dentro dessas folhas de estilo, pelo que nada pode arrancar antes de o HTML chegar (para ver o que carrega a seguir, consulte a Network dependency tree). Por cada milissegundo de atraso do HTML, o FCP e o LCP também se atrasam.
Fiz a medição nessa página do teatro, configurada como um site WordPress sem cache de página e aberta através do endereço sem www e sem https. A ligação móvel tinha um round trip de 150 ms e 1,6 Mbps, e os tempos contam a partir do toque:
| Alteração | FCP | HTML concluído |
|---|---|---|
| Antes | 3,72 s | 3,64 s |
| Endereço final, sem redirecionamentos | 2,78 s | 2,70 s |
| Mais uma cache de página | 1,56 s | 1,44 s |
| Mais Brotli | 0,81 s | 0,54 s |
A cache de página fez a maior diferença: o servidor respondeu em 40 ms em vez de 1,3 segundos. Na ligação móvel, os três redirecionamentos demoraram quase um segundo, onde o relatório indicava +271 ms: o Lighthouse mede-os na sua própria ligação rápida, e num telemóvel cada redirecionamento é um novo pedido com os seus próprios round trips. O Brotli reduziu o HTML de 197 kB para 19 kB, retirando 0,9 segundos ao seu download. De acordo com o State of Web Vitals, dos sites com um TTFB superior a 1,8 segundos em telemóveis, apenas 14% passam no LCP, contra 94% nos sites com um bom TTFB.
Porque é que o tempo de servidor observado varia em cada teste?
"Observed" significa que o Lighthouse fez a medição num único carregamento, a partir da máquina que executou o teste. Quando a cache de página estava vazia nesse carregamento (recém-limpa após a atualização de um plugin, ou expirada), o próprio servidor teve de gerar a página e a verificação falhou. No teste seguinte, a cache responde e a verificação fica verde — um motivo comum para uma pontuação que muda de teste para teste.
Algumas visitas ignoram sempre a cache: utilizadores com sessão iniciada, o carrinho e links com uma query string desconhecida da cache, como o gclid de um anúncio. O Lighthouse testa o endereço limpo a partir de um único local, enquanto um visitante distante espera mais tempo pelo mesmo servidor. Por isso, são os field data — aquilo que os utilizadores reais obtêm — que realmente contam.
É possível ter uma verificação de servidor a vermelho ao lado de um FCP rápido no mesmo relatório: o relatório calcula o FCP através de um modelo, enquanto o tempo de servidor foi o que realmente mediu.
Como resolver o Document request latency?
Comece pela verificação que apresenta mais tempo. Na maioria dos sites é o servidor, e a solução é uma cache de página. Depois os redirecionamentos e, por fim, a compressão, que normalmente se resume a uma única definição.
WordPress
Sem cache de página, o WordPress executa PHP e consultas à base de dados para construir a página para cada visitante. Uma cache de página guarda o HTML finalizado e envia-o de imediato. Quanto mais perto do visitante estiver, mais rápida será: guarde o HTML em cache primeiro na CDN (Cloudflare abaixo), depois na cache de página do alojamento (a maioria dos alojamentos geridos de WordPress tem uma) e, a seguir, num plugin de cache como o meu WP Core Web Vitals (Fast cache), WP Rocket ou LiteSpeed Cache num servidor LiteSpeed. Ative o preload da cache, para que cada página esteja pronta em cache antes de o primeiro visitante a pedir.
Para ver se uma página vem da cache, abra-a sem sessão iniciada numa janela privada: a maioria das caches adiciona um cabeçalho de resposta com HIT ou MISS, visível no DevTools. Configure a cache para tratar links com parâmetros de tracking como a mesma página (o WP Rocket e o LiteSpeed Cache têm uma lista para isso). Um plugin novo que defina um cookie em todas as páginas pode anular tudo isto, tal como uma cache que se esvazia a cada atualização sem preload. Para páginas que não podem ser guardadas em cache, o request duration cobre a parte do servidor.
Quanto aos redirecionamentos: em Definições > Geral (Settings, General), tanto o Endereço do WordPress como o Endereço do site devem ter o endereço final: https, com ou sem www, exatamente como as páginas surgem na barra de endereço. Aponte os menus, links internos e anúncios para esse endereço exato, com a barra final (trailing slash) que os permalinks utilizam. Configure cada regra de um plugin de redirecionamentos para apontar diretamente para a página final.
A compressão é uma definição do alojamento e costuma estar ativada. Se o HTML vier sem compressão, peça ao alojamento para ativar gzip ou Brotli para text/html; um plugin de cache só consegue ativá-lo através do .htaccess em Apache e LiteSpeed.
Shopify
O Shopify gere o servidor e a respetiva cache, e comprime o HTML. A verificação do servidor passa em quase todas as lojas porque o Shopify envia logo o início da página. Um tema lento manifesta-se mais tarde, no FCP e no LCP: o LCP breakdown mostra onde. Os redirecionamentos dependem de si. Em Settings > Domains, escolha o domínio principal e crie links para ele em todo o lado: anúncios, e-mails e redes sociais. O redirecionamento automático em Online Store > Preferences envia visitantes de outros países para o respetivo mercado com um redirecionamento extra na primeira página; um banner que ofereça essa mudança poupa-lhes essa espera.
Cloudflare e outras CDN
Assim que uma Cache Rule define o HTML como "Eligible for cache", a Cloudflare passa a entregá-lo a partir de um servidor próximo do visitante, sem qualquer pedido ao servidor de origem. Configure essa regra manualmente: ignore a cache para utilizadores com sessão iniciada, o carrinho e o checkout (pelos respetivos cookies e caminhos), e decida o que acontece aos links com parâmetros de tracking, que caso contrário criariam uma cópia própria cada um. Depois, consulte os field data para verificar que visitas continuam à espera do servidor e ajuste a regra. O APO, a cache de página pronta a usar da Cloudflare para WordPress, funciona da mesma forma, com menos cache hits do que uma regra ajustada ao site.
A Cloudflare comprime o HTML por omissão para os visitantes. Defina o SSL/TLS para Full (strict) ou Full. Com Flexible, a Cloudflare comunica com o servidor por http; um servidor que redirecione http para https responde a cada pedido com esse mesmo redirecionamento, e o visitante acaba preso num loop de redirecionamentos.
Apache e Nginx
Encaminhe o http e o domínio raiz (example.com sem www) para o endereço final num único redirecionamento. Em Apache, no topo do .htaccess, acima do bloco do WordPress:
RewriteEngine On
RewriteCond %{HTTPS} off [OR]
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^ https://www.example.com%{REQUEST_URI} [L,R=301]
<IfModule mod_brotli.c>
AddOutputFilterByType BROTLI_COMPRESS text/html text/css text/javascript application/javascript
</IfModule>
<IfModule mod_deflate.c>
AddOutputFilterByType DEFLATE text/html text/css text/javascript application/javascript
</IfModule>
No Nginx, o gzip é configurado no bloco http do nginx.conf: ative-o e defina gzip_proxied para que os pedidos que chegam através de um proxy também sejam comprimidos (text/html está sempre incluído):
server {
listen 80;
server_name example.com www.example.com;
return 301 https://www.example.com$request_uri;
}
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/ssl/example.com.crt;
ssl_certificate_key /etc/ssl/example.com.key;
return 301 https://www.example.com$request_uri;
}
gzip on;
gzip_proxied any;
gzip_types text/css text/javascript application/javascript application/json image/svg+xml;
O Brotli no Nginx necessita do módulo ngx_brotli. Uma cache de página no próprio servidor (Nginx FastCGI cache, Varnish) responde antes de o PHP arrancar.
Next.js e outras frameworks
Uma página renderizada a cada pedido fica à espera dos seus dados sempre. Sempre que o conteúdo o permitir, renderize-a uma vez e atualize-a com base num agendamento:
// app/whats-on/page.js
export const revalidate = 300; // gera a página uma vez, volta a gerar no máximo a cada 5 minutos
Ler cookies ou cabeçalhos numa página faz com que volte a ser renderizada a cada pedido. Escreva os links com ou sem a barra final, consoante o que a definição trailingSlash espera, ou o Next.js adicionará um redirecionamento.
Redirecionamentos que não pode remover
Um encurtador de links, o wrapper de links de uma rede social ou o rastreador de cliques de uma plataforma de anúncios adicionam um redirecionamento num servidor de terceiros. Garanta que cada um deles aponta para o endereço final, para que o redirecionamento deles seja o único.
Como verificar os redirecionamentos, o tempo de servidor e a compressão?
Execute o Lighthouse algumas vezes, sempre da mesma forma, utilizando o endereço que os visitantes usam. Para ver cada verificação sem um relatório, peça a página da mesma forma que um browser faz:
curl -sIL -H "Accept-Encoding: br, gzip" http://example.com/page | grep -iE "^HTTP|^location|content-encoding"
Cada linha location é um redirecionamento, e a última resposta deve mostrar content-encoding: br ou gzip. Se omitir o cabeçalho Accept-Encoding, os servidores respondem sem compressão, mesmo com a compressão ativada. No Chrome DevTools, o painel Network mostra a espera do pedido de HTML em Timing como "Waiting for server response", e o painel Performance assinala as três partes do aviso nesse pedido:

Uma gravação do DevTools da página de teste antes das correções, numa ligação móvel.
Para os visitantes reais, o CoreDash divide o TTFB em telemóveis nas respetivas componentes por página. A parte laranja, Waiting + Redirect, cresce com os redirecionamentos antes da página; a parte verde, Request, com o tempo que o servidor demora. Procure páginas onde uma dessas duas partes seja grande e confirme, após a correção, que diminuiu nessas mesmas páginas. O Search Console demora até 28 dias a apresentá-lo.

Algumas páginas não podem ficar em cache, como o carrinho de uma loja ou uma área de membros, e alguns alojamentos são lentos antes sequer de o WordPress arrancar. Nesses casos, o trabalho tem de ser feito no próprio servidor, e é exatamente isso que analisamos juntos numa power hour: o TTFB, página a página, e aquilo de que o servidor fica à espera.

Precisa de um site mais rápido?
Sou o Arjen e há 17 anos que corrijo sites lentos. Se tem problemas que não consegue resolver sozinho, envie-me o seu URL e falamos.
Envie-me o seu URL
Porque é que o nosso fix não está a funcionar?
Por vezes a CDN ainda serve o HTML antigo, ou o fix foi feito no template de desktop e o mobile usa outro. Envie-me o seu URL e o problema, e respondo com alguns horários. Primeiro analiso os seus field data, depois dedicamos uma hora ao seu site, e no prazo de um dia tem as minhas notas por escrito. 350 € sem IVA.
Envie-me o seu URLSem programador para fazer o fix? Faço eu o trabalho, numa cópia do seu site.