Un documento pubblico mancante dovrebbe mostrare una spiegazione chiara e restituire uno stato HTTP appropriato, di solito 404. Su un Mac, puoi verificare entrambe le cose in Chrome, individuare la discrepanza e fornire al tuo sistema di pubblicazione una correzione precisa.

Questo flusso di lavoro è rivolto a chi gestisce pagine di documenti pubblici: guide, note di consultazione o semplici fogli di istruzioni. L’obiettivo è far concordare l’indirizzo richiesto, la risposta del server e il messaggio visualizzato. Tutti i percorsi di esempio riportati di seguito sono fittizi.

Quale risposta dovrebbe restituire un documento mancante?

Per prima cosa, decidi cosa dovrebbe accadere all’indirizzo del documento. Una pagina che è stata spostata richiede una gestione diversa da una pagina che non esiste più. Prima di modificare la pagina di errore, consulta questa tabella decisionale.

Stato del documento Risposta prevista Cosa dovrebbero vedere i lettori
Esiste all’indirizzo richiesto 200 OK Il documento completo
Ha una sostituzione permanente ben definita Reindirizzamento 301 Il documento sostitutivo al nuovo indirizzo
Non è reperibile e non esiste una sostituzione equivalente 404 Not Found Una spiegazione utile dell’assenza del documento
È stato rimosso deliberatamente ed è probabile che l’assenza sia permanente È appropriato 410 Gone Una spiegazione chiara della rimozione e indicazioni di navigazione utili

HTTP definisce 404 senza indicare se l’assenza sia temporanea o permanente. Definisce 410 per una risorsa la cui indisponibilità è probabilmente permanente; quando la permanenza non è certa, usa 404. Questi significati sono descritti in RFC 9110, sezioni 15.5.5 e 15.5.11.

Google consiglia un reindirizzamento permanente quando un documento è stato spostato o ha una sostituzione ben definita. Se è stato rimosso senza una sostituzione simile, Google consiglia 404 o 410. Consulta le indicazioni di Google per la gestione delle risposte relative a contenuti mancanti.

Per esempio, supponiamo che /documents/paper-folding-notes sia diventato /documents/paper-folding-guide e contenga istruzioni sostanzialmente equivalenti. In questo caso è indicato un reindirizzamento permanente. Se invece le note sono state rimosse senza sostituzione, mantieni una risposta di documento mancante al vecchio indirizzo. Puoi offrire un collegamento all’indice generale dei documenti nella pagina.

Perché una pagina di errore convincente non basta

Una pagina può mostrare chiaramente il messaggio Documento non trovato, mentre il server restituisce 200. Google definisce questo tipo di discrepanza un soft 404; anche una pagina vuota o priva di contenuto principale può essere classificata allo stesso modo. Leggi la spiegazione di Google sugli errori soft 404.

Lo stato fa parte della risposta HTTP ed è separato dal contenuto esplicativo. Di conseguenza, modificare il titolo o aggiungere una grande etichetta 404 non determina il codice di risposta. Prima di considerare risolto il problema, controlla la richiesta effettiva del documento. RFC 9110 descrive il ruolo dei codici di stato della risposta.

Come si controlla la risposta del documento su un Mac?

Per questa verifica, usa gli strumenti integrati di Chrome. Prepara l’indirizzo di un documento funzionante e un percorso sicuramente inesistente sullo stesso sito pubblico. Per esempio, il percorso mancante potrebbe essere /documents/missing-paper-example-731. Scegli un indirizzo che sai non avere alcun documento pubblicato.

  1. Apri la pagina pubblica in Chrome.
  2. Premi Command + Option + I per aprire DevTools.
  3. Seleziona il pannello Network.
  4. Con DevTools aperto, inserisci l’indirizzo di prova nella barra degli indirizzi e caricalo.

Chrome documenta la scorciatoia per Mac in Aprire Chrome DevTools. L’attività di rete viene registrata mentre DevTools è aperto, come spiegato nella panoramica del pannello Network.

  1. Seleziona Disable cache per evitare di basarti sulla risposta memorizzata nella cache del browser durante questa verifica.
  2. Attiva Preserve log se devi seguire la navigazione attraverso i reindirizzamenti.
  3. Ricarica l’indirizzo di prova.
  4. Seleziona la richiesta principale del documento, quindi apri Headers. In General, leggi l’indirizzo della richiesta e il codice di stato.

Questi controlli e la posizione delle informazioni sullo stato sono documentati nel riferimento alle funzionalità di Network di Chrome.

Esamina attentamente la richiesta del documento. Il registro contiene anche richieste per script, fogli di stile e altre risorse. L’assenza di un file di supporto non dimostra che il documento stesso abbia restituito 404. La tabella delle richieste di Chrome distingue il codice HTTP in Status dalla categoria della risorsa in Type; consulta Ispezionare l’attività di rete.

Ora confronta tre osservazioni: l’indirizzo richiesto inizialmente, il codice di risposta del documento e la pagina visualizzata dopo il caricamento. Annotale insieme. Se la navigazione modifica l’indirizzo, esamina la richiesta originale e la destinazione anziché registrare soltanto la pagina finale.

Come si trasformano le osservazioni in una correzione?

La tabella diagnostica seguente è una sintesi pratica dei significati HTTP e delle indicazioni di Google per la risoluzione dei problemi. È uno strumento decisionale, non un insieme di risultati misurati.

Risultato osservato Cosa verificare Correzione prevista
200 con un messaggio di documento mancante Il gestore dei percorsi mancanti o la pagina di fallback Restituisci 404 con la spiegazione
404 con il documento previsto visibile La risposta assegnata a un percorso esistente Fornisci il documento correttamente con 200
Reindirizzamento a un indice generale Se esiste una sostituzione equivalente Reindirizza al documento equivalente oppure mostra una pagina di errore
200 con un documento vuoto o incompleto Il caricamento e il rendering dei contenuti Ripristina il contenuto previsto se il documento esiste ancora
404 con un messaggio utile di pagina mancante Se l’indirizzo è davvero assente Mantieni questo comportamento se l’assenza è prevista

La documentazione per la risoluzione dei problemi di Google distingue esplicitamente i documenti non disponibili, quelli che sono stati spostati e quelli che esistono ancora ma non vengono caricati correttamente. Questa distinzione evita di trattare una pagina funzionante ma incompleta come se fosse stata rimossa intenzionalmente. Consulta Risolvere gli errori di scansione di Google Search.

Per un passaggio di consegne concreto, scrivi: “Per il percorso fittizio /documents/missing-paper-example-731, restituisci 404 e mostra a quell’indirizzo la pagina personalizzata di documento mancante. Mantieni funzionanti i percorsi dei documenti esistenti. Applica reindirizzamenti permanenti solo quando è stata identificata una sostituzione equivalente.” Aggiungi lo stato osservato e il messaggio visualizzato durante la verifica.

Questa richiesta descrive il comportamento necessario senza indovinare i nomi delle voci di menu del tuo sistema di pubblicazione. L’implementazione va eseguita nella configurazione dell’hosting, nella route dell’applicazione o nel sistema di pubblicazione che genera la risposta. Google spiega che i codici di stato HTTP vengono generati dal server di hosting nella documentazione sui codici di stato HTTP.

E se l’editor permette di modificare solo il contenuto della pagina?

Un editor che modifica il testo o i metadati del documento potrebbe non controllare le risposte HTTP. Lo standard HTML WHATWG definisce comportamenti specifici per le direttive meta che usano http-equiv; impostare lo stato di una risposta HTTP non rientra tra questi. Aggiungere http-equiv="status" non è quindi un metodo supportato per creare un 404. Consulta Standard HTML: direttive Pragma.

Se nell’editor non sono disponibili controlli per le risposte, usa il meccanismo documentato per le pagine mancanti del livello di hosting o dell’applicazione. Verifica se serve il contenuto personalizzato con 404 all’indirizzo richiesto che risulta mancante. Un’impostazione che seleziona soltanto il layout della pagina di errore non risponde a questa domanda: verificane il risultato con la procedura descritta per il browser.

Un esempio documentato per i siti statici su Netlify

Per un sito statico esistente su Netlify, il meccanismo documentato prevede un file chiamato 404.html. Netlify lo usa automaticamente per i percorsi non validi che non corrispondono a un file statico. È un esempio specifico del provider, con alcuni prerequisiti: accesso all’output finale del sito e una build di pagine statiche esistente. Netlify documenta la gestione personalizzata degli errori 404.

  1. Usa il modello di pagina esistente del sito per creare la pagina di documento mancante.
  2. Assicurati che l’output finale includa 404.html nella directory di pubblicazione.
  3. Verifica che nessuna regola di routing precedente invii gli indirizzi sconosciuti a un’altra pagina.
  4. Quando il nuovo output è disponibile all’indirizzo pubblico, controlla sia un percorso mancante sia un documento funzionante.

La verifica del routing è importante perché Netlify elabora il routing prima di passare ai file statici e alla gestione finale delle pagine mancanti. Una richiesta già gestita in precedenza non raggiungerà quel gestore finale. La documentazione Request Chain ne spiega l’ordine. Questo esempio descrive un percorso di correzione; non indica che sia stato modificato alcun sito.

Il limite delle applicazioni con routing nel browser

Alcune applicazioni scoprono che un documento è assente solo dopo l’esecuzione di JavaScript. Google riconosce che nei sistemi di routing lato client può essere difficile restituire codici di stato significativi. Le alternative documentate sono un reindirizzamento JavaScript verso un indirizzo il cui server restituisce 404, oppure l’aggiunta dei metadati noindex alla pagina di errore. Consulta le indicazioni SEO di Google per JavaScript.

Queste alternative producono risultati diversi. Il reindirizzamento porta a un nuovo indirizzo con una vera risposta di pagina mancante. L’approccio basato sui metadati interviene sull’indicizzazione lasciando invariato lo stato HTTP originale. Se il requisito è mantenere l’indirizzo originale del documento e restituire 404 a quell’indirizzo, la risposta dell’hosting o dell’applicazione deve supportare tale comportamento.

Cosa dovrebbe dire la pagina del documento mancante?

Usa un messaggio breve e specifico, per esempio Impossibile trovare questo documento. Poi indica una sola azione utile: un collegamento all’indice dei documenti o a un’altra destinazione di navigazione verificata. Mantieni la navigazione e l’aspetto abituali del sito. Google consiglia un linguaggio chiaro, un design coerente e collegamenti utili per le pagine di errore personalizzate.

Per il fittizio esempio delle istruzioni di piegatura della carta, una formulazione adatta potrebbe essere: Non abbiamo trovato questo documento sulla piegatura della carta. Consulta l’indice dei documenti per scegliere un’altra guida. Descrivi un documento come rimosso permanentemente solo quando ne hai la certezza. Mantieni visibile la spiegazione invece di reindirizzare subito altrove ogni indirizzo mancante.

Come si verifica che la risposta e la pagina corrispondano?

Ripeti l’ispezione con un piccolo gruppo di confronto. I risultati previsti qui sotto sono criteri di accettazione a titolo illustrativo, non risultati di test effettivi.

Caso di prova Risposta e pagina previste
Documento funzionante noto 200, con il documento completo
Percorso deliberatamente inesistente 404, con la spiegazione del documento mancante
Documento rimosso senza sostituzione 404 oppure 410 quando appropriato, con una spiegazione accurata
Documento spostato con una sostituzione equivalente Reindirizzamento permanente, seguito dalla risposta corretta della sostituzione

Ripeti il test inserendo direttamente ogni indirizzo e ricaricandolo, inclusi i documenti che di solito vengono raggiunti tramite la navigazione all’interno della pagina. In questo modo controlli la risposta ricevuta da una nuova richiesta del documento. Tieni insieme indirizzo, codice e risultato visibile, così la destinazione raggiunta con successo non nasconde una risposta errata precedente nella navigazione.

Se persiste un risultato precedente, distingui la cache del browser dalle altre cache. Disattivare la cache di Chrome interviene sulla cache del browser. Anche la cache HTTP può memorizzare risposte negative come 404, perciò una risposta di documento mancante non aggiornata potrebbe richiedere di controllare il comportamento della cache documentato dal sistema di pubblicazione. RFC 9111 spiega i risultati negativi memorizzabili nella cache.

Per Google Search, una vera risposta di documento mancante ha una conseguenza prevista: Google non indicizza gli URL che restituiscono 404 o 410 e rimuove gli URL già indicizzati man mano che elabora tali risposte. Anche una risposta 200 corretta non garantisce l’indicizzazione. Consulta Come i codici di stato HTTP influiscono sui crawler di Google.

Concludi quando ogni indirizzo verificato racconta una storia coerente: i documenti disponibili si caricano correttamente, quelli spostati conducono alle rispettive sostituzioni e quelli assenti restituiscono una risposta di documento mancante appropriata con indicazioni utili. Avrai così un controllo di pubblicazione concreto e ripetibile da eseguire sul tuo Mac.

Fonti