Cómo solucionar error 500 en WordPress | Guía rápida

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, probablemente te has encontrado con la temida pantalla blanca o el mensaje "Error 500 Internal Server" en tu WordPress. No te preocupes, es uno de los errores más comunes y, aunque suene grave, casi siempre tiene solución. En esta guía extensa y paso a paso, vamos a desglosar qué es este error, por qué ocurre y, lo más importante, cómo solucionarlo desde cero, incluso si no eres un experto en sistemas.

Vamos a empezar con lo básico: el error 500 es un error genérico del servidor. Esto significa que algo salió mal en el servidor donde está alojada tu web, pero el sistema no puede decir exactamente qué. Es como cuando tu coche se para y el mecánico te dice "algo falla en el motor". Aquí vamos a ser ese mecánico, pero con pasos claros.

¿Qué causa el error 500 en WordPress?

Antes de lanzarnos a solucionarlo, es útil saber qué lo provoca. Las causas más frecuentes son:

Un plugin o tema defectuoso: Es la causa número uno. Una actualización fallida, un conflicto entre plugins, o un tema con código mal escrito.
Archivo .htaccess corrupto: Este archivo es como el "libro de instrucciones" de tu servidor. Si se daña, todo se vuelve loco.
Límite de memoria de PHP agotado: WordPress necesita una cantidad mínima de memoria para funcionar. Si tu web se ha vuelto pesada, puede que necesite más.
Permisos de archivos incorrectos: Los archivos de tu web tienen "permisos" que dicen quién puede leerlos, escribirlos o ejecutarlos. Si están mal configurados, el servidor se niega a trabajar.
Errores en el archivo wp-config.php: Este es el archivo de configuración principal de WordPress. Un error al editarlo puede causar un 500.
Problemas con el servidor web (Apache/Nginx): A veces el problema es más profundo y está en la configuración del servidor en sí. Aquí es donde entran en juego herramientas como Syspanel (el panel de control que antes se llamaba HestiaCP, y que usamos para gestionar el servidor).

Ahora sí, manos a la obra. Sigue estos pasos en orden. No los saltes, ya que cada uno es una posible solución.

Paso 1: La solución más rápida (y que siempre debes intentar primero)

Antes de tocar archivos o paneles, prueba esto:

Desactiva todos los plugins y cambia a un tema por defecto.

¿No puedes acceder a tu escritorio de WordPress? No pasa nada. Puedes hacerlo manualmente desde el servidor.

Accede a tu servidor: Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de control. Si usas Syspanel (recuerda, el puerto de acceso es el 2106), entra a tu dominio y busca la sección "Administrador de archivos" o usa un cliente FTP con los datos que te proporcionó tu hosting.
Navega a la carpeta de tu web: Normalmente es /public_html o public_html/tu-dominio.com.
Desactiva todos los plugins: Busca la carpeta wp-content y dentro de ella, la carpeta plugins. Cámbiale el nombre a plugins_old. Esto fuerza a WordPress a desactivar todos los plugins de golpe.
Cambia el tema: Dentro de wp-content, busca la carpeta themes. Si tienes varios temas, localiza el que estás usando (por ejemplo, tu-tema-activo). Cámbiale el nombre a tu-tema-activo_old. WordPress, al no encontrar el tema activo, usará uno por defecto (como Twenty Twenty-Four).

[INFO] Este paso es mágico. Si el error era por un plugin o tema, tu web volverá a funcionar. Luego, puedes ir renombrando carpetas una por una (por ejemplo, plugins_old a plugins) para identificar al culpable.

Paso 2: Revisa y restaura el archivo .htaccess

Si el paso anterior no funcionó, el archivo .htaccess (sí, empieza con un punto) es el siguiente sospechoso. Este archivo suele estar en la raíz de tu web (en public_html).

Conéctate por FTP o al administrador de archivos de Syspanel.
Localiza el archivo .htaccess. Puede que esté oculto. Si no lo ves, en FileZilla activa "Mostrar archivos ocultos" (Servidor > Forzar mostrar archivos ocultos). En Syspanel, suele haber una opción para ver archivos ocultos.
Descárgalo a tu ordenador como copia de seguridad. Por si acaso.
Elimínalo del servidor. No te preocupes, WordPress lo generará de nuevo automáticamente.
Vuelve a cargar tu web. Si funciona, genial. Si no, puedes restaurar el archivo original o crear uno nuevo desde WordPress (Ajustes > Enlaces permanentes > Guardar cambios).

[WARNING] No edites el .htaccess a menos que sepas exactamente lo que estás haciendo. Un error puede romper toda tu web.

Paso 3: Aumenta el límite de memoria de PHP

Si tu web tiene muchos plugins o un tema pesado, puede que necesite más memoria. Para ello, editaremos el archivo wp-config.php.

Localiza el archivo wp-config.php en la raíz de tu web (misma carpeta que el .htaccess).
Descárgalo y ábrelo con un editor de texto plano (como Notepad++ o Bloc de notas). Nunca uses Word o Pages.
Busca la línea que dice: define('WP_DEBUG', false); (o similar).
Justo antes de esa línea (o al final del archivo, antes de /* That's all, stop editing! */), añade esta línea:

define('WP_MEMORY_LIMIT', '256M');

También puedes añadir esta otra para aumentar aún más la memoria:

define('WP_MAX_MEMORY_LIMIT', '512M');
Guarda el archivo y súbelo de nuevo al servidor (sobrescribiendo el antiguo).

[TIP] Si no encuentras la línea de debug, puedes añadir las líneas justo después de la línea que dice <?php (al principio del todo).

Paso 4: Revisa los permisos de archivos y carpetas

Los permisos incorrectos pueden bloquear el acceso a archivos críticos. Los valores seguros son:

Carpetas: 755
Archivos: 644
Archivo wp-config.php: 600 (más seguro) o 644.

Puedes cambiar los permisos desde tu cliente FTP (clic derecho > Permisos de archivo) o desde el administrador de archivos de Syspanel.

[INFO] No necesitas cambiar todos los archivos uno por uno. En FileZilla, puedes seleccionar toda la carpeta public_html, clic derecho > "Permisos de archivo", marcar "Recursivo en subdirectorios" y elegir "Aplicar a todos los archivos y carpetas". Luego, establece 755 para carpetas y 644 para archivos. Es un proceso automático.

Paso 5: Activa el modo de depuración de WordPress

Para obtener más pistas sobre el error, podemos activar el modo debug. Esto mostrará mensajes de error detallados en lugar de la pantalla blanca.

Edita el archivo wp-config.php (como en el paso 3).
Busca la línea define('WP_DEBUG', false); y cámbiala a:

define('WP_DEBUG', true);

También añade estas líneas justo debajo para que los errores se guarden en un archivo:

define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Guarda el archivo y recarga tu web. Ahora, en lugar de un error 500 genérico, puede que veas un mensaje como "Fatal error: Call to undefined function..." que te indicará exactamente qué archivo está causando el problema.
Revisa el archivo de log: Se creará un archivo llamado debug.log dentro de la carpeta wp-content. Descárgalo y ábrelo para ver los errores detallados.

[WARNING] Una vez que hayas solucionado el error, vuelve a desactivar el modo debug (define('WP_DEBUG', false);), ya que dejarlo activo en un sitio en producción puede mostrar información sensible a los visitantes.

Paso 6: Soluciones más avanzadas (para SysAdmin)

Si nada de lo anterior funciona, el problema puede estar en el servidor mismo. Aquí es donde necesitas acceso de administrador del sistema (SysAdmin). No te asustes, son pasos lógicos.

6.1. Revisa los logs del servidor

Los logs del servidor web (Apache o Nginx) son el "diario de a bordo" de tu servidor. Contienen información detallada de cada error.

En Syspanel (puerto 2106): Ve a la sección "Logs" o "Registros". Busca los logs de errores de tu dominio. Normalmente se llaman error.log o tu-dominio-error.log.
Por SSH: Si tienes acceso por terminal, puedes usar comandos como tail -f /var/log/apache2/error.log (para Apache) o tail -f /var/log/nginx/error.log (para Nginx). Esto te mostrará los errores en tiempo real.

6.2. Revisa la configuración de PHP

Desde Syspanel, puedes ajustar la versión de PHP y sus parámetros. Ve a "Servidor Web" o "PHP" y busca la opción "Configuración de PHP". Aumenta valores como memory_limit, max_execution_time y upload_max_filesize.

6.3. Verifica el estado del servidor

Un error 500 también puede ocurrir si el servidor está sobrecargado. Desde Syspanel, revisa el uso de CPU, RAM y disco. Si ves que el servidor está al límite, puede que necesites optimizar tu web o contactar a tu proveedor de hosting.

Preguntas Frecuentes (FAQ)

P: ¿El error 500 puede deberse a un ataque?
R: Sí, aunque es menos común. Un ataque DDoS o un intento de hackeo pueden sobrecargar el servidor. Revisa los logs de seguridad en Syspanel.

P: ¿Qué hago si no tengo acceso a FTP ni a Syspanel?
R: Contacta a tu proveedor de hosting inmediatamente. Ellos tienen acceso de root y pueden revisar los logs del servidor por ti.

P: ¿Es seguro editar el wp-config.php?
R: Sí, siempre que uses un editor de texto plano y no elimines líneas importantes. Si tienes dudas, descarga una copia de seguridad antes de editarlo.

P: ¿Puedo evitar este error en el futuro?
R: Sí, siguiendo buenas prácticas:
- Mantén WordPress, temas y plugins actualizados.
- No instales plugins de fuentes desconocidas.
- Realiza copias de seguridad periódicas.
- Monitorea el uso de recursos desde Syspanel.

Resumen final

El error 500 en WordPress puede ser frustrante, pero como has visto, tiene solución. Empieza siempre por lo más simple (desactivar plugins/temas) y ve subiendo en complejidad. Recuerda que herramientas como Syspanel (accesible por el puerto 2106) te dan un control total sobre tu servidor para diagnosticar y solucionar problemas.

Si después de seguir todos estos pasos el error persiste, no dudes en contactar a tu equipo de soporte. A veces, el problema está en un nivel más profundo del servidor que solo un SysAdmin puede tocar.

¡Espero que esta guía te haya sido de gran ayuda! Si tienes más dudas, recuerda que estoy aquí para ti. ¡Buena suerte con tu WordPress!