Come correggere i messaggi di errore comuni di Nginx: una guida dettagliata

Qual è l'errore NGINX?

Un errore Nginx si riferisce a un singhiozzo o a un problema tecnico che si verifica durante l'utilizzo del server Web Nginx. Nginx è il server Web ampiamente utilizzato, su cui si basa la maggior parte dei siti Web. Tuttavia, come qualsiasi software, può riscontrare errori che potrebbero interrompere il buon funzionamento del tuo sito web.

Ad esempio, pensalo come un ostacolo sulla strada che può interrompere il normale funzionamento del tuo sito web o di qualsiasi applicazione web. Nginx, essendo un sistema software molto complesso, a volte può incorrere in problemi causati da vari fattori. Come impostazioni errate, problemi che si verificano sul lato server, problemi di rete o persino errori commessi dal client.

Gli errori di Nginx possono manifestarsi in varie forme, alcune delle quali potresti già conoscere. Ad esempio, questi includono 502 Bad Gateway Error nginx, 404 Not Found Error, 503 Service Unavailable Error, 504 Gateway Timeout Error, nonché errori di reindirizzamento (301 e 302).

Per garantire un'esperienza senza interruzioni ai visitatori del tuo sito Web, è essenziale gestire gli errori nginx in modo efficace. Nginx, il web server, incontra di volta in volta errori e li comunica utilizzando specifici codici di errore. Comprendendo questi codici, puoi facilmente identificare la natura del problema e risolverli di conseguenza.

In questa guida completa, analizzeremo gli errori comuni di Nginx, ne esploreremo le cause e forniremo soluzioni pratiche per aiutarti a risolvere efficacemente questi problemi.

Alcuni tipi comuni di errori Nginx

Gli errori Nginx possono derivare da varie fonti, tra cui configurazioni errate, problemi sul lato server, problemi di rete o richieste del client. Diamo un'occhiata ad alcuni tipi comuni di errori Nginx che potresti riscontrare:

Messaggi di errore e soluzioni Nginx comuni:

1. Errore 502 Gateway errato:

• Cause: questo errore si verifica spesso quando Nginx funge da proxy e non riesce a ricevere una risposta valida da un server upstream.
• Soluzioni: per risolvere questo problema, controllare la configurazione del server upstream, verificare la connettività di rete e assicurarsi che il server sia operativo.

Leggi: Come risolvere l'errore 502 Bad Gateway NGINX? (7 metodi)

2. Errore 404 non trovato:

Quando visiti un sito Web configurato con Nginx, si è connesso correttamente al server del sito Web ma non è stato in grado di trovare le risorse richieste come qualsiasi nome file o URL. E questo tipo di messaggio di errore viene generalmente attivato a causa di problemi con il file di configurazione.

• Cause: questo errore indica che la risorsa richiesta non è stata trovata sul server.
• Soluzioni: per risolvere questo problema, verificare l'esistenza del file o della directory nginx.conf, esaminare la configurazione dell'URL e verificare la presenza di problemi di distinzione tra maiuscole e minuscole.

Leggi: Come risolvere l'errore 404 non trovato per il sito WordPress e Android?

3. Errore 503 Servizio non disponibile:

• Cause: questo errore si verifica quando il server non è temporaneamente in grado di gestire le richieste.
• Soluzioni: per affrontare questo problema, controllare il carico del server, riavviare Nginx, analizzare lo stato dei server di back-end o implementare meccanismi di memorizzazione nella cache adeguati.

Leggi: Come risolvere "Errore HTTP 503 Servizio non disponibile"?

4. Errore di timeout del gateway 504 (continua):

• Cause: questo errore si verifica in genere quando il server upstream non risponde entro un limite di tempo specificato.
• Soluzioni: per risolvere questo problema, controllare la configurazione del server upstream, garantire la corretta connettività di rete e regolare le impostazioni di timeout in Nginx per consentire tempi di risposta più lunghi, se necessario.

Leggi: Come correggere l'errore di timeout del gateway HTTP 504?

5. Problemi di reindirizzamento 301 e 302:

• Cause: questi errori si verificano quando si verificano problemi con il reindirizzamento dell'URL, ad esempio configurazioni errate o loop nel processo di reindirizzamento.
• Soluzioni:

• Verifica la configurazione di Nginx: controlla i file di configurazione di Nginx per assicurarti che le regole di reindirizzamento siano definite correttamente. In genere, il file di configurazione si trova in /etc/nginx/nginx.conf o in un file separato all'interno della directory /etc/nginx/conf.d/ .
• Controllare la configurazione del blocco del server: all'interno del file di configurazione, individuare il blocco del server che corrisponde al dominio interessato o all'host virtuale. Assicurarsi che il server_name appropriato della direttiva sia impostato sul nome di dominio corretto.
• Esamina le regole di reindirizzamento: esamina i blocchi location o i blocchi server che definiscono le regole di reindirizzamento. Assicurarsi che le direttive rewrite o return siano configurate correttamente per reindirizzare le richieste alla posizione desiderata. Presta attenzione alle espressioni regolari e agli URL di destinazione.
• Riavvia Nginx : dopo aver apportato modifiche ai file di configurazione, è necessario riavviare il servizio Nginx per applicare le modifiche. Usa il seguente comando per riavviare Nginx:

sudo service nginx restart

• Cancella cache del browser : a volte, i browser memorizzano nella cache le risposte di reindirizzamento. Svuota la cache del browser o prova ad accedere al sito Web in una finestra privata o in incognito per assicurarti che la cache non interferisca con il reindirizzamento.
• Testare il reindirizzamento : aprire un browser Web e provare ad accedere all'URL che dovrebbe attivare il reindirizzamento. Verificare che il reindirizzamento funzioni come previsto e che venga raggiunta la destinazione desiderata.
• Controlla i log per gli errori: se il reindirizzamento continua a non funzionare, esamina i log degli errori di Nginx ( /var/log/nginx/error.log ) per eventuali messaggi di errore pertinenti. I registri possono fornire informazioni preziose per identificare la causa del problema.

Seguendo questi passaggi, dovresti essere in grado di diagnosticare e risolvere problemi di reindirizzamento comuni in Nginx.

Come posso correggere un errore NGINX?

Ora che hai visto alcuni degli errori NGINX comuni, potresti avere una domanda in mente: "Come posso correggere un errore NGINX?"

Bene, la risposta non è così difficile come potrebbe sembrare. Sono disponibili vari metodi di risoluzione dei problemi per gli errori NGINX. Tuttavia, è importante notare che questi metodi di risoluzione dei problemi sono solo per la fase iniziale. Sono necessarie ulteriori indagini per determinare la causa esatta del problema.

Esistono fondamentalmente tre comandi che possono aiutarti a iniziare il tuo viaggio di risoluzione dei problemi per gli errori NGINX.

• Ottieni il registro degli errori e i dettagli del problema utilizzando questo comando: sudo cat /var/log/nginx/error.log
• Per controllare lo stato attivo di Nginx: sudo systemctl status nginx
• Per controllare gli errori di sintassi nel file di configurazione: sudo nginx -t

1. Risoluzione degli errori di Nginx con i log degli errori

Quando riscontri un problema con NGINX, la maggior parte di questi errori NGINX sono vaghi e non è facile capire semplicemente il problema reale. L'errore può essere attivato a causa di un problema più grande o potrebbe essere completamente estraneo.

Tutto dipende da come hai configurato la tua configurazione NGINX e dalla situazione specifica che stai affrontando.

Per comprendere meglio gli errori NGINX che si verificano, puoi eseguire un comando per visualizzare un elenco di questi errori. Ecco il comando:

sudo cat /var/log/nginx/error.log

Per eseguire questo comando, dovrai essere un utente privilegiato. Si consiglia di disporre dell'accesso sudo invece di utilizzare l'utente root.

Questo comando consente di leggere l'intero contenuto del file /var/log/nginx/error.log, che contiene i log degli errori di NGINX. Visualizzerà questi registri nella finestra del terminale.

Eseguendo questo comando, sarai in grado di vedere un elenco degli errori NGINX che sono stati registrati. Ricorda una cosa se non ci sono errori registrati nel registro, non vedrai alcun output quando esegui il comando.

Ecco un esempio di log degli errori per tuo riferimento,

2023/05/31 10:15:23 [error] 1234#0: *1 open() "/var/www/html/missing-page.html"
failed (2: No such file or directory), client: 192.168.0.1, server: example.com,
request: "GET /nonexistent-page HTTP/1.1", host: "example.com"

2023/05/31 12:45:57 [error] 1234#0: *2 upstream timed out (110: Connection timed out)
while reading response header from upstream, client: 192.168.0.2, server:
example.com, request: "GET /api/data HTTP/1.1", upstream:
"http://127.0.0.1:8000/api/data", host: "example.com"

2023/05/31 15:22:10 [error] 1234#0: *3 rewrite or internal redirection cycle while internally redirecting to "/index.php", client: 192.168.0.3, server: example.com, request: "GET /category/products/ HTTP/1.1", host: "example.com"

In questo esempio, ogni riga rappresenta un errore separato registrato da NGINX. Analizziamo le informazioni fornite:

• Timestamp: la prima parte di ogni riga mostra la data e l'ora in cui si è verificato l'errore, nel formato YYYY/MM/DD HH:MM:SS .
• Livello di errore: il tag [error] indica che questa riga rappresenta un errore.
• ID processo: il numero dopo il simbolo # (ad esempio, 1234#0 ) rappresenta l'ID del processo NGINX che gestisce la richiesta.
• Messaggio di errore: il messaggio di errore fornisce dettagli sull'errore specifico. Include informazioni come errori di accesso a file o risorse, timeout della connessione a monte o problemi di reindirizzamento interno.
• IP client: il campo client visualizza l'indirizzo IP del client che effettua la richiesta al server.
• Nome server: il campo server indica il nome del server o l'host virtuale in cui si è verificato l'errore.
• Dettagli della richiesta: il campo request mostra il metodo HTTP, l'URL richiesto e la versione del protocollo utilizzata dal client.
• Host: il campo host specifica il nome host o l'indirizzo IP utilizzato nella richiesta.

Ogni voce del log degli errori aiuta a diagnosticare e risolvere i problemi fornendo informazioni sul tipo di errore, sulla risorsa interessata, sull'IP del client e altri dettagli rilevanti.

2. Risoluzione dei problemi di NGINX controllandone lo stato

Un altro metodo che puoi provare per risolvere i problemi di NGINX è controllarne lo stato, ovvero se è attivo o meno. Esiste la possibilità che, per determinati motivi, il processo di installazione non possa essere completato o che il servizio non sia ancora attivo.

Per verificare lo stato del servizio NGINX utilizzare il seguente comando:

sudo systemctl status nginx

Se il servizio NGINX è attivo, l'output sarà come;

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset:
enabled)
Active: active (running) since Mon 2023-05-31 14:30:00 UTC; 5min ago
Docs: http://nginx.org/en/docs/
Process: 1234 ExecStart=/usr/sbin/nginx -g daemon on;
master_process on;
(code=exited, status=0/SUCCESS)
Main PID: 1234 (nginx)
Tasks: 2 (limit: 2319)
Memory: 3.9M
CGroup: /system.slice/nginx.service
├─1234 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
└─5678 nginx: worker process

e se lo stato NGINX è inattivo l'output del sudo systemctl status nginx il comando indicherà che il servizio è inattivo o interrotto come segue.

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: inactive (dead)
Docs: http://nginx.org/en/docs/

In tal caso, l'unica cosa che devi fare è riavviare il tuo servizio NGINX usando questo comando:

sudo systemctl restart nginx

Successivamente, puoi utilizzare nuovamente il comando status per verificare se il servizio NGINX è ora attivo o meno.

3. Risoluzione dei problemi di NGINX controllando l'errore di sintassi

Gli errori di sintassi sono un problema comune che può verificarsi durante la scrittura di script, codici o la configurazione di file Nginx.

Indipendentemente dal fatto che tu abbia utilizzato una struttura di sintassi errata o omesso determinati caratteri, una sintassi errata impedirà il corretto funzionamento del codice o della configurazione.

Nel caso dei file di configurazione Nginx, comprendono varie direttive, ciascuna delle quali deve essere dichiarata accuratamente per il corretto funzionamento. Altrimenti, non funzionerà come previsto.

Per verificare eventuali errori di sintassi nel file di configurazione di Nginx, utilizzare il seguente comando.

sudo nginx -t

Se la sintassi si è rivelata corretta, l'output sarà,

nginx: configuration file /etc/nginx/nginx.conf test is successful

Tuttavia, se c'è un problema nella sintassi, l'output verrà visualizzato come,

nginx: [emerg] unexpected end of file, expecting ";" or "}" in
/etc/nginx/nginx.conf:42
nginx: configuration file /etc/nginx/nginx.conf test failed

Eseguendo questo controllo, puoi identificare e correggere eventuali errori di sintassi, garantendo che la tua configurazione di Nginx sia accurata e completa. È buona norma eseguire questo comando ogni volta che si apportano modifiche al file di configurazione o prima di riavviare Nginx per evitare eventuali problemi causati da errori di sintassi.

Nota: consigliamo vivamente di eseguire questo comando di sintassi per verificare eventuali errori nel file di configurazione di Nginx e assicurarsi che non manchi nulla.

Riepilogo

In sintesi, gli errori Nginx possono verificarsi durante l'utilizzo del server Web Nginx, causando interruzioni del sito Web o dell'applicazione Web. Questi errori si presentano in varie forme, tra cui l'errore 502 Bad Gateway, 404 Not Found Error, 503 Service Unavailable Error, 504 Gateway Timeout Error ed errori di reindirizzamento (301 e 302).

Per risolvere efficacemente gli errori di Nginx, è importante comprenderne le cause e intraprendere le azioni appropriate. I trigger comuni per gli errori Nginx includono errori del file di configurazione, problemi sul lato server, problemi di rete o richieste del client. Le soluzioni pratiche implicano la diagnosi della causa principale controllando i log degli errori, cercando errori di sintassi o monitorando lo stato attivo di Nginx.

Ricorda, mentre questi metodi di risoluzione dei problemi possono essere utili inizialmente, potrebbero essere necessarie ulteriori indagini per individuare la causa esatta del problema.

Seguendo questi metodi di risoluzione dei problemi e implementando le soluzioni appropriate, puoi diagnosticare e correggere in modo efficace gli errori comuni di Nginx, garantendo un'esperienza fluida per i visitatori del tuo sito web.

Domande frequenti