Cum să remediați mesajele de eroare comune Nginx: un ghid pas cu pas

Ce este eroarea NGINX?

O eroare Nginx se referă la un sughiț sau o eroare care apare în timpul utilizării serverului web Nginx. Nginx este serverul web utilizat pe scară largă, pe care se bazează majoritatea site-urilor web. Cu toate acestea, ca orice software, poate întâmpina erori care pot perturba buna funcționare a site-ului dvs.

De exemplu, gândiți-vă la asta ca la o denivelare care poate întrerupe funcționarea normală a site-ului dvs. web sau a oricărei aplicații web. Nginx, fiind un sistem software foarte complex, poate întâmpina uneori probleme cauzate de diverși factori. Cum ar fi setări incorecte, probleme care apar pe server, probleme de rețea sau chiar greșeli făcute de client.

Erorile Nginx se pot manifesta sub diferite forme, dintre care unele s-ar putea să le cunoașteți deja. De exemplu, acestea includ eroarea 502 Bad Gateway Error nginx, 404 Not Found Error, 503 Service Unavailable Error, 504 Gateway Timeout Error, precum și erorile de redirecționare (301 și 302).

Pentru a asigura o experiență perfectă pentru vizitatorii site-ului dvs., gestionarea eficientă a erorilor nginx este esențială. Nginx, serverul web, întâlnește erori din când în când și le comunică folosind coduri de eroare specifice. Înțelegând aceste coduri, puteți identifica cu ușurință natura problemei și puteți să le remediați în consecință.

În acest ghid cuprinzător, vom cerceta erorile comune Nginx, vom explora cauzele acestora și vom oferi soluții practice pentru a vă ajuta să depanați și să rezolvați aceste probleme în mod eficient.

Câteva tipuri comune de erori Nginx

Erorile Nginx pot proveni din diverse surse, inclusiv configurări greșite, probleme la nivelul serverului, probleme de rețea sau solicitări ale clienților. Să aruncăm o privire la câteva tipuri comune de erori Nginx pe care le puteți întâlni:

Mesaje de eroare și soluții comune Nginx:

1. 502 Eroare de gateway greșit:

• Cauze: Această eroare apare adesea atunci când Nginx acționează ca un proxy și nu reușește să primească un răspuns valid de la un server din amonte.
• Soluții: Pentru a rezolva acest lucru, verificați configurația serverului din amonte, verificați conectivitatea la rețea și asigurați-vă că serverul este funcțional.

Citiți: Cum se remediază eroarea 502 Bad Gateway NGINX? (7 metode)

2. Eroare 404 negăsit:

Când vizitați un site web configurat de Nginx, acesta s-a conectat cu succes la serverul site-ului web, dar nu a reușit să găsească resursele solicitate, cum ar fi orice nume de fișier sau URL. Și acest tip de mesaj de eroare este declanșat în general din cauza problemelor fișierului de configurare.

• Cauze: Această eroare indică faptul că resursa solicitată nu este găsită pe server.
• Soluții: Pentru a rezolva acest lucru, verificați existența fișierului sau directorului nginx.conf, examinați configurația URL și verificați dacă există probleme de sensibilitate la majuscule și minuscule.

Citiți: Cum să remediați eroarea 404 Not Found pentru site-ul WordPress și Android?

3. 503 Eroare serviciu indisponibil:

• Cauze: Această eroare apare atunci când serverul nu poate gestiona temporar solicitările.
• Soluții: Pentru a rezolva această problemă, verificați încărcarea serverului, reporniți Nginx, analizați starea de sănătate a serverelor de backend sau implementați mecanisme adecvate de stocare în cache.

Citiți: Cum se remediază „Serviciul de eroare HTTP 503 indisponibil”?

4. Eroare 504 Gateway Timeout (continuare):

• Cauze: Această eroare apare de obicei atunci când serverul din amonte nu reușește să răspundă într-o limită de timp specificată.
• Soluții: Pentru a rezolva acest lucru, verificați configurația serverului din amonte, asigurați-vă conectivitatea corespunzătoare la rețea și ajustați setările de timeout în Nginx pentru a permite timpi de răspuns mai lungi, dacă este necesar.

Citiți: Cum se remediază eroarea HTTP 504 Gateway Timeout?

5. Probleme de redirecționare 301 și 302:

• Cauze: Aceste erori apar atunci când există probleme cu redirecționarea URL, cum ar fi configurații incorecte sau bucle în procesul de redirecționare.
• Solutii:

• Verificați configurația Nginx: Verificați fișierele de configurare Nginx pentru a vă asigura că regulile de redirecționare sunt definite corect. De obicei, fișierul de configurare se află la /etc/nginx/nginx.conf sau într-un fișier separat din directorul /etc/nginx/conf.d/ .
• Verificați configurația blocului serverului: în fișierul de configurare, localizați blocul serverului care corespunde domeniului sau gazdei virtuale afectate. Asigurați-vă că server_name corespunzător directivei este setat la numele de domeniu corect.
• Examinați regulile de redirecționare: examinați blocurile location sau blocurile server care definesc regulile de redirecționare. Asigurați-vă că directivele rewrite sau return sunt configurate corect pentru a redirecționa cererile către locația dorită. Acordați atenție expresiilor regulate și adreselor URL de destinație.
• Reporniți Nginx : După ce faceți orice modificări la fișierele de configurare, trebuie să reporniți serviciul Nginx pentru a aplica modificările. Utilizați următoarea comandă pentru a reporni Nginx:

sudo service nginx restart

• Ștergeți memoria cache a browserului : uneori, browserele memorează în cache răspunsurile de redirecționare. Goliți memoria cache a browserului sau încercați să accesați site-ul într-o fereastră privată sau incognito pentru a vă asigura că memoria cache nu interferează cu redirecționarea.
• Testați redirecționarea : deschideți un browser web și încercați să accesați adresa URL care ar trebui să declanșeze redirecționarea. Verificați dacă redirecționarea funcționează conform așteptărilor și că destinația dorită este atinsă.
• Verificați jurnalele pentru erori: dacă redirecționarea încă nu funcționează, examinați jurnalele de eroare Nginx ( /var/log/nginx/error.log ) pentru orice mesaje de eroare relevante. Jurnalele pot oferi informații valoroase pentru a identifica cauza problemei.

Urmând acești pași, ar trebui să puteți diagnostica și remedia problemele comune de redirecționare în Nginx.

Cum repar o eroare NGINX?

Acum că ați văzut unele dintre erorile comune NGINX, este posibil să aveți o întrebare în minte: „Cum repar o eroare NGINX?”

Ei bine, răspunsul nu este atât de dur pe cât ar părea. Există diverse metode de depanare disponibile pentru erorile NGINX. Cu toate acestea, este important să rețineți că aceste metode de depanare sunt doar pentru faza inițială. Sunt necesare investigații suplimentare pentru a stabili cauza exactă a problemei.

Practic, există trei comenzi care vă pot ajuta să vă începeți călătoria de depanare a erorilor NGINX.

• Obțineți jurnalul de erori și detaliile problemei folosind această comandă: sudo cat /var/log/nginx/error.log
• Pentru verificarea stării active a Nginx: sudo systemctl status nginx
• Pentru verificarea erorilor de sintaxă din fișierul de configurare: sudo nginx -t

1. Depanarea erorilor Nginx cu jurnalele de erori

Când întâmpinați o problemă cu NGINX, cele mai multe dintre aceste erori NGINX sunt vagi și nu este ușor să înțelegeți problema reală. Eroarea poate fi declanșată din cauza unei probleme mai mari sau ar putea fi complet fără legătură.

Totul depinde de modul în care ați configurat configurația NGINX și de situația specifică cu care vă confruntați.

Pentru a înțelege mai bine erorile NGINX care apar, puteți rula o comandă pentru a vizualiza o listă a acestor erori. Iată comanda:

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

Pentru a rula această comandă, va trebui să fii un utilizator privilegiat. Este recomandat să aveți acces sudo în loc să utilizați utilizatorul root.

Această comandă vă permite să citiți întregul conținut al fișierului /var/log/nginx/error.log, care conține jurnalele de erori NGINX. Acesta va afișa aceste jurnale în fereastra terminalului.

Rulând această comandă, veți putea vedea o listă a erorilor NGINX care au fost înregistrate. Nu uitați un lucru dacă nu există erori înregistrate în jurnal, nu veți vedea nicio ieșire când executați comanda.

Iată un exemplu de jurnal de erori pentru referință,

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"

În acest exemplu, fiecare linie reprezintă o eroare separată înregistrată de NGINX. Să defalcăm informațiile furnizate:

• Marca temporală: prima parte a fiecărui rând arată data și ora la care a apărut eroarea, formatată ca YYYY/MM/DD HH:MM:SS .
• Nivel de eroare: eticheta [error] indică faptul că această linie reprezintă o eroare.
• ID proces: numărul de după simbolul # (de exemplu, 1234#0 ) reprezintă ID-ul procesului NGINX care gestionează cererea.
• Mesaj de eroare: mesajul de eroare oferă detalii despre eroarea specifică. Include informații cum ar fi eșecuri de acces la fișiere sau resurse, expirări ale conexiunii în amonte sau probleme interne de redirecționare.
• Client IP: Câmpul client afișează adresa IP a clientului care face cererea către server.
• Nume server: câmpul server indică numele serverului sau gazda virtuală unde a apărut eroarea.
• Detalii cerere: câmpul request arată metoda HTTP, adresa URL solicitată și versiunea protocolului utilizată de client.
• Gazdă: Câmpul host specifică numele de gazdă sau adresa IP utilizată în cerere.

Fiecare intrare din jurnalul de erori ajută la diagnosticarea și depanarea problemelor, oferind informații despre tipul de eroare, resursa afectată, IP-ul clientului și alte detalii relevante.

2. Depanarea NGINX prin verificarea stării acestuia

O altă metodă prin care puteți încerca să depanați NGINX este prin verificarea stării acestuia, adică dacă este activ sau nu. Există posibilitatea ca, din anumite motive, procesul de instalare să nu poată fi finalizat sau serviciul să nu fie încă activ.

Pentru a verifica starea serviciului NGINX, utilizați următoarea comandă:

sudo systemctl status nginx

Dacă serviciul NGINX este activ, rezultatul va fi ca;

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

iar dacă starea NGINX este inactivă, ieșirea sudo systemctl status nginx comanda va indica faptul că serviciul este inactiv sau oprit după cum urmează.

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/

Dacă este cazul, singurul lucru pe care trebuie să-l faceți este să reporniți serviciul NGINX folosind această comandă:

sudo systemctl restart nginx

După aceea, puteți utiliza din nou comanda de stare pentru a verifica dacă serviciul NGINX este acum activ sau nu.

3. Depanarea NGINX prin verificarea erorii de sintaxă

Erorile de sintaxă sunt o problemă comună care poate apărea la scrierea de scripturi, coduri sau la configurarea fișierelor Nginx.

Indiferent dacă ați folosit o structură de sintaxă incorectă sau ați omis anumite caractere, o sintaxă incorectă va împiedica codul sau configurația să funcționeze corect.

În cazul fișierelor de configurare Nginx, acestea cuprind diverse directive, fiecare dintre ele trebuie declarată cu precizie pentru funcționarea corectă. În caz contrar, nu va funcționa conform intenției.

Pentru a verifica orice eroare de sintaxă în fișierul de configurare Nginx, utilizați următoarea comandă.

sudo nginx -t

Dacă sintaxa s-a dovedit a fi corectă, rezultatul va fi,

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

Cu toate acestea, dacă există o problemă în sintaxă, rezultatul va fi afișat ca,

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

Efectuând această verificare, puteți identifica și rectifica orice erori de sintaxă, garantând că configurația dvs. Nginx este exactă și completă. Este o practică bună să rulați această comandă ori de câte ori faceți modificări în fișierul de configurare sau înainte de a reporni Nginx pentru a evita orice probleme cauzate de erori de sintaxă.

Notă: Vă recomandăm să rulați această comandă de sintaxă pentru a verifica dacă există erori în fișierul dvs. de configurare Nginx și pentru a vă asigura că nu lipsește nimic.

rezumat

În rezumat, erorile Nginx pot apărea în timpul utilizării serverului web Nginx, cauzând întreruperi site-ului sau aplicației dvs. web. Aceste erori vin sub diferite forme, inclusiv Eroare 502 Bad Gateway, 404 Not Found Error, 503 Service Unavailable Error, 504 Gateway Timeout Error și erori de redirecționare (301 și 302).

Pentru a depana erorile Nginx în mod eficient, este important să înțelegeți cauzele acestora și să luați măsurile adecvate. Declanșatoarele obișnuite pentru erorile Nginx includ greșelile fișierului de configurare, problemele de pe partea serverului, problemele de rețea sau solicitările clientului. Soluțiile practice implică diagnosticarea cauzei principale prin verificarea jurnalelor de erori, căutarea erorilor de sintaxă sau monitorizarea stării active a lui Nginx.

Rețineți, deși aceste metode de depanare pot fi utile inițial, pot fi necesare investigații suplimentare pentru a identifica cauza exactă a problemei.

Urmând aceste metode de depanare și implementând soluțiile adecvate, puteți diagnostica și remedia în mod eficient erorile comune Nginx, asigurând o experiență fără probleme pentru vizitatorii site-ului dvs.

întrebări frecvente