Cosa significano davvero 403, 404, 500, 502, 503 e 504 su questa piattaforma, e la cosa specifica da fare per ciascuno.
Un codice di errore non è un messaggio di errore generico. Indica quale livello dello stack ha ceduto, e questo restringe enormemente la causa. Un 502 e un 504 appaiono identici a un visitatore ma hanno cause e soluzioni completamente diverse.
Leggere il codice reale
Prima di risolvere il problema, procurati il numero reale. Una pagina di errore ben fatta può dire una cosa mentre il server ne restituisce un'altra.
Nel tuo browser, apri gli strumenti per sviluppatori, vai alla scheda Network, ricarica la pagina e clicca sulla prima richiesta. Lo stato si trova in cima al pannello Headers.
Da terminale:
curl -sSI https://yourdomain.com/
Questo stampa la riga di stato e gli header di risposta senza scaricare la pagina. Gli header contano: diversi dei casi seguenti si identificano tramite un header piuttosto che tramite il solo codice.
La versione breve
| Codice | Significato | Di chi è il problema |
|---|---|---|
| 401 | Autenticazione richiesta | La protezione con password è attiva |
| 403 | Rifiutato intenzionalmente | Una regola di sicurezza ha bloccato la richiesta |
| 404 | Non trovato | Il tuo sito, di solito il routing |
| 500 | La tua applicazione si è bloccata | Il tuo codice o un plugin |
| 502 | Il server dietro il web server ha fallito | Di solito la tua applicazione |
| 503 | Volontariamente non in servizio al momento | Sospeso, in pausa o in manutenzione |
| 504 | Ci ha messo troppo tempo | Qualcosa nel tuo codice è lento |
401 Unauthorized
Vedrai una finestra del browser per nome utente e password anziché una pagina. Significa che la protezione con password di base è attiva sul sito o su quel percorso.
Disattivala, oppure recupera le credenziali, da Siti web, il sito, Impostazioni, poi Protezione con password. Vedi Protezione con password.
Il rinnovo del certificato continua a funzionare mentre la protezione con password è attiva, quindi questo non comprometterà il tuo HTTPS.
403 Forbidden
403 significa che qualcosa ha rifiutato intenzionalmente la richiesta. Su questa piattaforma ci sono quattro fonti distinte.
Il web application firewall. Ogni sito si trova dietro un motore di regole che ispeziona le richieste in arrivo e blocca quelle che corrispondono a schemi di attacco noti. Questa è la fonte più comune di un 403 inatteso, ed è quasi sempre un falso positivo su una richiesta legittima ma insolita: un invio di modulo lungo, un page builder che salva contenuti complessi, un plugin che invia codice grezzo.
Sintomi di un blocco del firewall: un'azione specifica fallisce sempre con 403 mentre il resto del sito funziona bene, e fallisce in modo identico in un browser diverso e su una rete diversa.
La soluzione è un'esclusione mirata della regola, che il supporto può aggiungere. Non cercare un interruttore per disattivare il firewall; non ne esiste uno per l'hosting condiviso, e sarebbe comunque la soluzione sbagliata. Apri un ticket con l'URL esatto, l'orario esatto e cosa stavi facendo. Vedi Apertura di un ticket di supporto.
Geo-blocking. Se hai limitato il tuo sito a determinati paesi, chiunque altro riceve un 403. Controlla Impostazioni, poi Sicurezza. Vedi Geo-Blocking.
Un blocco IP. O uno che hai aggiunto tu stesso in Security, oppure un blocco anti-abuso a livello di piattaforma.
Un problema di permessi sui file o di symlink. Meno comune, e di solito compare dopo un'operazione manuale sui file via SSH.
404 Not Found
Il server ha risposto, ma a quell'indirizzo non c'è nulla.
Una sola pagina restituisce 404. Il file o il post effettivamente non esiste, oppure l'URL è sbagliato.
Ogni pagina tranne la homepage restituisce 404. Questo è un problema di routing, e su WordPress è quasi sempre legato ai permalink. Importante: l'hosting web di KapsuleHost usa nginx, non Apache, quindi le regole di rewrite .htaccess qui non hanno alcun effetto. Se sei migrato da un host che le usava, questa è la tua causa. Vedi Problemi con i permalink e WordPress e .htaccess.
L'intero sito restituisce 404. Controlla che il sito punti alla document root corretta e che il tuo dominio sia collegato al sito giusto. Vedi Dominio personalizzato per un sito web.
Funziona sulla tua macchina ma in produzione restituisce 404. I nomi file su Linux distinguono le maiuscole dalle minuscole. Logo.PNG e logo.png sono due file diversi.
500 Internal Server Error
La tua applicazione è partita ed è andata in crash. Il web server funziona bene; il codice no.
Questo è il caso in cui i log ti danno la risposta quasi immediatamente, perché un errore fatale di PHP registra il file e il numero di riga che ha fallito, il che solitamente indica il plugin esatto.
- Vai su Siti web, il sito, Impostazioni, poi Log.
- Guarda le voci più recenti.
- Confronta il timestamp con il momento in cui hai visto l'errore.
Vedi Log degli errori. Per la versione specifica di WordPress di questo problema, dove la pagina è bianca anziché mostrare un errore, vedi La schermata bianca di WordPress.
Le cause più comuni sono un plugin o un tema incompatibile con la tua versione di PHP, un limite di memoria raggiunto e una connessione al database non riuscita. Vedi Estensioni e impostazioni PHP e Limite di memoria di WordPress.
502 Bad Gateway
Il web server ha provato a consegnare la richiesta alla tua applicazione e non ha ricevuto nulla di utilizzabile. Il processo dell'applicazione ha rifiutato la connessione o è morto a metà richiesta.
Cause comuni:
- Un processo PHP è andato in crash, spesso per esaurimento della memoria su una singola richiesta.
- Un'applicazione Node.js non è in esecuzione, oppure è andata in crash all'avvio.
- Un picco di traffico ha esaurito i processi worker disponibili.
Cosa fare: controlla prima i log, come sopra. Se si tratta di un'applicazione Node, verifica se il processo è effettivamente attivo e guarda il suo output di avvio. Se i 502 compaiono solo nei momenti di maggior traffico, si tratta di un problema di capacità piuttosto che di un bug. Vedi Lentezza del sito e limiti di risorse.
Un 502 proveniente da KPanel stesso, durante il salvataggio di un'impostazione, significa qualcosa di diverso. Significa che il pannello non è riuscito ad applicare la modifica di configurazione al web server, e ha annullato la modifica piuttosto che lasciare il tuo sito a metà configurato. Il tuo sito web non è interessato. Riprova, e se continua a fallire, apri un ticket.
503 Service Unavailable
503 significa che il server volontariamente non sta servendo in questo momento. Ci sono tre cause specifiche su questa piattaforma, e la risposta indica quale.
Il tuo sito è sospeso. Vedrai una pagina intitolata "This site is paused". Questo è uno stato di fatturazione o dell'account, non un guasto tecnico, e il sito torna immediatamente attivo quando lo stato si risolve. Controlla Fatturazione. Vedi Pagamento non riuscito e Account sospeso.
Manutenzione della piattaforma. Una pagina di manutenzione per l'intera piattaforma, che è rara e annunciata. Controlla Stato e uptime.
504 Gateway Timeout
La tua applicazione stava ancora lavorando quando il web server ha esaurito la pazienza. Niente è andato in crash. Era semplicemente troppo lenta.
Cause tipiche:
- Un'importazione, esportazione, backup o operazione in blocco di lunga durata eseguita tramite il browser.
- Un plugin che chiama un'API esterna lenta a ogni caricamento di pagina.
- Una query al database costosa senza un indice dietro di essa.
- Un'attività cron attivata da una visualizzazione di pagina anziché da un vero cron.
Cosa fare:
- Identifica quale richiesta è lenta. La scheda APM sui siti WordPress te lo mostra. Vedi Prestazioni del sito.
- Per le operazioni lunghe, usa la riga di comando anziché il browser. Vedi WP-CLI.
- Sposta il lavoro pianificato su un vero cron. Vedi Attività cron.
- Aumenta
max_execution_timese il lavoro ha davvero bisogno di più tempo, anche se questa è una soluzione temporanea piuttosto che una vera correzione. Vedi Estensioni e impostazioni PHP.
Nota la differenza: se PHP raggiunge per primo il proprio limite di esecuzione ottieni un 500, non un 504. Entrambi significano "troppo lento", a livelli diversi.
Nessuna risposta
A volte non c'è alcun codice di errore, perché non c'è alcuna risposta. La connessione resta semplicemente in attesa e alla fine va in timeout.
Se ciò accade da una rete ma il sito funziona da un'altra, e specialmente da un telefono con dati mobili, la causa più probabile è un blocco automatico anti-abuso: un picco di errori o accessi falliti dal tuo indirizzo ha attivato un divieto temporaneo a livello di rete. Questi si risolvono da soli, di solito entro un'ora. Se hai bisogno che venga rimosso prima, contatta il supporto con l'indirizzo IP da cui ti stai connettendo.
Pagine di errore personalizzate
Puoi sostituire la pagina di errore predefinita per 400, 401, 403, 404, 500, 502, 503 e 504 con il tuo HTML, in Siti web, il sito, Impostazioni, poi Pagine di errore. KapsuleHost fornisce pagine predefinite personalizzate per 404, 500, 502, 503 e 504 se non lo fai tu.
Una cosa utile da sapere: una pagina di errore personalizzata mantiene il codice di stato reale. Un 404 personalizzato restituisce comunque 404. Servire la tua pagina di errore con uno stato 200 è un modo classico per distruggere il tuo posizionamento nei motori di ricerca, e qui non è intenzionalmente possibile. Vedi Pagine di errore personalizzate.