Error 500 en un sitio web: Cómo solucionarlo

Error 500 en un sitio web: Cómo solucionarlo — Guía paso a paso

¿Te preguntas cómo solucionar el error interno del servidor 500 en un sitio web? A menudo aparece no en un día tranquilo, sino justo cuando el tráfico aumenta, se lanza una campaña publicitaria o justo después de otra actualización. El error 500 significa un error interno del servidor: la página no devolvió una respuesta, pero el navegador tampoco obtuvo una razón exacta, solo una señal de fallo genérica. Es frustrante, pero se puede diagnosticar. Casi siempre.

La buena noticia es que un error 500 rara vez aparece de la nada. La mayoría de las veces es causado por código roto, un proceso PHP fallido, un archivo .htaccess dañado, plugins o un tema en conflicto, o un servidor que alcanza los límites de memoria y tiempo de ejecución. El host también puede ser el culpable. O el último commit.

Si el sitio ya genera leads o ventas, incluso 10 minutos de inactividad perjudican tanto los ingresos como la confianza. Por eso, el orden de las acciones importa más que la conjetura: primero aísla el problema, luego cambia la configuración. Sin caos.

1. Qué significa un error 500 y por qué aparece

El Error Interno del Servidor no es un diagnóstico, sino un término general para varios fallos. El servidor recibió la solicitud, intentó procesarla y se encontró con un problema que no pudo mostrar al usuario de manera adecuada. Exteriormente, todo se ve igual: una página en blanco, un mensaje de error, a veces una pantalla en blanco.

Hay 5 causas más comunes. La primera es un error de código PHP después de editar una plantilla o función. La segunda son reglas incorrectas en .htaccess. La tercera es un conflicto de plugin o tema. La cuarta es la falta de recursos: memory_limit, max_execution_time, tiempo de CPU. La quinta es un fallo del lado del servidor o del hosting. Y hay una sexta, muy ordinaria: los permisos de archivo están configurados incorrectamente.

En WordPress y plataformas CMS similares, esto es especialmente notable después de las actualizaciones. Un plugin se actualiza, otro no, la caché permanece antigua y el tema llama a una función que ya ha sido eliminada. El resultado es una cascada corta pero desagradable. El error 500 disfruta de ese tipo de combinación, por eso Solución de problemas del error 500 de WordPress a menudo comienza con actualizaciones, caché y verificaciones de compatibilidad.

Si el sitio está construido como una aplicación web, la cadena puede ser más larga: API, cola de tareas, base de datos, servicio de pago externo. En proyectos como ese, es útil pensar de antemano sobre seguridad del sitio web y la lógica de recuperación de copias de seguridad, porque un incidente sin registros de eventos convierte la solución de problemas en una conjetura.

2. Primero, verifica dónde ocurre exactamente el error

El primer paso es entender el alcance. ¿El error 500 está solo en una página? ¿O en todo el sitio? ¿O tal vez aparece en el área de administración mientras la parte pública aún se carga? Estos 3 casos apuntan a diferentes causas, y esa verificación de alcance es el más rápido solución de error 500 del sitio web punto de partida.

Si el error aparece solo en una página, busca código local: un shortcode, widget, formulario, plantilla personalizada o script incrustado. Si todo el sitio está caído, revisa .htaccess, PHP y límites del sistema. Si el área de administración no se abre, inspecciona los plugins y el tema. Después de una actualización, el problema a menudo se oculta allí.

Un error 500 también aparece a menudo después de mudarse a un nuevo host. Las configuraciones de PHP pueden diferir, los permisos de carpeta también pueden diferir, y las reglas de configuración antiguas no siempre se ajustan al nuevo entorno. Una migración. Una sorpresa.

Ayuda anotar cuándo todo se rompió: después de instalar un plugin, cambiar el tema, cambiar la versión de PHP o mover el sitio. Esa pequeña línea de tiempo ahorra horas. A veces, un día entero.

3. Cómo revisar .htaccess y plugins

.htaccess es un culpable común. Una directiva incorrecta es suficiente para que el servidor comience a devolver errores 500 en casi cada página. Especialmente si se editaron manualmente redirecciones, reglas de caché o enlaces permanentes bonitos.

La prueba más simple es renombrar temporalmente el archivo .htaccess, por ejemplo a .htaccess_old. Si el sitio vuelve a la vida, probablemente has encontrado la causa. Luego crea un nuevo archivo y vuelve a guardar la configuración de enlaces permanentes en el panel de administración del CMS. En WordPress, esto se hace a través de la sección de Enlaces Permanentes, sin copiar manualmente las reglas.

Si el error desaparece después de recrear las reglas, es mejor no volver a traer el archivo antiguo. Puede que aún contenga una línea extra, por ejemplo de un antiguo plugin que ya ha sido eliminado. Una directiva extra puede derribar todo el sitio. No solo en teoría.

Cuando un sitio utiliza una estructura de redirección compleja, especialmente después de un rediseño, vale la pena verificar de antemano cómo se comportan las URLs antiguas y los enlaces canónicos. Para proyectos con un refresco estructural, puede ayudar leer sobre cómo elegir un estudio web para un rediseño de sitio web, para que no termines con confusiones en las reglas del servidor y las rutas internas.

4. Desactiva los plugins y verifica el tema

Si .htaccess está limpio, pasa a los plugins. En WordPress, esto es rápido: renombra la carpeta de plugins a través del administrador de archivos o FTP. Todos los plugins se desactivarán de una vez. Si el error 500 desaparece, la causa es uno de ellos.

Luego activa los plugins uno por uno. Verifica el sitio después de cada activación. Así es como encuentras el módulo en conflicto, incluso si hay 17 de ellos. ¿Tedioso? Sí. ¿Funciona? También sí.

Los infractores típicos son los plugins de caché, seguridad, SEO, constructores de páginas y cualquier extensión que interfiera con el enrutamiento o la generación de contenido. A veces, el problema no es el plugin en sí, sino una versión desactualizada del mismo. Eso tiende a salir a la luz especialmente después de una actualización.

Haz lo mismo con el tema: cambia temporalmente al tema predeterminado del CMS. Si el área de administración no está disponible, renombra la carpeta del tema activo a través de FTP para que el sistema vuelva a una opción de respaldo. Si el error 500 desaparece, el tema contiene una plantilla rota, un gancho incompatible o una llamada a una función antigua.

Cuando el sitio está vinculado a servicios externos, como pagos, el código de integración a veces puede desencadenar el error. En tales casos, ayuda evaluar el flujo de pagos y actualizar los riesgos por adelantado. Por ejemplo, echa un vistazo a cuánto cuesta conectar Stripe a un sitio web si tienes una lógica de integración y redirección similar.

5. Verifica errores de PHP y límites del servidor

Si los plugins y el tema no son el problema, revisa los registros. Los registros de errores de PHP generalmente muestran qué archivo, línea o función falló. A veces lo dicen directamente: Tamaño de memoria permitido agotado. A veces: error fatal. A veces: nada en absoluto, lo cual es peor.

Los registros pueden estar en el panel de control de hosting, en una carpeta separada del sitio o en los informes del sistema del servidor. Diferentes proveedores los almacenan en diferentes lugares, por lo que el panel de hosting suele ser necesario aquí. Revisa al menos 2 lugares: el registro de errores del sitio y el registro del sistema de la cuenta.

Ahora a la configuración de PHP. Busca memory_limit, max_execution_time, upload_max_filesize, post_max_size, y la versión de PHP. Si el sitio comenzó a fallar después de una actualización de versión de PHP, volver a una versión compatible a menudo lo soluciona. Si la memoria es demasiado baja, una página pesada, importación o plugin simplemente no tiene suficiente tiempo para terminar.

El memory_limit la configuración es especialmente importante para tiendas y catálogos grandes. Una exportación de producto puede utilizar toda la capacidad de recursos. Un formulario de importación también puede hacerlo. Si el sitio utiliza análisis, colas, tareas en segundo plano y monitoreo, vale la pena tener un plataforma de análisis y monitoreo de sitios · como parte de tu pila de observación, para que puedas ver las interrupciones desde los registros en lugar de una queja de un cliente.

Si no estás seguro de dónde verificar la configuración, pide a tu proveedor que muestre la configuración actual de PHP y los límites del servidor. Verifica no solo la versión de PHP, sino también el límite de memoria real, el tiempo de ejecución y el tamaño de carga. Es sorprendente cuán a menudo el problema es solo un valor.

6. Limpia la caché y revisa los cambios recientes

La caché puede ocultar tanto el problema como el hecho de que ha desaparecido. Así que después de hacer cambios, borra la caché del sitio, la caché del navegador y la caché de CDN si usas una. De lo contrario, estarás viendo una versión antigua del error y pensando que nada ha cambiado.

Primero borra la caché en el panel de CMS o en el plugin de caché. Luego borra la caché del navegador, preferiblemente en modo incógnito. Si el sitio se sirve a través de un CDN, purga eso también. Tres lugares, tres cachés, un resultado: solo después de una limpieza completa puedes confiar en la prueba.

A continuación, revisa los últimos cambios. ¿Agregaste un nuevo bloque? ¿Cambiaron una función en la plantilla? ¿Subiste un archivo nuevo a la biblioteca? Revierte el último cambio y prueba de nuevo. Un error 500 a menudo aparece después de una pequeña línea de código, no después de una “actualización importante.”

En proyectos con soporte continuo, estos problemas son generalmente menos comunes porque los cambios en el código y la configuración pasan por control. Si su sitio está activo y se mejora regularmente, el artículo sobre soporte del sitio web después del lanzamiento puede ayudarle a ver cómo no dejar que la caché y las actualizaciones se conviertan en un estado de caída.

También verifique si el CDN se rompió después de cambios en SSL, redirecciones o una actualización de política de seguridad. Un encabezado de respuesta incorrecto puede desencadenar un error 500 solo para parte de sus usuarios. Y eso es mucho más difícil de detectar.

7. Qué hacer si el error 500 no desaparece

Si el sitio sigue fallando después de todas las verificaciones, es hora de trabajar sistemáticamente. Comience contactando al soporte de hosting y solicite registros para el momento exacto de la falla. Indique la hora, la fecha y la página donde ocurrió el error 500. Sin eso, el soporte tardará más en encontrarlo.

Luego verifique los permisos de archivos y carpetas. Las personas a menudo configuran carpetas a 777 “temporalmente” y luego se olvidan de cambiarlas de nuevo. Esa es una mala práctica, y no solo por el error 500: el servidor puede bloquear tales permisos por razones de seguridad. Los archivos y directorios deben tener permisos correctos.

Si tienes una copia de seguridad reciente, restaura la versión funcional del sitio y verifica si el fallo desaparece. Esto es especialmente útil después de una mala actualización del núcleo, plugin o migración del servidor. Un retroceso ahorra más tiempo que intentar arreglar manualmente 12 cambios incompatibles.

Cuando el sitio es importante para el negocio, no retrases la recuperación. A veces es más barato restaurar la copia de ayer que pasar medio día buscando una línea de código. Y si el proyecto depende de solicitudes externas, formularios y APIs, verifica también el lado de la red: a veces el problema no está en el CMS, sino en la infraestructura. Para casos como ese, un infraestructura de red privada puede ayudar cuando parte de la complejidad se traslada a un entorno controlado.

El último paso práctico es cambiar temporalmente el sitio a una configuración mínima. Mantén solo el núcleo, un tema, un plugin funcional y las reglas básicas. Si el error 500 desaparece en ese modo, agrega los componentes de uno en uno. De esa manera encontrarás el elemento problemático sin conjeturas innecesarias. Es lento, pero honesto.