Solución de errores 500 en WordPress: guía para cPanel
¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con el temido error 500 en WordPress. No te preocupes, es uno de los problemas más comunes y, con esta guía paso a paso para cPanel, lo solucionarás en pocos minutos. Vamos a ello.
¿Qué es un error 500 en WordPress?
El error 500, también conocido como error interno del servidor, es un mensaje genérico que indica que algo salió mal en el servidor, pero no especifica qué. En WordPress, suele aparecer como una pantalla en blanco o un mensaje como "Error interno del servidor". No te asustes: casi siempre tiene solución y, con las herramientas de cPanel, puedes diagnosticarlo y repararlo fácilmente.
Causas más comunes del error 500 en WordPress
Antes de lanzarnos a solucionarlo, es útil saber qué lo provoca. Las causas más frecuentes son:
- Archivo .htaccess corrupto o con reglas incorrectas.
- Plugin o tema defectuoso que genera un conflicto.
- Límite de memoria de PHP agotado (memory limit).
- Archivos del núcleo de WordPress dañados (por ejemplo, wp-config.php o archivos del sistema).
- Permisos de archivos incorrectos en el servidor.
- Problemas con la versión de PHP (por ejemplo, incompatible con tu WordPress o plugins).
Requisitos previos: Acceso a cPanel
Para seguir esta guía, necesitas acceso a cPanel. Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106 (por ejemplo: tudominio.com:2106). Una vez dentro, busca las secciones de "Archivos", "Base de Datos" y "Software" que mencionaremos.
[INFO] Si no tienes acceso a cPanel, contacta con tu proveedor de hosting. La mayoría de los planes básicos lo incluyen.
Paso 1: Hacer una copia de seguridad (por si acaso)
Antes de tocar nada, siempre haz una copia de seguridad. En cPanel, usa la herramienta "Backup" o "Copias de seguridad" para descargar los archivos y la base de datos. Si algo sale mal, podrás restaurar todo.
Paso 2: Activar el modo de depuración de WordPress (Debug)
WordPress tiene un modo oculto que muestra los errores reales. Esto te dará pistas claras sobre qué está fallando.
- Conéctate a cPanel y abre el Administrador de Archivos (File Manager).
- Ve a la carpeta raíz de tu sitio (normalmente
public_htmlopublic_html/tudominio). - Busca el archivo wp-config.php. Si no lo ves, asegúrate de que estén visibles los archivos ocultos (hay un botón "Mostrar archivos ocultos" en la parte superior).
- Haz clic derecho sobre
wp-config.phpy selecciona Editar. - Busca la línea que dice
define('WP_DEBUG', false);(si no existe, puedes añadirla antes de la línea/* That's all, stop editing! Happy publishing. */). - Cámbiala por:
define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); - Guarda el archivo.
Ahora, recarga tu sitio. Si el error 500 persiste, revisa la carpeta wp-content y busca un archivo llamado debug.log. Ábrelo: ahí verás los errores detallados. Por ejemplo, puede decir "Fatal error: Allowed memory size of 64 bytes exhausted" o "Parse error: syntax error, unexpected...".
[TIP] Si no ves el archivo debug.log, espera unos segundos y recarga la página de nuevo. A veces tarda en generarse.
Paso 3: Solucionar el error 500 desactivando plugins y temas
Si el debug.log apunta a un plugin o tema, o si no ves nada claro, el siguiente paso es desactivar todo.
3.1 Desactivar plugins manualmente desde cPanel
- En el Administrador de Archivos, ve a
wp-content/plugins. - Verás una lista de carpetas (cada una es un plugin). Cambia el nombre de la carpeta del plugin sospechoso añadiendo
-oldal final (por ejemplo,mi-plugin-old). Esto lo desactiva. - Si no sabes cuál es el problema, desactiva todos los plugins: renombra la carpeta
pluginsaplugins-old. - Crea una nueva carpeta vacía llamada
plugins. Esto deja WordPress sin plugins. - Recarga tu sitio. Si el error desaparece, el problema era un plugin. Ve activándolos uno por uno (desde el panel de WordPress, después de restaurar la carpeta original) para identificar al culpable.
3.2 Desactivar el tema actual
- En
wp-content/themes, busca la carpeta de tu tema activo (el que estás usando). - Cambia su nombre, por ejemplo,
mi-tema-old. - WordPress usará automáticamente un tema por defecto (Twenty Twenty-Four o similar). Recarga el sitio.
- Si el error se soluciona, el tema era el problema. Puedes reinstalarlo o contactar al desarrollador.
Paso 4: Restaurar el archivo .htaccess
El archivo .htaccess es un archivo de configuración oculto que controla las reglas de reescritura (permalinks) y seguridad. Si está dañado, causa el error 500.
- En el Administrador de Archivos, asegúrate de ver archivos ocultos.
- Busca el archivo
.htaccessen la raíz de tu sitio. - Haz clic derecho y Renombrar a
.htaccess-old. - Luego, ve al panel de WordPress (si puedes acceder) o crea uno nuevo desde cPanel:
- Ve a Ajustes > Enlaces permanentes en WordPress y haz clic en "Guardar cambios". Esto genera un
.htaccessnuevo.
- Ve a Ajustes > Enlaces permanentes en WordPress y haz clic en "Guardar cambios". Esto genera un
- Si no puedes acceder a WordPress, crea un archivo vacío llamado
.htaccessy pégalo:# BEGIN WordPress <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^index\.php$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.php [L] </IfModule> # END WordPress - Guarda y recarga el sitio.
Paso 5: Aumentar el límite de memoria de PHP
El error 500 puede deberse a que WordPress se queda sin memoria. Para solucionarlo:
- Abre el archivo
wp-config.phpdesde el Administrador de Archivos. - Añade esta línea justo antes de
/* That's all, stop editing! */:define('WP_MEMORY_LIMIT', '256M'); - Guarda el archivo y recarga el sitio.
Si no funciona, también puedes hacerlo desde cPanel:
- Busca la sección Seleccionar versión de PHP (o "MultiPHP Manager").
- Haz clic en Opciones o Switch to PHP Options.
- Busca
memory_limity cámbialo a256Mo512M. Guarda.
Paso 6: Verificar permisos de archivos
Los permisos incorrectos (por ejemplo, archivos con permisos 777) pueden causar errores.
- En el Administrador de Archivos, selecciona todos los archivos de la raíz (Ctrl+A).
- Haz clic derecho y elige Cambiar permisos.
- Aplica:
- Carpetas: 755
- Archivos: 644
- wp-config.php: 600 (por seguridad)
- Marca la opción "Recursivo" para que se aplique a subcarpetas.
- Haz clic en "Cambiar permisos".
Paso 7: Reinstalar el núcleo de WordPress
A veces, los archivos del sistema se corrompen. En cPanel, busca la herramienta Instalador de WordPress (Softaculous o similar). Normalmente tiene una opción "Reinstalar" que solo sobrescribe los archivos del núcleo sin tocar tus plugins, temas o contenido.
[WARNING] No uses "Reinstalar" si tienes modificaciones en los archivos del núcleo (como cambios en wp-admin). Si lo haces, perderás esas personalizaciones.
Paso 8: Verificar la versión de PHP
WordPress requiere PHP 7.4 o superior (recomendado 8.0+). Si tu hosting usa una versión antigua, puede dar error.
- En cPanel, busca Seleccionar versión de PHP o MultiPHP Manager.
- Elige la versión más reciente (por ejemplo, 8.1 o 8.2).
- Guarda y recarga el sitio.
Paso 9: Contactar al soporte del hosting
Si después de todos estos pasos el error 500 persiste, el problema puede estar en el servidor (por ejemplo, configuración de Apache, Nginx o límites de recursos). En ese caso:
- Abre un ticket de soporte con tu proveedor.
- Proporciona el contenido del archivo
debug.log(si lo tienes) y los pasos que ya intentaste.
[INFO] Si usas Syspanel (puerto 2106), el soporte técnico suele ser muy rápido. No dudes en pedir ayuda.
Preguntas frecuentes (FAQ)
¿El error 500 puede dañar mi base de datos?
No directamente. El error 500 es un problema del servidor o de los archivos. La base de datos suele estar intacta, pero si el error persiste, haz un backup por precaución.
¿Por qué aparece el error 500 después de actualizar un plugin?
Es muy común. Los plugins mal codificados o incompatibles con la versión de PHP pueden romper el sitio. Sigue el Paso 3 para desactivarlos.
¿El modo debug afecta el rendimiento?
Sí, pero solo mientras está activo. Una vez que soluciones el error, desactívalo (vuelve a poner define('WP_DEBUG', false); en wp-config.php) para que tu sitio no muestre mensajes de error a los visitantes.
¿Puedo solucionar el error 500 sin cPanel?
Si tu hosting no tiene cPanel, puedes usar FTP (FileZilla) para acceder a los archivos y realizar los mismos pasos. Necesitarás las credenciales FTP que te dio tu proveedor.
¿El error 500 es lo mismo que el error 503?
No. El error 503 significa "Servicio no disponible" (mantenimiento o sobrecarga), mientras que el 500 es un error interno del servidor. Ambos pueden tener causas similares, pero el 503 suele resolverse esperando o contactando al hosting.
Resumen rápido
Si estás apurado, aquí tienes los pasos clave:
- Activa el debug en
wp-config.phppara ver el error real. - Desactiva todos los plugins renombrando la carpeta
plugins. - Cambia el nombre del tema activo.
- Renombra .htaccess a .htaccess-old y crea uno nuevo.
- Aumenta la memoria PHP a 256M.
- Revisa permisos (755 carpetas, 644 archivos).
- Reinstala WordPress desde cPanel.
- Actualiza la versión de PHP a 8.0+.
Y recuerda: si usas Syspanel (antes HestiaCP), accede por el puerto 2106. Todo lo demás funciona igual.
Espero que esta guía te haya sido de ayuda. Si tienes más dudas, ¡escríbeme! Estoy aquí para ayudarte a que tu sitio funcione sin problemas.
