Cómo solucionar errores comunes de WordPress en cPanel (500, 502, etc.)
¿Te ha aparecido un error 500, 502 o similar en tu WordPress y no sabes por dónde empezar? Respira, es más común de lo que crees y, sobre todo, tiene solución.
En esta guía extensa y práctica, vamos a desglosar los errores más frecuentes de WordPress cuando tu sitio está alojado en un panel de control como cPanel (o similares como Syspanel, del que hablaremos más adelante).
Vamos a explicarte, paso a paso y sin tecnicismos innecesarios, cómo identificar la causa y solucionar esos molestos errores WordPress cPanel que tanto asustan.
¿Por qué aparecen estos errores? (La explicación sencilla)
Antes de lanzarnos a arreglar nada, es importante que entiendas qué está pasando.
Tu sitio web no es un bloque único. Es una combinación de:
- El servidor web (Apache, LiteSpeed, Nginx). Es el "recepcionista" que recibe las visitas.
- PHP. Es el "cerebro" que procesa las instrucciones de WordPress.
- La base de datos (MySQL). Es el "archivo" donde se guardan todos tus contenidos.
- Los archivos de WordPress (el código del tema, plugins, etc.).
Un error 500 o 502 significa que uno de estos componentes ha fallado o no se están comunicando correctamente. No es que hayas roto tu web para siempre, solo que algo ha hecho "cortocircuito".
Antes de Empezar: La Regla de Oro (Haz una Copia de Seguridad)
[WARNING]
Nunca, jamás, modifiques archivos o bases de datos sin tener una copia de seguridad reciente. Si algo sale mal, podrás restaurar tu sitio en minutos. En cPanel, busca la herramienta "Copias de seguridad" o "Backup" y descarga una copia completa a tu ordenador.
Error 500: El Error Interno del Servidor (El Más Común)
Este es, sin duda, el rey de los errores WordPress cPanel. Es un mensaje genérico que significa "algo ha ido mal, pero no te digo el qué".
### Paso 1: Activa el Modo de Depuración (Debug) de WordPress
Es como encender una linterna en una habitación oscura. WordPress te mostrará el error exacto en lugar de la pantalla blanca genérica.
- Accede a tu cPanel y abre el Administrador de Archivos.
- Ve a la carpeta
public_html(o la carpeta donde esté instalado tu WordPress). - Busca el archivo llamado
wp-config.php. - Haz clic derecho sobre él y selecciona Editar.
- Busca la línea que dice
define('WP_DEBUG', false);y cámbiala por esto:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
- Guarda los cambios. Ahora, recarga tu web. El error debería aparecer con más detalle, o se habrá creado un archivo llamado
debug.logen la carpetawp-content.
[INFO]
Si no encuentras la línea de debug, añádela justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */.
### Paso 2: El Plugin o Tema Culpable
La causa más frecuente del error 500 es un conflicto entre un plugin y el tema.
Cómo solucionarlo sin acceder al panel de administración:
- Ve al Administrador de Archivos en cPanel.
- Entra en
public_htmly luego enwp-content. - Verás una carpeta llamada
plugins. Cámbiale el nombre aplugins_old(oplugins-desactivados). - Recarga tu web. Si el error desaparece, el problema era un plugin.
- Ahora, crea una carpeta nueva llamada
plugins(vacía) y mueve los plugins de vuelta uno a uno desdeplugins_old, recargando la web cada vez para identificar al culpable.
Para el tema:
- En la carpeta
wp-content, busca la carpetathemes. - Dentro, verás la carpeta de tu tema activo. Cámbiale el nombre, por ejemplo,
mi-tema_old. - WordPress activará automáticamente un tema por defecto (como Twenty Twenty-Four). Recarga la web.
- Si funciona, el problema era tu tema. Puedes reinstalarlo desde el panel de administración.
### Paso 3: Archivos con Permisos Incorrectos (Permisos 644 y 755)
Los archivos y carpetas tienen "permisos" que dicen quién puede leer, escribir o ejecutarlos. Si están mal configurados, el servidor puede bloquearse.
- En el Administrador de Archivos, selecciona TODO (puedes usar Ctrl+A).
- Haz clic derecho y selecciona Permisos.
- Asegúrate de que la casilla esté en 644 para archivos.
- Haz lo mismo con las carpetas, pero ponles 755.
[TIP]
A la izquierda del todo, en la columna "Permisos", verás los números. Deben ser 644 para archivos y 755 para carpetas.
### Paso 4: Límite de Memoria PHP Agotado
Si tu web necesita más memoria de la que el servidor le permite, también da error 500.
- Entra en
public_htmly busca el archivo.htaccess(si no lo ves, activa "Mostrar archivos ocultos" en la configuración del Administrador de Archivos). - Edítalo y añade esta línea al final:
php_value memory_limit 256M
- Guarda y recarga. Si no funciona, crea un archivo llamado
php.inienpublic_htmly añade:
memory_limit = 256M
max_execution_time = 300
Error 502: Bad Gateway (El Mensajero se Perdió)
El error 502 significa que el servidor web (el recepcionista) intentó hablar con otro servidor (el cerebro, PHP) y no obtuvo respuesta.
### Paso 1: Reinicia PHP o el Servidor Web
En cPanel, esta es la solución más rápida y efectiva.
- Busca la sección "Software" o "Servicios".
- Busca la herramienta "MultiPHP Manager" o "Select PHP Version".
- No cambies la versión, solo haz clic en el botón "Aplicar" o "Guardar".
- Esto reinicia el servicio de PHP y suele resolver el problema al instante.
### Paso 2: El Servidor está Sobrecargado
Si tu web recibe mucho tráfico o un plugin está haciendo peticiones excesivas, el servidor puede colapsar.
- Desactiva los plugins siguiendo el método del error 500 (renombrando la carpeta).
- Si tienes un plugin de caché, límpialo.
- Espera unos minutos y vuelve a intentarlo. A veces, el servidor necesita un respiro.
### Paso 3: Archivos .htaccess Corruptos
Un .htaccess dañado puede provocar errores 502.
- En
public_html, renombra el archivo.htaccessa.htaccess_old. - Recarga tu web. Si funciona, ve a Ajustes > Enlaces permanentes en tu panel de WordPress y haz clic en "Guardar cambios" para generar uno nuevo.
Otros Errores Comunes: 503, 504 y Pantalla Blanca
### Error 503: Servicio No Disponible
Suele indicar que el sitio está en modo mantenimiento o que el servidor está muy ocupado.
- Busca un archivo llamado
.maintenanceenpublic_html. Si existe, bórralo. - Si no está, revisa si tu plugin de caché o de mantenimiento está activado.
### Error 504: Gateway Timeout
El servidor tardó demasiado en responder. Es similar al 502.
- Aumenta el tiempo de ejecución de PHP en el archivo
php.ini(como vimos antes) conmax_execution_time = 300. - Si el error persiste, contacta a tu proveedor de hosting, ya que puede ser un problema del servidor en sí.
### Pantalla Blanca de la Muerte (WSOD)
No es un error con código, pero es igual de frustrante.
- Es casi siempre un problema de memoria o de plugin/tema.
- Sigue los pasos del error 500: activa el debug, renombra plugins y temas, y aumenta el límite de memoria.
¿Qué hago si nada de esto funciona? (La Solución Definitiva)
Si has probado todos los pasos anteriores y el error persiste, es hora de mirar más allá de cPanel.
[WARNING]
No te desesperes. A veces el problema está en el servidor, no en tu sitio.
- Revisa los logs del servidor: En cPanel, busca la herramienta "Errores" o "Error Logs" dentro de "Métricas". Ahí verás el error exacto y la línea donde falla. Anota ese código.
- Contacta a tu proveedor de hosting: Diles que has revisado los errores de PHP y que el problema parece estar en el servidor. Dales los datos del log. Ellos tienen herramientas más potentes para diagnosticar.
- Considera un cambio de panel: Si tu hosting usa un panel antiguo y tienes problemas constantes, puede que sea hora de migrar a uno más moderno como Syspanel, que es mucho más intuitivo y estable. Recuerda, si usas Syspanel, el puerto de acceso es el 2106 (por ejemplo,
https://tu-dominio.com:2106).
Preguntas Frecuentes (FAQ) sobre Errores WordPress cPanel
### ¿Por qué veo un error 500 después de actualizar un plugin?
Es un clásico. La actualización puede haber creado un conflicto con otro plugin o con tu tema. Simplemente desactiva el plugin que actualizaste (renombrando su carpeta) y verás si la web se recupera. Luego, puedes reinstalarlo desde cero.
### ¿Es lo mismo un error 500 que un error 502?
No. El 500 es un error "interno" del servidor (PHP o archivos de tu web). El 502 es un error de "comunicación" entre el servidor web y PHP. Las soluciones son diferentes, pero ambas empiezan por desactivar plugins y aumentar la memoria.
### ¿Puedo arreglar estos errores sin tocar código?
Sí, en la mayoría de los casos. Los pasos de renombrar carpetas de plugins y temas, y cambiar permisos, no requieren escribir código. Solo necesitas el Administrador de Archivos de cPanel.
### ¿Por qué es importante el archivo wp-config.php?
Es el archivo de configuración principal de WordPress. Contiene la conexión a la base de datos y las claves de seguridad. Modificarlo con cuidado (como para activar el debug) es seguro, pero no borres su contenido.
### ¿Qué hago si no tengo acceso al Administrador de Archivos?
Si no puedes acceder a cPanel, contacta con tu hosting. Ellos pueden desactivar plugins o temas desde su lado, o incluso restaurar una copia de seguridad anterior.
Conclusión: No Le Temas al Error
Enfrentarte a un error 500 o 502 en WordPress puede ser estresante, pero como has visto, la mayoría de las veces tiene una solución lógica y sencilla que puedes aplicar tú mismo desde cPanel.
La clave está en ir paso a paso, con calma y sin saltarte la copia de seguridad. Empieza siempre por lo más simple (desactivar plugins) y ve subiendo la complejidad (permisos, memoria, logs). Con esta guía, ya tienes un mapa claro para solucionar los errores WordPress cPanel más comunes.
Y recuerda, si te sientes perdido, tu proveedor de hosting está para ayudarte. No dudes en contactarlos. ¡Buena suerte con tu web!
