Error de base de datos en WordPress cPanel: cómo arreglarlo

Imagina que llegas a tu web y, en lugar de tu contenido, ves un mensaje como: “Error establishing a database connection” o “Error de conexión a base de datos”. Es frustrante, ¿verdad? Pero no te preocupes, es uno de los errores más comunes en WordPress y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo desde cPanel. En esta guía, te explicaré paso a paso cómo identificar y solucionar este problema, incluso si no tienes experiencia técnica. Vamos a ello.

¿Qué significa el error de conexión a base de datos en WordPress?

Cuando ves este mensaje, WordPress te está diciendo que no puede comunicarse con la base de datos donde se almacena todo tu contenido (entradas, páginas, usuarios, configuraciones). Sin esa conexión, tu sitio no puede funcionar. Las causas más comunes son:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos no coinciden.
Base de datos corrupta: Los datos están dañados y necesitan reparación.
Servidor MySQL caído: El servicio de base de datos no está activo.
Límites de recursos excedidos: Tu hosting tiene restricciones de memoria o conexiones.
Archivo de configuración dañado: El archivo wp-config.php tiene errores.

Vamos a solucionarlo. Todo lo haremos desde cPanel, la herramienta de administración de tu hosting.

Requisitos previos antes de empezar

Antes de tocar nada, asegúrate de tener:

Acceso a cPanel (usuario y contraseña que te dio tu proveedor de hosting).
Un respaldo reciente de tu sitio (por si algo sale mal, aunque los pasos son seguros).

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), accede a través del puerto 2106, por ejemplo: https://tudominio.com:2106. El proceso es muy similar, pero los nombres de las secciones pueden variar ligeramente.

Paso 1: Verificar el estado del servicio MySQL desde cPanel

Lo primero es asegurarte de que el servidor de bases de datos esté funcionando. A veces, el servicio se cae por mantenimiento o sobrecarga.

Inicia sesión en cPanel.
Busca la sección “Base de Datos” y haz clic en “MySQL® Databases” o “Bases de datos MySQL”.
En la parte inferior de la página, verás una lista de tus bases de datos. Si el servicio está activo, verás un mensaje como “El servidor MySQL está funcionando”. Si no, contacta a tu soporte técnico.
También puedes ir a “Estado del servidor” (en la sección “General”) y buscar “MySQL” en la lista. Debe aparecer en verde.

Si todo está en verde, continúa con el siguiente paso.

Paso 2: Verificar las credenciales en el archivo wp-config.php

El error más frecuente es que las credenciales de la base de datos no coincidan. WordPress guarda estos datos en el archivo wp-config.php. Vamos a revisarlo.

En cPanel, ve a “Administrador de archivos” (en la sección “Archivos”).
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta como public_html/miweb).
Busca el archivo wp-config.php. Haz clic derecho sobre él y selecciona “Editar” (o “Code Editor” si te lo pide).
Busca las líneas que empiezan con define('DB_NAME', define('DB_USER', define('DB_PASSWORD' y define('DB_HOST'. Deberían verse así:

define('DB_NAME', 'tu_usuario_wpdb');
define('DB_USER', 'tu_usuario_wpuser');
define('DB_PASSWORD', 'tu_contraseña_segura');
define('DB_HOST', 'localhost');

Anota estos valores (o copia la pantalla en un bloc de notas). Luego, cierra el editor sin guardar cambios por ahora.

Ahora, verifica que estos datos sean correctos desde cPanel:

Ve a “Bases de datos MySQL”.
Busca la lista de bases de datos y usuarios. Asegúrate de que el DB_NAME (nombre de la base) y DB_USER (usuario) existan y estén vinculados. Si no ves tu base de datos, puede que la hayan eliminado (lo veremos más adelante).
La contraseña debe ser la que creaste al instalar WordPress. Si no la recuerdas, puedes cambiarla desde “Bases de datos MySQL” > “Cambiar contraseña” junto al usuario correspondiente. Luego, actualiza el archivo wp-config.php con la nueva contraseña.

[TIP] Si no estás seguro de la contraseña, cámbiala en cPanel y luego actualiza el wp-config.php. Es más seguro que adivinarla.

Paso 3: Reparar la base de datos desde cPanel (método automático)

Si las credenciales son correctas pero el error persiste, la base de datos puede estar corrupta. WordPress tiene una herramienta de reparación integrada.

Abre el archivo wp-config.php nuevamente en el Administrador de archivos.
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, agrega esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Abre una nueva pestaña en tu navegador y ve a: tudominio.com/wp-admin/maint/repair.php. Si tu sitio está en una subcarpeta, ajusta la ruta (ej: tudominio.com/miweb/wp-admin/maint/repair.php).
Verás dos opciones: “Repair Database” (reparar) y “Repair and Optimize Database” (reparar y optimizar). Elige la segunda para una solución completa.
Espera unos segundos. La herramienta analizará y corregirá errores. Al final, verás un mensaje de éxito o una lista de tablas reparadas.
Importante: Una vez terminado, vuelve al archivo wp-config.php y elimina la línea que agregaste (define('WP_ALLOW_REPAIR', true);). Si la dejas, cualquiera podría acceder a la reparación sin autenticación.

[WARNING] No olvides eliminar esa línea después de reparar. Es un riesgo de seguridad dejar esa función activa.

Paso 4: Verificar el prefijo de las tablas (para usuarios avanzados)

A veces, el error se debe a que el prefijo de las tablas en la base de datos no coincide con el que espera WordPress. Esto es raro, pero puede pasar tras migraciones o restauraciones.

En cPanel, ve a “phpMyAdmin” (en la sección “Bases de Datos”).
Selecciona tu base de datos en la lista de la izquierda.
Verás una lista de tablas. Normalmente empiezan con wp_ (ej: wp_posts, wp_options). Si ves que tienen otro prefijo (como blog_ o site_), anótalo.
Vuelve al archivo wp-config.php y busca la línea:

$table_prefix = 'wp_';

Cambia 'wp_' por el prefijo que viste en phpMyAdmin. Por ejemplo, si las tablas son blog_posts, pon 'blog_'.
Guarda el archivo y prueba tu web.

Paso 5: Aumentar los límites de memoria (si el error es intermitente)

Si el error aparece de vez en cuando (no siempre), puede deberse a que tu hosting tiene límites de memoria bajos. Esto es común en planes compartidos.

En el Administrador de archivos de cPanel, edita el archivo wp-config.php.
Justo después de <?php, agrega esta línea:

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

Guarda y prueba. Si el error persiste, contacta a tu hosting para que revisen los límites del servidor.

Paso 6: Verificar si la base de datos fue eliminada o renombrada

A veces, por error, alguien (tú mismo o el soporte) puede eliminar o renombrar la base de datos. Para comprobarlo:

En cPanel, ve a “Bases de datos MySQL”.
Busca el nombre de la base que aparece en tu wp-config.php (recuerda que en cPanel suele tener un prefijo como tuusuario_). Si no aparece en la lista, significa que fue eliminada.
Si no está, deberás crearla nuevamente:
- Crea una nueva base de datos con el mismo nombre (o uno nuevo).
- Crea un usuario y asígnale todos los privilegios.
- Luego, deberás restaurar un respaldo de tu base de datos (pídelo a tu hosting o usa un plugin como UpdraftPlus si tienes acceso al panel de administración, aunque con el error no podrás entrar). Si no tienes respaldo, lamentablemente perderás los datos y deberás reinstalar WordPress.

[WARNING] Siempre ten un respaldo automático de tu base de datos. Es tu salvavidas.

Paso 7: Probar con el host de base de datos alternativo

En algunos casos, el servidor de base de datos no responde a localhost y necesita una IP específica o un socket. Esto es más común en hosting compartidos o con Syspanel.

En el archivo wp-config.php, cambia 'localhost' por '127.0.0.1' (la IP de loopback). Guarda y prueba.
Si no funciona, contacta a tu hosting y pregunta: “¿Cuál es el host de base de datos que debo usar? ¿Es localhost, 127.0.0.1 o un socket?”. Ellos te darán el valor correcto.

Paso 8: Revisar los logs de errores de WordPress

Si nada de lo anterior funciona, los logs pueden darte pistas más precisas.

En el Administrador de archivos, abre el archivo wp-config.php.
Agrega estas líneas justo después de <?php:

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

Guarda el archivo y recarga tu web. Luego, ve a la carpeta wp-content y busca un archivo llamado debug.log. Ábrelo y busca líneas que contengan “database” o “MySQL”. Te dirá el error exacto (ej: “Access denied for user”, “Table doesn't exist”, etc.).
Con ese mensaje, puedes buscar soluciones específicas o compartirlo con tu soporte.

[TIP] Una vez resuelto, elimina esas líneas del wp-config.php para no ralentizar tu web.

Preguntas frecuentes (FAQ)

¿Por qué aparece este error después de cambiar la contraseña de cPanel?

Si cambias la contraseña de cPanel, la contraseña de la base de datos no cambia automáticamente. Debes actualizarla manualmente en el archivo wp-config.php o cambiar la contraseña de la base desde Bases de datos MySQL.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos común. Un plugin mal codificado puede saturar la base de datos. Si el error apareció justo después de instalar un plugin, desactívalo renombrando su carpeta desde el Administrador de archivos (ve a wp-content/plugins y cambia el nombre de la carpeta del plugin sospechoso a plugin-desactivado).

¿Qué hago si no tengo acceso a cPanel?

Pide a tu hosting que te restablezca el acceso o que verifique el estado de la base de datos. Si tienes acceso FTP, puedes editar el wp-config.php desde allí, pero no podrás reparar la base.

¿Cuánto tiempo tarda en solucionarse?

Entre 5 y 30 minutos si sigues estos pasos. Si el problema es del servidor, depende de tu hosting.

Conclusión: No entres en pánico, es solucionable

El error de conexión a base de datos en WordPress es como un corte de luz en tu casa: molesto, pero con herramientas adecuadas lo resuelves rápido. Desde cPanel tienes todo lo necesario: verificar credenciales, reparar la base, ajustar la memoria y revisar logs. Si después de todos estos pasos el error persiste, contacta a tu proveedor de hosting, ya que puede ser un problema del servidor (como un MySQL caído o restricciones de recursos).

Recuerda siempre tener un respaldo actualizado y, si usas Syspanel, accede por el puerto 2106. ¡Tu web volverá a estar online en minutos!