Dati di accessibilità Lighthouse non disponibili

Cosa controlla questo check

Segnala che l’audit non è riuscito a recuperare i dati di accessibilità Lighthouse dall’API PageSpeed Insights (PSI) di Google. Senza questi, il Punteggio accessibilità Lighthouse e diversi audit a livello di regola (contrasto colori, errori delle regole axe) non hanno potuto essere eseguiti, quindi il modulo accessibilità riporta un risultato parziale basato solo sui check di HTML statico che MetricSpot esegue localmente.

Perché è importante

Non è un problema del tuo sito — è un problema dell’esecuzione dell’audit. Cinque cause comuni:

• Nessuna API key PSI configurata. Le installazioni self-hosted di MetricSpot richiedono GOOGLE_PSI_KEY; senza, l’endpoint PSI pubblico applica rate limit aggressivi.
• Quota PSI esaurita. Il tier gratuito è 25.000 richieste/giorno per chiave, 400/minuto. Un’istanza self-hosted che esegue molti audit in poco tempo tocca il limite di burst.
• La tua pagina blocca Chrome headless. Alcuni siti usano Cloudflare Bot Fight Mode o un WAF custom che segnala lo user-agent Chrome di PSI e restituisce un 403.
• La pagina è dietro un login. PSI raggiunge l’URL anonimamente. Se il contenuto auditabile vive dietro autenticazione, il render PSI pubblico vede la schermata di login, non la pagina vera.
• La pagina non è raggiungibile dalla rete di Google. Geo-blocking, allowlist IP, DNS solo interno — qualunque di queste impedisce a PSI di recuperare l’URL.

Un risultato “Lighthouse non disponibile” per un singolo audit è di solito un intoppo PSI transitorio. Occorrenze ripetute tra audit puntano a una delle cause sopra.

Come risolvere

Se stai usando MetricSpot self-hosted:

# Get a key: https://developers.google.com/speed/docs/insights/v5/get-started
echo "GOOGLE_PSI_KEY=AIza…" >> .env
# Restart the worker
dokku ps:restart metricspot

Senza chiave, PSI ti lascia fare ~1 richiesta al minuto, in anonimo. Con la chiave, ottieni 25.000/giorno.

Se sei su MetricSpot gestito (app.metricspot.com) — la quota è già configurata. Un risultato “Lighthouse non disponibile” qui significa che PSI stesso ha fallito su questa URL. Prova:

1. Ri-esegui l’audit. PSI restituisce 500 transitori circa l’1% delle volte.
2. Verifica un URL pubblico e non autenticato. Conferma che la pagina sia raggiungibile senza cookie di sessione.
3. Controlla il tuo WAF / regole bot. Se usi Cloudflare, aggiungi lo user-agent di PSI alla tua allowlist. PSI si dichiara come Chrome-Lighthouse.
4. Riproduci sul tool pubblico PSI — se anche il tool pubblico fallisce sulla tua URL, il problema è riproducibile e non specifico di MetricSpot.

Per pagine che davvero non possono essere auditate da PSI (dashboard admin, aree riservate ai clienti), il resto del modulo accessibilità di MetricSpot gira comunque sull’HTML che riusciamo a recuperare — alt text, label dei form, attributo lang, testo descrittivo dei link, gerarchia delle intestazioni, landmark. Quei check statici sono comunque il grosso della conformità WCAG. PSI ti dà sopra il punteggio Lighthouse dinamico.

Domande frequenti

Che differenza c’è tra questo risultato e “Punteggio accessibilità Lighthouse”?

Punteggio accessibilità Lighthouse si attiva quando il punteggio è sotto la soglia. Questo risultato si attiva quando PSI non ha restituito alcun punteggio. Sono mutuamente esclusivi — vedrai uno o l’altro, non entrambi.

Posso disabilitare PSI e usare solo i check statici?

Puoi — imposta GOOGLE_PSI_KEY= vuoto e MetricSpot salta del tutto PSI. Perdi il punteggio Lighthouse, i check dinamici axe-core e i Core Web Vitals dai dati di lab. La maggior parte degli utenti tiene PSI attivo.

Questo influenza il mio punteggio complessivo di audit?

La ponderazione del modulo accessibilità tiene conto dei dati PSI mancanti — il tuo punteggio complessivo è calcolato sui check eseguiti, non penalizzato per quelli mancanti. Risolvere la causa sottostante (allowlist WAF, muro di login) permette ai check dinamici di contribuire la volta successiva.