Cómo corregir los mensajes de error comunes de Nginx: una guía paso a paso

¿Qué es el error NGINX?

Un error de Nginx se refiere a un problema o falla que ocurre al usar el servidor web de Nginx. Nginx es el servidor web ampliamente utilizado, en el que se confía la mayoría de los sitios web. Sin embargo, como cualquier software, puede encontrar errores que pueden interrumpir el buen funcionamiento de su sitio web.

Por ejemplo, piense en ello como un bache en el camino que puede interrumpir el funcionamiento normal de su sitio web o cualquier aplicación web. Nginx, al ser un sistema de software muy complejo, a veces puede tener problemas causados ​​por varios factores. Como configuraciones incorrectas, problemas que ocurren en el lado del servidor, problemas de red o incluso errores cometidos por el cliente.

Los errores de Nginx pueden manifestarse de varias formas, algunas de las cuales quizás ya conozca. Por ejemplo, estos incluyen el 502 Bad Gateway Error nginx, 404 Error no encontrado, 503 Servicio no disponible Error, 504 Gateway Timeout Error, así como errores de redirección (301 y 302).

Para garantizar una experiencia perfecta para los visitantes de su sitio web, es esencial manejar los errores de nginx de manera efectiva. Nginx, el servidor web, encuentra errores de vez en cuando y los comunica mediante códigos de error específicos. Al comprender estos códigos, puede identificar fácilmente la naturaleza del problema y solucionarlo en consecuencia.

En esta guía completa, profundizaremos en los errores comunes de Nginx, exploraremos sus causas y brindaremos soluciones prácticas para ayudarlo a solucionar y resolver estos problemas de manera efectiva.

Algunos tipos comunes de errores de Nginx

Los errores de Nginx pueden provenir de varias fuentes, incluidas configuraciones incorrectas, problemas del lado del servidor, problemas de red o solicitudes de clientes. Echemos un vistazo a algunos tipos comunes de errores de Nginx que puede encontrar:

Soluciones y mensajes de error comunes de Nginx:

1. 502 Error de puerta de enlace incorrecta:

• Causas: este error suele ocurrir cuando Nginx actúa como un proxy y no recibe una respuesta válida de un servidor ascendente.
• Soluciones: para resolver esto, verifique la configuración del servidor ascendente, verifique la conectividad de la red y asegúrese de que el servidor esté operativo.

Leer: ¿Cómo reparar el error 502 Bad Gateway NGINX? (7 Métodos)

2. Error 404 no encontrado:

Cuando visita un sitio web configurado con Nginx, se conectó con éxito al servidor del sitio web, pero no pudo encontrar los recursos solicitados, como cualquier nombre de archivo o URL. Y este tipo de mensaje de error generalmente se activa debido a problemas con el archivo de configuración.

• Causas: este error indica que el recurso solicitado no se encuentra en el servidor.
• Soluciones: para abordar esto, verifique la existencia del archivo o directorio nginx.conf, revise la configuración de la URL y verifique si hay problemas de distinción entre mayúsculas y minúsculas.

Leer: ¿Cómo reparar el error 404 no encontrado para el sitio de WordPress y Android?

3. 503 Error de servicio no disponible:

• Causas: este error ocurre cuando el servidor no puede manejar solicitudes temporalmente.
• Soluciones: para abordar este problema, verifique la carga del servidor, reinicie Nginx, analice el estado de los servidores backend o implemente mecanismos de almacenamiento en caché adecuados.

Leer: ¿Cómo solucionar el "Servicio HTTP Error 503 no disponible"?

4. Error de tiempo de espera de puerta de enlace 504 (continuación):

• Causas: este error generalmente ocurre cuando el servidor ascendente no responde dentro de un límite de tiempo especificado.
• Soluciones: para resolver esto, verifique la configuración del servidor ascendente, asegúrese de que la conectividad de la red sea adecuada y ajuste la configuración de tiempo de espera en Nginx para permitir tiempos de respuesta más largos si es necesario.

Leer: ¿Cómo reparar el error de tiempo de espera de la puerta de enlace HTTP 504?

5. Problemas de redireccionamiento 301 y 302:

• Causas: estos errores ocurren cuando hay problemas con la redirección de URL, como configuraciones incorrectas o bucles en el proceso de redirección.
• Soluciones:

• Verifique la configuración de Nginx: verifique los archivos de configuración de Nginx para asegurarse de que las reglas de redirección estén definidas correctamente. Por lo general, el archivo de configuración se encuentra en /etc/nginx/nginx.conf o en un archivo separado dentro del directorio /etc/nginx/conf.d/ .
• Verifique la configuración del bloque del servidor: dentro del archivo de configuración, ubique el bloque del servidor que corresponde al dominio o host virtual afectado. Asegúrese de que la directiva server_name apropiada esté establecida en el nombre de dominio correcto.
• Revise las reglas de redirección: Examine los bloques location o los bloques server que definen las reglas de redirección. Asegúrese de que las directivas rewrite o return estén configuradas correctamente para redirigir las solicitudes a la ubicación deseada. Preste atención a las expresiones regulares y las URL de destino.
• Reinicie Nginx : después de realizar cualquier cambio en los archivos de configuración, debe reiniciar el servicio Nginx para aplicar los cambios. Use el siguiente comando para reiniciar Nginx:

sudo service nginx restart

• Borrar caché del navegador : A veces, los navegadores almacenan en caché las respuestas de redirección. Borre la memoria caché de su navegador o intente acceder al sitio web en una ventana privada o de incógnito para asegurarse de que la memoria caché no interfiere con la redirección.
• Pruebe la redirección : abra un navegador web e intente acceder a la URL que debería activar la redirección. Verifique que la redirección funcione como se esperaba y que se alcance el destino deseado.
• Verifique los registros en busca de errores: si la redirección aún no funciona, revise los registros de errores de Nginx ( /var/log/nginx/error.log ) para ver si hay mensajes de error relevantes. Los registros pueden proporcionar información valiosa para identificar la causa del problema.

Al seguir estos pasos, debería poder diagnosticar y solucionar problemas comunes de redirección en Nginx.

¿Cómo soluciono un error de NGINX?

Ahora que ha visto algunos de los errores comunes de NGINX, es posible que tenga una pregunta en mente: "¿Cómo soluciono un error de NGINX?"

Bueno, la respuesta no es tan difícil como parece. Hay varios métodos de solución de problemas disponibles para los errores de NGINX. Sin embargo, es importante tener en cuenta que estos métodos de solución de problemas son solo para la fase inicial. Se requiere más investigación para determinar la causa exacta del problema.

Básicamente, hay tres comandos que pueden ayudarlo a comenzar su viaje de solución de problemas para los errores de NGINX.

• Obtenga el registro de errores y los detalles del problema con este comando: sudo cat /var/log/nginx/error.log
• Para verificar el estado activo de Nginx: sudo systemctl status nginx
• Para verificar errores de sintaxis en el archivo de configuración: sudo nginx -t

1. Solución de problemas de errores de Nginx con registros de errores

Cuando encuentra un problema con NGINX, la mayoría de estos errores de NGINX son vagos y no es fácil simplemente descubrir el problema real. El error puede desencadenarse debido a un problema mayor o puede no estar relacionado en absoluto.

Todo esto depende de cómo haya configurado su configuración de NGINX y la situación específica a la que se enfrenta.

Para comprender mejor los errores de NGINX que se están produciendo, puede ejecutar un comando para ver una lista de estos errores. Aquí está el comando:

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

Para ejecutar este comando, deberá ser un usuario privilegiado. Se recomienda tener acceso sudo en lugar de usar el usuario root.

Este comando le permite leer todo el contenido del archivo /var/log/nginx/error.log, que contiene los registros de errores de NGINX. Mostrará estos registros en la ventana de su terminal.

Al ejecutar este comando, podrá ver una lista de los errores de NGINX que se han registrado. Recuerde una cosa si no hay errores registrados en el registro, no verá ningún resultado cuando ejecute el comando.

Aquí hay un ejemplo de un registro de errores para su referencia,

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"

En este ejemplo, cada línea representa un error separado registrado por NGINX. Desglosemos la información proporcionada:

• Marca de tiempo: la primera parte de cada línea muestra la fecha y la hora en que ocurrió el error, con el formato YYYY/MM/DD HH:MM:SS .
• Nivel de error: la etiqueta [error] indica que esta línea representa un error.
• ID de proceso: el número después del símbolo # (p. ej., 1234#0 ) representa el ID de proceso de NGINX que maneja la solicitud.
• Mensaje de error: el mensaje de error proporciona detalles sobre el error específico. Incluye información como fallas de acceso a archivos o recursos, tiempos de espera de conexión ascendentes o problemas de redirección interna.
• IP del cliente: el campo client muestra la dirección IP del cliente que realiza la solicitud al servidor.
• Nombre del servidor: el campo server indica el nombre del servidor o host virtual donde ocurrió el error.
• Detalles de la solicitud: el campo request muestra el método HTTP, la URL solicitada y la versión del protocolo utilizada por el cliente.
• Host: el campo host especifica el nombre de host o la dirección IP utilizada en la solicitud.

Cada entrada del registro de errores ayuda a diagnosticar y solucionar problemas al proporcionar información sobre el tipo de error, el recurso afectado, la IP del cliente y otros detalles relevantes.

2. Solución de problemas de NGINX al verificar su estado

Otro método que puede intentar para solucionar problemas de NGINX es verificar su estado, es decir, si está activo o no. Existe la posibilidad de que, por determinadas razones, el proceso de instalación no se haya podido completar o el servicio aún no esté activo.

Para verificar el estado del servicio NGINX, use el siguiente comando:

sudo systemctl status nginx

Si el servicio NGINX está activo, la salida será como;

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

y si el estado de NGINX está inactivo, la salida del comando sudo systemctl status nginx indicará que el servicio está inactivo o detenido de la siguiente manera.

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 es el caso, lo único que debe hacer es reiniciar su servicio NGINX usando este comando:

sudo systemctl restart nginx

Después de eso, puede usar el comando de estado nuevamente para verificar si el servicio NGINX ahora está activo o no.

3. Solución de problemas de NGINX al verificar el error de sintaxis

Los errores de sintaxis son un problema común que puede surgir al escribir scripts, códigos o configurar archivos Nginx.

Ya sea que haya utilizado una estructura de sintaxis incorrecta u omitido ciertos caracteres, una sintaxis incorrecta evitará que el código o la configuración funcionen correctamente.

En el caso de los archivos de configuración de Nginx, comprenden varias directivas, cada una de las cuales debe declararse con precisión para su correcto funcionamiento. De lo contrario, no funcionará según lo previsto.

Para verificar cualquier error de sintaxis en su archivo de configuración de Nginx, use el siguiente comando.

sudo nginx -t

Si la sintaxis resultó ser correcta, la salida será,

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

Sin embargo, si hay un problema en la sintaxis, la salida se mostrará como,

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

Al realizar esta verificación, puede identificar y corregir cualquier error de sintaxis, lo que garantiza que su configuración de Nginx sea precisa y completa. Es una buena práctica ejecutar este comando cada vez que realice cambios en el archivo de configuración o antes de reiniciar Nginx para evitar problemas causados ​​por errores de sintaxis.

Nota: Recomendamos encarecidamente ejecutar este comando de sintaxis para verificar si hay errores en su archivo de configuración de Nginx y asegurarse de que no falte nada.

Resumen

En resumen, pueden ocurrir errores de Nginx al usar el servidor web de Nginx, lo que provoca interrupciones en su sitio web o aplicación web. Estos errores vienen en varias formas, incluido el error de puerta de enlace incorrecta 502, el error 404 no encontrado, el error de servicio no disponible 503, el error de tiempo de espera de puerta de enlace 504 y los errores de redirección (301 y 302).

Para solucionar los errores de Nginx de manera efectiva, es importante comprender sus causas y tomar las medidas adecuadas. Los desencadenantes comunes de los errores de Nginx incluyen errores en el archivo de configuración, problemas del lado del servidor, problemas de red o solicitudes de clientes. Las soluciones prácticas implican diagnosticar la causa raíz al verificar los registros de errores, buscar errores de sintaxis o monitorear el estado activo de Nginx.

Recuerde, si bien estos métodos de solución de problemas pueden ser útiles inicialmente, es posible que sea necesaria una mayor investigación para identificar la causa exacta del problema.

Al seguir estos métodos de solución de problemas e implementar las soluciones adecuadas, puede diagnosticar y corregir de manera efectiva los errores comunes de Nginx, lo que garantiza una experiencia fluida para los visitantes de su sitio web.

Preguntas frecuentes