Errores comunes de WordPress en cPanel: soluciones - FAQ

¿Tu sitio WordPress en cPanel ha dejado de funcionar y no sabes por dónde empezar? No te preocupes, es más común de lo que crees. Como técnico de soporte, he visto cientos de casos donde un simple error en la configuración o un plugin conflictivo pueden tumbarte la web. En esta guía extensa y paso a paso, vamos a desglosar los errores más frecuentes (desde el temido error 500 hasta problemas con la base de datos) y te enseñaré cómo solucionarlos usando las herramientas que tienes en cPanel. No necesitas ser un experto; solo sigue las instrucciones al pie de la letra.

[INFO] Si usas un panel alternativo como Syspanel (antiguo HestiaCP), el acceso a las herramientas de archivos y bases de datos es similar, pero recuerda que el puerto de acceso es el 2106. En cPanel, el puerto estándar es 2083.

¿Por qué ocurren estos errores y cómo prepararte?

Antes de meternos en faena, entiende que la mayoría de los errores de WordPress se deben a tres causas principales:

Conflictos de plugins o temas (incompatibilidades tras actualizaciones).
Límites de recursos del servidor (memoria, tiempo de ejecución).
Problemas con la base de datos (corrupción, conexión perdida).

Herramientas que necesitarás en cPanel

Para solucionar estos problemas, vas a usar principalmente:

Administrador de Archivos: Para editar o renombrar carpetas y archivos.
phpMyAdmin: Para gestionar y reparar la base de datos.
Selectores de versión de PHP: Para cambiar la configuración del servidor.
Registros de errores: Para identificar la causa exacta.

Error 500 – El más común y molesto

El error 500 (Internal Server Error) es el comodín de los problemas. Aparece cuando algo sale mal en el servidor pero no te da detalles. Vamos a solucionarlo paso a paso.

1. Desactiva todos los plugins (sin acceso al panel)

Cuando no puedes entrar a tu wp-admin, la solución más rápida es desactivar los plugins manualmente.

Entra a cPanel > Administrador de Archivos.
Ve a la carpeta public_html (o la carpeta donde esté instalado WordPress).
Busca la carpeta wp-content.
Dentro de wp-content, localiza la carpeta plugins.
Renómbrala a algo como plugins_desactivados. Esto hará que WordPress no pueda cargar ningún plugin.
Vuelve a tu web. Si el error desaparece, el problema era un plugin. Ahora puedes crear una carpeta nueva plugins e ir moviendo los plugins de uno en uno desde plugins_desactivados para identificar al culpable.

[TIP] Si renombrar la carpeta no funciona, prueba con el tema por defecto. Dentro de wp-content/themes, renombra la carpeta de tu tema activo (ej: mi-tema a mi-tema_old). WordPress cargará automáticamente un tema por defecto (Twenty Twenty-Four).

2. Aumenta el límite de memoria PHP

A veces el error 500 es por falta de memoria. En cPanel:

Ve a Selector de versión de PHP o MultiPHP INI Editor.
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios y recarga la web.

3. Revisa el archivo .htaccess

Un archivo .htaccess corrupto también causa error 500.

En el Administrador de Archivos, asegúrate de ver archivos ocultos (clic en "Mostrar archivos ocultos").
Localiza el archivo .htaccess en la raíz de tu WordPress.
Renómbralo a .htaccess_old.
Ve a tu web. Si funciona, ve a Ajustes > Enlaces permanentes en tu wp-admin y haz clic en "Guardar cambios" para regenerar el archivo.

Error de conexión a la base de datos – La pesadilla blanca

Este error aparece como "Error establishing a database connection". Significa que WordPress no puede comunicarse con tu base de datos. Es un problema crítico pero solucionable.

1. Verifica los datos en wp-config.php

El archivo wp-config.php contiene las credenciales de la base de datos. A veces se corrompen o cambian.

En el Administrador de Archivos, abre el archivo wp-config.php (en la raíz).

Busca estas líneas:

define('DB_NAME', 'nombre_base');
define('DB_USER', 'usuario_base');
define('DB_PASSWORD', 'contraseña_base');
define('DB_HOST', 'localhost');

Comprueba que estos datos coincidan con los que aparecen en cPanel > Bases de datos MySQL.
El DB_HOST suele ser localhost, pero a veces tu proveedor usa algo como mysql.tudominio.com. Si no estás seguro, contacta al soporte de hosting.

[WARNING] Si cambias la contraseña de la base de datos desde cPanel, debes actualizarla también en wp-config.php. De lo contrario, tendrás este error fijo.

2. Repara la base de datos desde phpMyAdmin

Si las credenciales son correctas, la base de datos puede estar corrupta.

Ve a cPanel > phpMyAdmin.
Selecciona tu base de datos de WordPress en la columna izquierda.
Marca la casilla "Seleccionar todo" en la parte inferior de la lista de tablas.
En el menú desplegable "Con seleccionados", elige "Reparar tabla".
phpMyAdmin ejecutará un comando REPAIR TABLE. Si hay errores, te los mostrará.

3. Verifica el usuario de la base de datos

A veces el usuario no tiene todos los permisos.

En cPanel > Bases de datos MySQL, busca la sección "Usuarios en bases de datos".
Asegúrate de que el usuario correcto esté añadido a la base de datos correcta y que tenga TODOS LOS PRIVILEGIOS marcados.

Error 403 – Acceso prohibido

Este error suele deberse a permisos incorrectos en archivos o a un plugin de seguridad demasiado restrictivo.

Solución rápida: Permisos de archivos

En el Administrador de Archivos, selecciona todos los archivos de la carpeta public_html.
Haz clic en Permisos en la barra superior.
Establece 755 para las carpetas y 644 para los archivos.
Si tienes muchos archivos, puedes hacerlo por lotes: primero selecciona solo las carpetas, cambia a 755, luego selecciona solo los archivos, cambia a 644.

Revisa el archivo .htaccess

Como en el error 500, renombra el .htaccess a .htaccess_old. Si el error desaparece, el problema está en las reglas de redirección o en un plugin de seguridad.

Error 404 (Página no encontrada) después de cambiar enlaces permanentes

Esto es muy típico. Has cambiado la estructura de URLs y WordPress no regenera las reglas.

Ve a Ajustes > Enlaces permanentes en tu wp-admin.
Simplemente selecciona cualquier opción (por ejemplo, "Simple") y luego vuelve a seleccionar la que tenías (por ejemplo, "Nombre de la entrada").
Haz clic en Guardar cambios dos veces. Esto fuerza a WordPress a regenerar el archivo .htaccess.

[INFO] Si no puedes acceder al wp-admin, renombra el .htaccess como en el error 500 y luego intenta acceder a tudominio.com/wp-admin. A veces el problema es que el archivo está bloqueado por permisos.

Error "White Screen of Death" (Pantalla Blanca)

No ves nada, solo una página en blanco. Esto suele ser por un error fatal de PHP.

1. Activa el modo debug de WordPress

Abre wp-config.php en el Administrador de Archivos.
Busca la línea define('WP_DEBUG', false); (si no existe, añádela antes de la línea /* That's all, stop editing! */).

Cámbiala a:

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

Guarda el archivo. Ahora WordPress escribirá los errores en un archivo llamado debug.log dentro de la carpeta wp-content.
Revisa ese archivo desde el Administrador de Archivos para ver el mensaje de error exacto.

2. Aumenta el límite de memoria (otra vez)

Como en el error 500, sube el memory_limit a 256M o 512M desde el Selector de versión de PHP.

FAQ – Preguntas Frecuentes sobre WordPress errores en cPanel

¿Por qué mi sitio da error 500 después de actualizar un plugin?

Las actualizaciones de plugins a veces introducen incompatibilidades con tu versión de PHP o con otros plugins. La solución más rápida es desactivar el plugin manualmente renombrando su carpeta (como explicamos arriba) y luego buscar una versión alternativa o contactar al desarrollador.

¿Cómo recupero mi web si no recuerdo la contraseña de la base de datos?

Puedes cambiar la contraseña desde cPanel > Bases de datos MySQL. Busca el usuario de la base de datos y haz clic en "Cambiar contraseña". Luego, actualiza esa contraseña en tu archivo wp-config.php.

¿Qué hago si veo "Error al conectar con la base de datos" pero los datos son correctos?

Prueba a cambiar el DB_HOST en wp-config.php. A veces, en lugar de localhost, tu servidor necesita 127.0.0.1 o una dirección específica que te dará tu proveedor de hosting. También puedes reparar la base de datos desde phpMyAdmin como indicamos.

¿Puedo restaurar una copia de seguridad desde cPanel?

Sí, si tu hosting tiene la herramienta Copias de seguridad o Backup. Busca en cPanel la opción "Copias de seguridad" o "Backup Wizard". Puedes restaurar archivos y bases de datos completas. Si no tienes copia, contacta a tu proveedor.

¿El error de "Enlaces permanentes" afecta al SEO?

Sí, porque si tu web devuelve 404 en todas las páginas excepto la principal, Google no podrá indexar tu contenido. Una vez que soluciones el error (regenerando los enlaces permanentes), asegúrate de que todas las URLs funcionan correctamente.

¿Cómo sé si mi versión de PHP es la correcta?

Ve a cPanel > Selector de versión de PHP. WordPress recomienda PHP 8.0 o superior. Si usas una versión muy antigua (como 5.6), muchos plugins dejarán de funcionar y tendrás errores de seguridad.

Resumen y consejos finales

Siempre haz una copia de seguridad antes de tocar archivos o la base de datos. La mayoría de los errores se solucionan con cambios simples, pero un fallo puede dejarte sin web.
Actualiza todo regularmente: WordPress, plugins, temas y la versión de PHP. Las versiones antiguas son las que más errores dan.
Usa un tema hijo si modificas el código del tema. Esto evita que una actualización del tema padre te borre los cambios y te genere errores.
Los registros de errores son tus mejores amigos. Si no sabes qué pasa, activa el modo debug de WordPress o revisa los logs de cPanel (en Registros de errores o Error Log).

Si después de seguir todos estos pasos el error persiste, contacta con el soporte técnico de tu hosting. Diles que ya has probado a desactivar plugins, cambiar el tema, reparar la base de datos y aumentar la memoria. Ellos podrán revisar los logs del servidor a nivel más profundo.

Recuerda que en Syspanel (HestiaCP) el proceso es muy similar, solo que el acceso a phpMyAdmin y al Administrador de Archivos está en el panel izquierdo, y el puerto es el 2106.

¡Espero que esta guía te haya ayudado a resolver el problema! Si te quedó alguna duda, repasa los pasos con calma. La mayoría de los errores de WordPress en cPanel se solucionan en menos de 15 minutos con estas técnicas.