Error de conexión a base de datos WordPress: Solución con cPanel

¡Hola! Soy tu asistente de soporte técnico. Sé que ver un mensaje de error en tu web puede ser frustrante, sobre todo cuando parece que viene de algo tan técnico como la base de datos. Pero no te preocupes, porque hoy vamos a desglosar, paso a paso y sin tecnicismos complicados, cómo resolver el temido error de conexión a la base de datos en WordPress.

Este es uno de los problemas más comunes (y más fáciles de arreglar de lo que crees) cuando usas WordPress con un panel de control como cPanel. Antes de que llames a tu proveedor de hosting o entres en pánico, respira hondo. En la mayoría de los casos, la solución está a solo unos clics de distancia, y yo te voy a guiar para que lo hagas tú mismo.

Vamos a empezar por entender qué significa exactamente este mensaje y luego pasaremos a las soluciones prácticas.

¿Qué significa el error "Error al establecer una conexión con la base de datos"?

Cuando ves el mensaje "Error al establecer una conexión con la base de datos" o el clásico "Error connecting to database", significa que WordPress ha intentado hablar con tu base de datos (donde se guardan tus artículos, páginas y configuraciones) y no ha recibido respuesta. Es como si intentaras llamar a alguien por teléfono y la línea estuviera muerta.

Las causas más habituales suelen ser cuatro:

Datos de acceso incorrectos: El nombre de usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos.
Servidor de base de datos caído: El servidor MySQL (donde viven las bases de datos) está sobrecargado o se ha detenido.
Archivos corruptos o modificados: El archivo wp-config.php (el cerebro de la configuración) tiene errores.
Problemas de permisos: A veces, en cPanel, los permisos de los archivos se cambian accidentalmente y bloquean el acceso.

No te asustes con la jerga técnica. Vamos a ver cómo arreglar el error de conexión base de datos WordPress de forma metódica, empezando por lo más simple y avanzando hacia lo más complejo.

Solución 1: Verifica el estado del servidor MySQL en cPanel

Lo primero que debemos descartar es que el problema no sea del servidor, sino nuestro. A veces, el servidor de bases de datos se reinicia o se satura.

### Pasos para comprobar el servidor

Accede a tu panel de control de cPanel. Normalmente es algo como tudominio.com/cpanel o tudominio.com:2083.
Busca la sección llamada "Base de Datos MySQL" o "MySQL Databases".
Justo debajo del título, suele haber un enlace o botón que dice "Acceder a phpMyAdmin" o "Administrar". No hagas clic aún.
Busca en la parte derecha o en la barra lateral una sección llamada "Estado del servidor" o "Server Status". Haz clic en ella.
Busca la línea que dice "MySQL" o "SQL". Si el punto está en verde, el servidor está activo. Si está en rojo o muestra "Down", el problema es del hosting.

[INFO] Si el servidor MySQL está caído, no puedes arreglarlo tú. Debes contactar con el soporte de tu empresa de hosting y esperar a que lo reinicien. Ellos lo solucionan en minutos. Si el punto está en verde, continúa con el siguiente paso.

Solución 2: Revisar y arreglar el archivo wp-config.php

Este es el archivo más importante para la conexión. Es un archivo de texto con datos de configuración. Si tiene un error tipográfico o un dato antiguo, WordPress no podrá conectarse. Es la causa más común del WordPress database error.

### Cómo editar el archivo de forma segura

Entra en tu cPanel y busca el "Administrador de Archivos" (File Manager).
Entra en la carpeta public_html. Es aquí donde normalmente vive tu WordPress.
Busca el archivo llamado wp-config.php. NO LO ABRAS AÚN. Primero, haz clic derecho sobre él y selecciona "Copiar". Cópialo en la misma carpeta o en tu escritorio como respaldo. Esto es crucial por si metemos la pata.
Ahora sí, haz clic derecho sobre el archivo original y selecciona "Editar" o "Edit". Se abrirá un editor de texto.
Busca las líneas que se parecen a esto:

// ** Configuración de MySQL - Puedes obtenerla de tu proveedor de hosting ** //
define( 'DB_NAME', 'tu_usuario_wpdb' );
define( 'DB_USER', 'tu_usuario_wpuser' );
define( 'DB_PASSWORD', 'tu_contraseña_secreta' );
define( 'DB_HOST', 'localhost' );

### ¿Qué debo mirar aquí?

DB_NAME: El nombre de la base de datos. En cPanel, suele tener un prefijo con tu nombre de usuario, por ejemplo usuarioweb_basedatos.
DB_USER: El usuario de la base de datos. También suele tener un prefijo, como usuarioweb_wpuser.
DB_PASSWORD: La contraseña de ese usuario. A veces la olvidamos o la cambiamos.
DB_HOST: Normalmente es localhost, pero a veces tu hosting usa un servidor específico como mysql.tudominio.com. Si tu proveedor te dio una dirección distinta, aquí debe estar.

[WARNING] No cambies nada todavía. Lo que vamos a hacer es verificar que estos datos son correctos. La forma más fácil de comprobarlo es ir a la sección "Base de Datos MySQL" en cPanel. Ahí verás una lista con tus bases de datos y sus usuarios. Compara los nombres exactos. Si el nombre de la base de datos es usuarioweb_basedatos y el archivo dice usuarioweb_basedatos2, ahí está el error.

Si encuentras que el nombre del usuario o la base de datos está mal, corrígelo en el archivo y guarda los cambios. Si la contraseña es incorrecta, tendrás que cambiarla.

### Cómo cambiar la contraseña de la base de datos en cPanel

En la misma sección de "Base de Datos MySQL", busca la lista de usuarios.
Al lado del usuario que usa WordPress (el que está en DB_USER), haz clic en "Cambiar contraseña".
Genera una contraseña segura (puedes usar el generador que te ofrece cPanel) y cópiala.
Pega esa contraseña exactamente en el archivo wp-config.php en la línea DB_PASSWORD.
Guarda el archivo y vuelve a intentar cargar tu web.

[TIP] Si tu web sigue dando error, prueba a cambiar el DB_HOST de localhost a 127.0.0.1. A veces esto soluciona problemas de resolución de nombres internos del servidor. Guarda y prueba. Si no funciona, déjalo como estaba.

Solución 3: Reparar la base de datos desde cPanel

Si los datos son correctos, el problema puede ser que la base de datos esté corrupta (algo raro, pero posible). WordPress tiene una herramienta de reparación integrada, pero hay que activarla manualmente.

### Activar el modo de reparación

Vuelve a abrir el archivo wp-config.php en el editor.
Busca la línea que dice define( 'WP_DEBUG', false ); o similar.
Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! Feliz blogging. */, añade esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, ve a esta dirección: tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos botones. Haz clic en "Reparar base de datos" (Repair Database). No toques el de "Reparar y Optimizar" todavía, si no sabes lo que haces, ya que puede tardar mucho.
Espera a que termine. Te dirá si ha encontrado y arreglado algo.
IMPORTANTE: Vuelve a tu archivo wp-config.php y ELIMINA la línea define('WP_ALLOW_REPAIR', true); que añadiste. Si la dejas, cualquiera podría intentar reparar tu base de datos, lo cual es un riesgo de seguridad.

[WARNING] Es muy fácil olvidarse de quitar esa línea. Si la dejas puesta, es un agujero de seguridad grave. Hazlo inmediatamente después de la reparación.

Solución 4: Verificar los permisos de archivos

Los permisos de archivos son como las cerraduras de una puerta. Si tienen demasiados privilegios, son inseguros. Si tienen muy pocos, WordPress no puede leer los archivos necesarios y da errores.

### Cómo comprobar los permisos

Ve al "Administrador de Archivos" en cPanel.
Ve a public_html y busca el archivo wp-config.php.
Haz clic derecho sobre él y selecciona "Permisos" o "Change Permissions".
Debe estar configurado en 644. Esto significa que el propietario puede leer y escribir, y los demás solo pueden leer.
Si ves algo como 666, 777 o 444, cámbialo a 644.
Haz lo mismo con las carpetas principales (como wp-content). Las carpetas deben estar en 755.

[INFO] Si los permisos están mal, no solo causa este error, sino que también puede dar problemas de seguridad. Mantener 644 en archivos y 755 en carpetas es la regla de oro en hosting Linux.

Solución 5: El problema del plugin o tema (caso especial)

A veces, el error no es de conexión, sino que un plugin o tema está intentando hacer una consulta a la base de datos que falla, mostrando un mensaje de "Error establishing a database connection" en una parte específica de la web, pero no en toda.

### Cómo diagnosticarlo

Si el error aparece solo en una página, o si al entrar al panel de administración (/wp-admin) funciona pero la web no, suele ser un conflicto de plugins.
No puedes desactivar plugins desde el panel si la web está rota. Así que tendrás que hacerlo por FTP o por el Administrador de Archivos de cPanel.
En el Administrador de Archivos, ve a public_html/wp-content/plugins.
Verás una lista de carpetas, una por cada plugin.
Renombra una carpeta de un plugin (por ejemplo, de contact-form-7 a contact-form-7-inactivo). Esto lo desactiva automáticamente.
Recarga tu web. Si ya funciona, ese era el problema. Si no, repite el proceso con otra carpeta.

[TIP] Si renombras la carpeta y la web se arregla, puedes entrar en tu panel de administración y desactivar el plugin correctamente desde allí. Luego, vuelve a renombrar la carpeta a su nombre original para poder reactivarlo si es necesario.

Solución 6: Aumentar el límite de memoria PHP

A veces, el error es engañoso. No es que no haya conexión, sino que PHP se queda sin memoria para procesar la petición y muestra un mensaje genérico.

### Cómo aumentar la memoria

En el Administrador de Archivos, busca el archivo php.ini en la raíz de public_html. Si no existe, créalo.
Edítalo o créalo con el siguiente contenido:

memory_limit = 256M
max_execution_time = 300

Guarda el archivo.
Si no funciona, también puedes añadir una línea al wp-config.php:

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

Añádela justo después de las líneas de configuración de la base de datos.

Preguntas Frecuentes (FAQ)

### ¿Por qué me sale "Error al conectar con la base de datos" después de mover mi web a otro hosting?

Esto es casi siempre un problema de datos en wp-config.php. Al mover la web, las credenciales de la base de datos cambian. Asegúrate de haber actualizado el DB_NAME, DB_USER y DB_PASSWORD con los datos del nuevo hosting.

### ¿Qué hago si todo lo anterior falla?

Si has seguido todos los pasos y el error de conexión base de datos WordPress persiste, el problema es más profundo. Podría ser un problema del servidor DNS o un firewall bloqueando la conexión. En ese caso, contacta con tu proveedor de hosting y diles que ya has verificado los datos de la base de datos y los permisos, y que crees que es un problema de red interna del servidor.

### ¿Puedo arreglar este error desde la base de datos directamente?

Sí, pero es más avanzado. Si tienes acceso a phpMyAdmin desde cPanel, puedes entrar y explorar las tablas. Si una tabla está corrupta, la verás marcada con un icono de error. Puedes seleccionarla y en la parte inferior elegir la opción "Reparar". Esto es equivalente a la Solución 3, pero de forma manual.

### ¿Es normal que este error aparezca cuando hay mucho tráfico?

Sí, a veces el servidor MySQL se satura con demasiadas conexiones simultáneas y rechaza nuevas peticiones. Esto es un problema de recursos del hosting. Si esto te pasa a menudo, considera cambiar a un plan con más recursos o usar un plugin de caché para reducir las consultas a la base de datos.

Resumen y consejo final

Como has visto, arreglar el error de conexión a la base de datos en WordPress no es un misterio. La mayoría de las veces se soluciona con paciencia y revisando los cuatro puntos clave: datos de acceso, servidor, archivos y permisos.

Mi consejo es que vayas paso a paso, sin saltarte ninguno. Y sobre todo, nunca olvides hacer una copia de seguridad de tu wp-config.php antes de editarlo. Es un archivo pequeño, pero es la llave maestra de tu web.

Espero que esta guía te haya sido de ayuda y que tu web vuelva a estar operativa en unos minutos. Si tienes alguna otra duda, ya sabes dónde encontrarme. ¡Buena suerte!