Comment corriger les messages d'erreur courants de Nginx : un guide étape par étape

Qu'est-ce que l'erreur NGINX ?

Une erreur Nginx fait référence à un hoquet ou à un problème qui se produit lors de l'utilisation du serveur Web Nginx. Nginx est le serveur Web largement utilisé, sur lequel la plupart des sites Web s'appuient. Cependant, comme tout logiciel, il peut rencontrer des erreurs susceptibles de perturber le bon fonctionnement de votre site internet.

Par exemple, considérez-le comme un obstacle sur la route qui peut interrompre le fonctionnement normal de votre site Web ou de toute application Web. Nginx, étant un système logiciel très complexe, peut parfois rencontrer des problèmes causés par divers facteurs. Tels que des paramètres incorrects, des problèmes survenant côté serveur, des problèmes de réseau ou même des erreurs commises par le client.

Les erreurs Nginx peuvent se manifester sous diverses formes, dont certaines vous sont peut-être déjà familières. Par exemple, ceux-ci incluent l'erreur 502 Bad Gateway Error nginx, l'erreur 404 Not Found, l'erreur 503 Service Unavailable, l'erreur 504 Gateway Timeout, ainsi que les erreurs de redirection (301 et 302).

Pour garantir une expérience transparente aux visiteurs de votre site Web, il est essentiel de gérer efficacement les erreurs nginx. Nginx, le serveur Web, rencontre des erreurs de temps en temps et les communique à l'aide de codes d'erreur spécifiques. En comprenant ces codes, vous pouvez facilement identifier la nature du problème et pouvoir les résoudre en conséquence.

Dans ce guide complet, nous approfondirons les erreurs courantes de Nginx, explorerons leurs causes et fournirons des solutions pratiques pour vous aider à dépanner et à résoudre efficacement ces problèmes.

Quelques types courants d'erreurs Nginx

Les erreurs Nginx peuvent provenir de diverses sources, notamment des erreurs de configuration, des problèmes côté serveur, des problèmes de réseau ou des demandes de clients. Jetons un coup d'œil à certains types courants d'erreurs Nginx que vous pouvez rencontrer :

Messages d'erreur et solutions courants de Nginx :

1. Erreur de passerelle 502 incorrecte :

• Causes : cette erreur se produit souvent lorsque Nginx agit en tant que proxy et ne reçoit pas de réponse valide d'un serveur en amont.
• Solutions : Pour résoudre ce problème, vérifiez la configuration du serveur en amont, vérifiez la connectivité réseau et assurez-vous que le serveur est opérationnel.

Lis : Comment réparer l'erreur 502 Bad Gateway NGINX ? (7 méthodes)

2. Erreur 404 introuvable :

Lorsque vous visitez un site Web configuré avec Nginx, il s'est connecté avec succès au serveur du site Web, mais il n'a pas pu trouver les ressources demandées telles que le nom de fichier ou l'URL. Et ce type de message d'erreur est généralement déclenché en raison de problèmes de fichier de configuration.

• Causes : Cette erreur indique que la ressource demandée est introuvable sur le serveur.
• Solutions : pour résoudre ce problème, vérifiez l'existence du fichier ou du répertoire nginx.conf, examinez la configuration de l'URL et recherchez les problèmes de sensibilité à la casse.

Lis : Comment réparer l'erreur 404 introuvable pour le site WordPress et Android ?

3. Erreur 503 Service indisponible :

• Causes : cette erreur se produit lorsque le serveur est temporairement incapable de traiter les requêtes.
• Solutions : pour résoudre ce problème, vérifiez la charge du serveur, redémarrez Nginx, analysez l'état des serveurs principaux ou implémentez des mécanismes de mise en cache appropriés.

Lis : Comment réparer "HTTP Error 503 Service Unavailable" ?

4. 504 Erreur de dépassement de délai de la passerelle (suite) :

• Causes : Cette erreur se produit généralement lorsque le serveur en amont ne répond pas dans un délai spécifié.
• Solutions : pour résoudre ce problème, vérifiez la configuration du serveur en amont, assurez-vous que la connectivité réseau est correcte et ajustez les paramètres de délai d'attente dans Nginx pour permettre des temps de réponse plus longs si nécessaire.

Lire : Comment réparer l'erreur de délai d'attente de la passerelle HTTP 504 ?

5. Problèmes de redirection 301 et 302 :

• Causes : ces erreurs se produisent en cas de problèmes de redirection d'URL, tels que des configurations incorrectes ou des boucles dans le processus de redirection.
• Solutions:

• Vérifiez la configuration Nginx : vérifiez les fichiers de configuration Nginx pour vous assurer que les règles de redirection sont correctement définies. Généralement, le fichier de configuration se trouve dans /etc/nginx/nginx.conf ou dans un fichier séparé dans le répertoire /etc/nginx/conf.d/ .
• Vérifiez la configuration du bloc de serveur : dans le fichier de configuration, localisez le bloc de serveur qui correspond au domaine ou à l'hôte virtuel concerné. Assurez-vous que la directive server_name appropriée est définie sur le nom de domaine correct.
• Passez en revue les règles de redirection : examinez les blocs location ou les blocs server qui définissent les règles de redirection. Assurez-vous que les directives rewrite ou return sont correctement configurées pour rediriger les demandes vers l'emplacement souhaité. Faites attention aux expressions régulières et aux URL de destination.
• Redémarrez Nginx : Après avoir apporté des modifications aux fichiers de configuration, vous devez redémarrer le service Nginx pour appliquer les modifications. Utilisez la commande suivante pour redémarrer Nginx :

sudo service nginx restart

• Effacer le cache du navigateur : Parfois, les navigateurs mettent en cache les réponses de redirection. Effacez le cache de votre navigateur ou essayez d'accéder au site Web dans une fenêtre privée ou incognito pour vous assurer que le cache n'interfère pas avec la redirection.
• Testez la redirection : Ouvrez un navigateur Web et essayez d'accéder à l'URL qui doit déclencher la redirection. Vérifiez que la redirection fonctionne comme prévu et que la destination souhaitée est atteinte.
• Vérifiez les erreurs dans les journaux : si la redirection ne fonctionne toujours pas, consultez les journaux d'erreurs Nginx ( /var/log/nginx/error.log ) pour tout message d'erreur pertinent. Les journaux peuvent fournir des informations précieuses pour identifier la cause du problème.

En suivant ces étapes, vous devriez être en mesure de diagnostiquer et de résoudre les problèmes de redirection courants dans Nginx.

Comment corriger une erreur NGINX ?

Maintenant que vous avez vu certaines des erreurs NGINX courantes, vous avez peut-être une question en tête : "Comment corriger une erreur NGINX ?"

Eh bien, la réponse n'est pas aussi difficile que cela puisse paraître. Il existe différentes méthodes de dépannage disponibles pour les erreurs NGINX. Cependant, il est important de noter que ces méthodes de dépannage ne concernent que la phase initiale. Une enquête plus approfondie est nécessaire pour déterminer la cause exacte du problème.

Il existe essentiellement trois commandes qui peuvent vous aider à démarrer votre parcours de dépannage pour les erreurs NGINX.

• Obtenez le journal des erreurs et les détails du problème à l'aide de cette commande : sudo cat /var/log/nginx/error.log
• Pour vérifier l'état actif de Nginx : sudo systemctl status nginx
• Pour vérifier les erreurs de syntaxe dans le fichier de configuration : sudo nginx -t

1. Dépannage des erreurs Nginx avec les journaux d'erreurs

Lorsque vous rencontrez un problème avec NGINX, la plupart de ces erreurs NGINX sont vagues et il n'est pas facile de comprendre simplement le problème réel. L'erreur peut être déclenchée en raison d'un problème plus important ou elle peut être totalement indépendante.

Tout dépend de la façon dont vous avez configuré votre configuration NGINX et de la situation spécifique à laquelle vous êtes confronté.

Pour mieux comprendre les erreurs NGINX qui se produisent, vous pouvez exécuter une commande pour afficher une liste de ces erreurs. Voici la commande :

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

Pour exécuter cette commande, vous devez être un utilisateur privilégié. Il est recommandé d'avoir un accès sudo au lieu d'utiliser l'utilisateur root.

Cette commande vous permet de lire tout le contenu du fichier /var/log/nginx/error.log, qui contient les journaux d'erreurs NGINX. Il affichera ces journaux sur la fenêtre de votre terminal.

En exécutant cette commande, vous pourrez voir une liste des erreurs NGINX qui ont été enregistrées. N'oubliez pas une chose si aucune erreur n'est enregistrée dans le journal, vous ne verrez aucune sortie lorsque vous exécuterez la commande.

Voici un exemple de journal d'erreurs pour votre référence,

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"

Dans cet exemple, chaque ligne représente une erreur distincte consignée par NGINX. Décomposons les informations fournies :

• Horodatage : la première partie de chaque ligne indique la date et l'heure auxquelles l'erreur s'est produite, au format YYYY/MM/DD HH:MM:SS .
• Niveau d'erreur : la balise [error] indique que cette ligne représente une erreur.
• ID de processus : le nombre après le symbole # (par exemple, 1234#0 ) représente l'ID de processus NGINX traitant la demande.
• Message d'erreur : Le message d'erreur fournit des détails sur l'erreur spécifique. Il inclut des informations telles que des échecs d'accès à un fichier ou à une ressource, des délais d'attente de connexion en amont ou des problèmes de redirection interne.
• Client IP : Le champ client affiche l'adresse IP du client qui fait la demande au serveur.
• Nom du serveur : le champ server indique le nom du serveur ou l'hôte virtuel sur lequel l'erreur s'est produite.
• Détails de la demande : le champ request affiche la méthode HTTP, l'URL demandée et la version du protocole utilisée par le client.
• Hôte : le champ host spécifie le nom d'hôte ou l'adresse IP utilisé dans la demande.

Chaque entrée du journal des erreurs permet de diagnostiquer et de résoudre les problèmes en fournissant des informations sur le type d'erreur, la ressource affectée, l'adresse IP du client et d'autres détails pertinents.

2. Dépannage de NGINX en vérifiant son état

Une autre méthode que vous pouvez essayer pour dépanner NGINX consiste à vérifier son état, c'est-à-dire s'il est actif ou non. Il est possible que, pour certaines raisons, le processus d'installation ne puisse pas être terminé ou que le service ne soit pas encore actif.

Pour vérifier l'état du service NGINX, utilisez la commande suivante :

sudo systemctl status nginx

Si le service NGINX est actif, la sortie sera comme ;

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

et si le statut NGINX est inactif, la sortie du sudo systemctl status nginx la commande indiquera que le service est inactif ou arrêté comme suit.

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/

Si c'est le cas, la seule chose que vous devez faire est de redémarrer votre service NGINX en utilisant cette commande :

sudo systemctl restart nginx

Après cela, vous pouvez à nouveau utiliser la commande status pour vérifier si le service NGINX est maintenant actif ou non.

3. Dépannage de NGINX en vérifiant l'erreur de syntaxe

Les erreurs de syntaxe sont un problème courant qui peut survenir lors de l'écriture de scripts, de codes ou de la configuration de fichiers Nginx.

Que vous ayez utilisé une structure de syntaxe incorrecte ou omis certains caractères, une syntaxe incorrecte empêchera le code ou la configuration de fonctionner correctement.

Dans le cas des fichiers de configuration Nginx, ils comprennent diverses directives, dont chacune doit être déclarée avec précision pour un bon fonctionnement. Sinon, cela ne fonctionnera pas comme prévu.

Pour vérifier toute erreur de syntaxe dans votre fichier de configuration Nginx, utilisez la commande suivante.

sudo nginx -t

Si la syntaxe s'est avérée correcte, la sortie sera,

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

Cependant, s'il y a un problème dans la syntaxe, la sortie sera affichée comme suit :

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

En effectuant cette vérification, vous pouvez identifier et corriger toute erreur de syntaxe, garantissant que votre configuration Nginx est exacte et complète. Il est recommandé d'exécuter cette commande chaque fois que vous apportez des modifications au fichier de configuration ou avant de redémarrer Nginx pour éviter tout problème causé par des erreurs de syntaxe.

Remarque : Nous vous recommandons vivement d'exécuter cette commande de syntaxe pour rechercher d'éventuelles erreurs dans votre fichier de configuration Nginx et vous assurer qu'il ne manque rien.

Résumé

En résumé, des erreurs Nginx peuvent survenir lors de l'utilisation du serveur Web Nginx, entraînant des perturbations de votre site Web ou de votre application Web. Ces erreurs se présentent sous différentes formes, notamment l'erreur 502 Bad Gateway, l'erreur 404 Not Found, l'erreur 503 Service Unavailable, l'erreur 504 Gateway Timeout et les erreurs de redirection (301 et 302).

Pour résoudre efficacement les erreurs Nginx, il est important de comprendre leurs causes et de prendre les mesures appropriées. Les déclencheurs courants d'erreurs Nginx incluent les erreurs de fichier de configuration, les problèmes côté serveur, les problèmes de réseau ou les demandes des clients. Les solutions pratiques impliquent de diagnostiquer la cause première en vérifiant les journaux d'erreurs, en recherchant les erreurs de syntaxe ou en surveillant l'état actif de Nginx.

N'oubliez pas que bien que ces méthodes de dépannage puissent être utiles au départ, une enquête plus approfondie peut être nécessaire pour identifier la cause exacte du problème.

En suivant ces méthodes de dépannage et en mettant en œuvre les solutions appropriées, vous pouvez diagnostiquer et corriger efficacement les erreurs Nginx courantes, garantissant ainsi une expérience fluide aux visiteurs de votre site Web.

Questions fréquemment posées