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
Arjen Karel
Atualizado a · 9 min de leitura
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:

Lighthouse report, Document request latency in red with Est savings of 129 KiB and the labels FCP, LCP and Unscored, and three crossed checks: Had redirects (3 redirects, +271 ms), Server responded slowly (observed 1304 ms) and No compression applied

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.

Top of a phone screen 2 seconds after the tap on the theatre page before the fixes: still completely white

Antes

The same moment after the fixes: the theatre's What's on page with the stage photo and the heading

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çãoFCPHTML concluído
Antes3,72 s3,64 s
Endereço final, sem redirecionamentos2,78 s2,70 s
Mais uma cache de página1,56 s1,44 s
Mais Brotli0,81 s0,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:

DevTools Performance panel with the Document request latency insight open in the sidebar and three crossed checks; on the HTML request in the Network track the parts Redirects, Server response time and Uncompressed download

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.

CoreDash table TTFB subparts by URL on mobile: per page the p75 TTFB, its rating and a bar split into Waiting plus Redirect, Worker and Cache, DNS, Connection and Request

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.

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

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
Arjen Karel
Arjen Karel, Consultor de web performance desde 2009

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 URL

Sem programador para fazer o fix? Faço eu o trabalho, numa cópia do seu site.

Arjen KarelTTFB ainda no vermelho em mobile?Envie-me o seu URL