Dados de acessibilidade Lighthouse indisponíveis

O que esta verificação faz

Reporta que a auditoria não conseguiu obter dados de acessibilidade Lighthouse a partir da API PageSpeed Insights (PSI) do Google. Sem eles, a Pontuação de acessibilidade Lighthouse e várias auditorias ao nível das regras (contraste de cor, falhas de regras axe) não puderam correr, pelo que o módulo de acessibilidade reporta um resultado parcial baseado apenas nas verificações de HTML estático que o MetricSpot faz localmente.

Porque é importante

Isto não é um problema do teu site — é um problema da execução da auditoria. Cinco causas comuns:

• Sem chave de API do PSI configurada. Instalações self-hosted do MetricSpot precisam de GOOGLE_PSI_KEY definido; sem chave, o endpoint público do PSI aplica limites agressivos.
• Quota do PSI esgotada. O escalão gratuito é de 25 000 pedidos/dia por chave, 400/minuto. Uma instância self-hosted que corra muitas auditorias num curto intervalo atinge o limite de burst.
• A tua página bloqueia o Chrome headless. Alguns sites usam o Cloudflare Bot Fight Mode ou um WAF personalizado que sinaliza o user-agent Chrome do PSI e devolve 403.
• A página está atrás de login. O PSI acede ao URL anonimamente. Se o conteúdo auditável vive atrás de autenticação, o render público do PSI vê o ecrã de login, não a página real.
• A página é inalcançável a partir da rede do Google. Geo-bloqueio, allowlists de IP, DNS apenas interno — qualquer um destes impede o PSI de obter o URL.

Uma deteção “Lighthouse indisponível” numa auditoria é geralmente um soluço transitório do PSI. Ocorrências repetidas em várias auditorias apontam para uma das causas acima.

Como corrigir

Se corres o MetricSpot em self-hosted:

# Obter chave: https://developers.google.com/speed/docs/insights/v5/get-started
echo "GOOGLE_PSI_KEY=AIza…" >> .env
# Reiniciar o worker
dokku ps:restart metricspot

Sem chave, o PSI permite ~1 pedido por minuto, anonimamente. Com chave, tens 25 000/dia.

Se estás no MetricSpot gerido (app.metricspot.com) — a quota já está configurada. Uma deteção “Lighthouse indisponível” aqui significa que o próprio PSI falhou neste URL. Tenta:

1. Voltar a correr a auditoria. O PSI devolve 500s transitórios cerca de 1% das vezes.
2. Auditar um URL público, sem autenticação. Confirma que a página é alcançável sem cookie de sessão.
3. Verifica as regras do WAF / bot. Se usas Cloudflare, adiciona o user-agent do PSI à tua allowlist. O PSI identifica-se como Chrome-Lighthouse.
4. Reproduz na ferramenta pública do PSI — se a ferramenta pública também falhar no teu URL, o problema é reproduzível e não é específico do MetricSpot.

Para páginas que genuinamente não podem ser auditadas pelo PSI (painéis de admin, áreas só para clientes), o resto do módulo de acessibilidade do MetricSpot continua a correr contra o HTML que consegue obter — texto alternativo, etiquetas de formulário, atributo lang, texto de ligação descritivo, hierarquia de cabeçalhos, landmarks. Essas verificações estáticas constituem a maior parte da conformidade WCAG. O PSI dá-te a pontuação Lighthouse dinâmica por cima.

Perguntas frequentes

Qual é a diferença entre esta deteção e a “Pontuação de acessibilidade Lighthouse”?

A Pontuação de acessibilidade Lighthouse dispara quando a pontuação está abaixo do limiar. Esta deteção dispara quando o PSI não devolveu pontuação alguma. São mutuamente exclusivas — vês uma ou outra, nunca ambas.

Posso desativar o PSI e usar só as verificações estáticas?

Podes — define GOOGLE_PSI_KEY= vazio e o MetricSpot salta o PSI por completo. Perdes a pontuação Lighthouse, as verificações dinâmicas axe-core e os Core Web Vitals dos dados de laboratório. A maioria dos utilizadores mantém o PSI ativo.

Isto afeta a minha pontuação global da auditoria?

A ponderação do módulo de acessibilidade tem em conta dados PSI em falta — a tua pontuação global é calculada a partir das verificações que correram, sem ser penalizada pelas em falta. Corrigir a causa (allowlist no WAF, muro de login) deixa as verificações dinâmicas contribuir da próxima vez.