Errores comunes de WordPress en cPanel y cómo solucionarlos

¡Hola! Soy el técnico de soporte. Si estás leyendo esto, probablemente estés gestionando tu sitio web con WordPress alojado en un servidor con cPanel, y te hayas topado con algún error que te está volviendo loco. No te preocupes, es más común de lo que crees. En esta guía extensa y detallada, vamos a recorrer los errores más frecuentes que aparecen al usar WordPress en cPanel, y te daré soluciones paso a paso, explicadas como si estuviéramos tomando un café. Mi objetivo es que puedas resolverlo tú mismo sin necesidad de llamar a un experto (aunque si el problema persiste, siempre estoy aquí para ayudarte).

Vamos a empezar con lo básico: cPanel es el panel de control que te da acceso a los archivos de tu web, bases de datos, correos y más. WordPress es el gestor de contenidos que hace que tu web sea bonita y funcional. Cuando algo falla, suele ser por un conflicto entre ellos, un error de configuración o un recurso del servidor agotado. Vamos a desglosar los problemas más habituales y cómo solucionarlos.

Error 500: Error Interno del Servidor

Este es el rey de los errores. Aparece de repente y te deja con una pantalla en blanco o un mensaje genérico. No te asustes, casi siempre tiene solución.

¿Qué lo causa?

Un plugin o tema defectuoso.
Un archivo .htaccess corrupto.
Límite de memoria de PHP agotado.
Permisos de archivos incorrectos.

Solución paso a paso

Paso 1: Desactiva todos los plugins
Accede a tu cPanel. Busca la sección "Administrador de Archivos" (normalmente en "Archivos"). Navega a public_html/wp-content/plugins. Verás una lista de carpetas, una por cada plugin. Renombra la carpeta de un plugin (por ejemplo, de akismet a akismet_desactivado). Si el error desaparece, ese plugin era el culpable. Si no, repite con todos hasta encontrar el malo. Si quieres desactivarlos todos de golpe, renombra la carpeta plugins a plugins_old. WordPress creará una nueva carpeta plugins vacía y tu web volverá a funcionar (sin plugins, claro).

[WARNING] Al renombrar la carpeta plugins perderás las configuraciones de los plugins que no estén almacenadas en la base de datos. Es un método drástico pero efectivo.

Paso 2: Restaura el archivo .htaccess
En el Administrador de Archivos, busca el archivo .htaccess en public_html. Si no lo ves, activa la opción "Mostrar archivos ocultos" (un botón en la parte superior). Renómbralo a .htaccess_old. Luego, ve a "Ajustes" > "Enlaces permanentes" en tu panel de WordPress (si puedes acceder) y haz clic en "Guardar cambios". Esto generará un nuevo .htaccess. Si no puedes acceder a WordPress, crea un archivo nuevo en blanco llamado .htaccess y 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

Paso 3: Aumenta el límite de memoria PHP
Desde cPanel, busca "Seleccionar versión de PHP" (o "MultiPHP Manager"). Dentro, haz clic en "Opciones" o "Switch to PHP Options". Busca memory_limit y cámbialo a 256M o 512M. Guarda.

Paso 4: Revisa los permisos de archivos
En el Administrador de Archivos, selecciona toda la carpeta public_html, haz clic derecho y elige "Cambiar permisos". Asegúrate de que las carpetas tengan permisos 755 y los archivos 644. Marca "Recursivo" y aplica.

Error de Conexión a la Base de Datos

Este error es frustrante porque tu web se vuelve completamente inaccesible. El mensaje típico es "Error establishing a database connection".

Causas comunes

Credenciales incorrectas en wp-config.php.
Base de datos corrupta o caída.
Usuario de base de datos sin permisos.

Solución

Paso 1: Verifica las credenciales en wp-config.php
Desde el Administrador de Archivos, abre public_html/wp-config.php. Busca estas líneas:

define('DB_NAME', 'tu_basededatos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Asegúrate de que coincidan exactamente con los datos de tu base de datos en cPanel. Para obtenerlos, ve a "Bases de datos MySQL" en cPanel. Allí verás el nombre de la base, el usuario y puedes cambiar la contraseña si la has olvidado.

[TIP] Muchas veces el DB_HOST no es localhost, sino algo como localhost:/tmp/mysql5.sock o una IP. Pregunta a tu proveedor de hosting si no estás seguro.

Paso 2: Repara la base de datos
En cPanel, busca "phpMyAdmin". Selecciona tu base de datos, marca todas las tablas, y en el menú desplegable elige "Reparar tabla". Esto soluciona corrupciones menores.

Paso 3: Reasigna permisos al usuario
En "Bases de datos MySQL", ve a "Añadir usuario a la base de datos". Asegúrate de que el usuario esté añadido y tenga todos los privilegios (marca "Todos los privilegios").

Pantalla Blanca de la Muerte (WSOD)

La web carga pero no se ve nada, solo un fondo blanco. Es otro clásico.

Causa principal

Casi siempre es un plugin o tema que genera un error PHP fatal.

Solución

Paso 1: Accede por FTP o Administrador de Archivos
Ve a public_html/wp-content/themes. Renombra la carpeta de tu tema activo (por ejemplo, twentytwentythree a twentytwentythree_desactivado). WordPress cargará un tema por defecto (Twenty Twenty-Four o similar). Si la web aparece, el tema era el problema. Actualízalo o cámbialo.

Paso 2: Activa el modo debug de WordPress
En wp-config.php, busca la línea define('WP_DEBUG', false); y cámbiala a define('WP_DEBUG', true);. Además, añade:

define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Guarda y recarga la web. Luego, revisa el archivo wp-content/debug.log. Allí verás el error exacto (por ejemplo, "Fatal error: Call to undefined function...").

Error 404 en Páginas (excepto la principal)

Las páginas internas dan error 404, pero la portada funciona.

Causa

Los enlaces permanentes están mal configurados o el .htaccess no se regeneró.

Solución

Entra a tu panel de WordPress (si puedes). Ve a "Ajustes" > "Enlaces permanentes". Selecciona cualquier opción (por ejemplo, "Nombre de la entrada") y haz clic en "Guardar cambios". Esto regenera las reglas. Si no puedes acceder, sigue el Paso 2 del Error 500 para restaurar el .htaccess.

[INFO] Si tu hosting usa Nginx en lugar de Apache, necesitarás añadir reglas específicas en la configuración del servidor. Contacta a tu proveedor.

Problemas de Subida de Archivos (Imágenes, Plugins)

No puedes subir imágenes o instalar plugins desde el panel de WordPress.

Causas

Límite de tamaño de subida muy bajo.
Permisos incorrectos en la carpeta uploads.
Falta de espacio en disco.

Solución

Paso 1: Aumenta el límite de subida
Desde cPanel, en "Seleccionar versión de PHP", busca upload_max_filesize y post_max_size. Cámbialos a 64M o 128M. También busca max_execution_time y ponlo a 300.

Paso 2: Verifica permisos de la carpeta uploads
En public_html/wp-content/uploads, asegúrate de que la carpeta tenga permisos 755 y los archivos 644. Si no existe, créala.

Paso 3: Libera espacio en disco
Revisa si tu plan de hosting tiene espacio suficiente. Desde cPanel, en "Estadísticas", verás el uso del disco. Si está al 100%, borra archivos temporales o actualiza tu plan.

Error de Memoria Agotada (Allowed memory size exhausted)

Aparece un mensaje como "Fatal error: Allowed memory size of 134217728 bytes exhausted".

Solución

Además de aumentar memory_limit en PHP (como en el Error 500), puedes añadir esta línea en wp-config.php:

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

Si tu hosting lo permite, también puedes crear un archivo php.ini en public_html con:

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M

Error al Instalar o Actualizar WordPress

No puedes instalar WordPress desde el instalador de cPanel (Softaculous, Installatron, etc.) o falla la actualización.

Causas

Versión de PHP incompatible.
Permisos de archivos incorrectos.
Falta de extensiones PHP.

Solución

Paso 1: Cambia la versión de PHP
Desde cPanel, en "Seleccionar versión de PHP", elige una versión compatible con WordPress (se recomienda PHP 8.0, 8.1 o 8.2). Las versiones muy antiguas (5.6, 7.0) ya no son seguras.

Paso 2: Habilita extensiones PHP necesarias
En el mismo selector, busca "Extensiones" o "PHP Extensions". Asegúrate de que estén activadas: mysqli, curl, gd, mbstring, xml, zip, openssl. Si alguna está desactivada, actívala.

Paso 3: Usa el instalador manual
Si el instalador automático falla, descarga WordPress desde wordpress.org, súbelo por FTP a public_html y sigue la instalación manual. A veces los instaladores automáticos tienen conflictos con configuraciones específicas.

Problemas de SSL (HTTPS no funciona)

Tu web no carga con HTTPS, o hay contenido mixto (http y https mezclados).

Solución

Paso 1: Instala un certificado SSL
Desde cPanel, busca "SSL/TLS" o "AutoSSL". Actívalo si está disponible. Muchos hosts ofrecen Let's Encrypt gratis.

Paso 2: Configura WordPress para HTTPS
En wp-config.php, añade:

define('FORCE_SSL_ADMIN', true);

Luego, en el panel de WordPress, ve a "Ajustes" > "Generales" y cambia las URLs de WordPress y del sitio a https://tudominio.com.

Paso 3: Corrige contenido mixto
Usa un plugin como "Really Simple SSL" o "SSL Insecure Content Fixer" para escanear y reemplazar URLs http por https en la base de datos.

[TIP] Si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106. La configuración de SSL en Syspanel es similar, pero busca "SSL" en el panel izquierdo.

Preguntas Frecuentes (FAQ)

P: ¿Cómo accedo a cPanel?
R: Normalmente es tudominio.com/cpanel o tudominio.com:2083. Pregunta a tu proveedor si no sabes.

P: ¿Qué hago si no recuerdo la contraseña de la base de datos?
R: En cPanel, ve a "Bases de datos MySQL", busca tu usuario y haz clic en "Cambiar contraseña". Luego actualiza wp-config.php.

P: Mi web está muy lenta, ¿qué hago?
R: Primero, revisa si hay plugins pesados. Luego, desde cPanel, activa la caché (si tu hosting la ofrece) o usa un plugin de caché como W3 Total Cache. También puedes aumentar el límite de memoria PHP.

P: ¿Cómo hago una copia de seguridad?
R: En cPanel, usa "Copias de seguridad" o "Backup". Descarga el backup completo (archivos + base de datos) periódicamente.

P: ¿Qué es Syspanel?
R: Es un panel de control alternativo a cPanel, también conocido como HestiaCP. Su puerto de acceso es el 2106 (ejemplo: tudominio.com:2106). La mayoría de los pasos de esta guía aplican igual, pero la interfaz es diferente.

Consejos Finales para Evitar Errores

Actualiza siempre: Mantén WordPress, plugins y temas actualizados desde el panel de administración.
Haz copias de seguridad semanales: Usa la herramienta de cPanel o un plugin como UpdraftPlus.
No instales plugins de fuentes dudosas: Solo descarga desde el repositorio oficial de WordPress o desarrolladores de confianza.
Monitorea los logs: En cPanel, revisa "Registros de errores" o "Error log" para detectar problemas antes de que se vuelvan graves.
Prueba en un entorno de staging: Si tu hosting lo permite, haz cambios primero en una copia de tu web.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Si después de seguir todos los pasos el error persiste, no dudes en contactar al soporte técnico de tu hosting, indicándoles exactamente qué has probado. ¡Buena suerte con tu WordPress!