Solucionar 'Error establishing a database connection' en WordPress (cPanel)

¡Hola! Si estás leyendo esto, seguramente te has encontrado con uno de los errores más temidos y, a la vez, más comunes en el mundo de WordPress: "Error establishing a database connection" (Error al establecer la conexión con la base de datos).

No te preocupes, respira hondo. No has perdido tu sitio web ni tu contenido. Este mensaje significa que WordPress no puede "hablar" con tu base de datos, que es donde se guardan todas tus publicaciones, páginas y configuraciones. Es como si intentaras abrir una tienda, pero la llave no encaja en la cerradura de la puerta del almacén.

En esta guía extensa y paso a paso, vamos a arreglar este error usando cPanel, que es el panel de control más común que ofrecen los proveedores de hosting. Vamos a ir desde las soluciones más simples hasta las más técnicas. No necesitas ser un experto, solo seguir las instrucciones con calma.

Vamos a ello.

¿Por qué aparece el error "Error establishing a database connection"?

Antes de lanzarnos a arreglar nada, es útil entender qué está pasando. Este error de base de datos WordPress aparece por varias razones, pero las más frecuentes son:

Credenciales incorrectas: El archivo de configuración de WordPress (wp-config.php) tiene el nombre de usuario, la contraseña o el nombre de la base de datos mal escritos.
Base de datos corrupta: La base de datos ha sufrido un daño lógico y no responde correctamente.
Servidor de base de datos caído o sobrecargado: El servidor MySQL (donde vive la base de datos) está apagado, reiniciándose o colapsado por un exceso de tráfico.
Problemas con el proveedor de hosting: A veces el problema es de tu empresa de hosting y no de tu sitio web.
Archivos corruptos: Algún archivo de WordPress se ha dañado o ha sido modificado accidentalmente.

Vamos a solucionarlo de forma metódica. Empieza siempre por el paso 1.

Solución Paso a Paso para solucionar WordPress en cPanel

Paso 1: Verifica el estado de tu proveedor de hosting (y reinicia)

A veces la solución es la más simple: el servidor de tu hosting está haciendo una pausa para tomar café.

Revisa el correo electrónico: ¿Recibiste algún correo de tu proveedor de hosting sobre mantenimiento o incidentes?
Visita el sitio web de tu proveedor: Muchas empresas tienen una página de estado del servicio (status page) donde anuncian caídas o problemas.
Reinicia tu router: A veces el problema es tu conexión a internet, no el servidor. Apaga y enciende tu router.
Espera unos minutos: Si el servidor está sobrecargado, puede que se recupere solo en unos minutos.

[TIP] Si el error aparece justo después de haber hecho muchos cambios en tu sitio (instalar plugins, cambiar temas), puede que el servidor se haya reiniciado por un pico de uso. Dale 5 minutos y recarga la página.

Si después de esto el error persiste, vamos a los archivos.

Paso 2: Accede a cPanel y revisa el estado de MySQL

Necesitamos entrar al panel de control de tu hosting. Normalmente se accede a través de tudominio.com/cpanel o tudominio.com:2083.

Inicia sesión con las credenciales que te dio tu proveedor (normalmente son las mismas que para el FTP).
Busca la sección "Bases de Datos" o "Databases".
Dentro, busca el icono de "MySQL Databases" o "Remote MySQL".
En la lista de bases de datos, verás el estado. No te asustes si no ves ningún botón de "iniciar". Lo que buscamos es ver si la base de datos existe. Si no la ves en la lista, el problema es que se ha borrado (poco probable, pero posible).

[WARNING] No toques nada que no entiendas. Solo estamos observando por ahora.

Si tu base de datos aparece en la lista, el problema no es que falte, sino que WordPress no puede conectarse. Vamos al siguiente paso.

Paso 3: Repara y optimiza la base de datos (La solución mágica)

cPanel tiene una herramienta integrada para reparar bases de datos. Es como un "botón de reinicio" para la base de datos.

De nuevo en cPanel, en la sección "Bases de Datos", busca "MySQL Databases".
En la lista de bases de datos, verás una casilla o un enlace que dice "Check" o "Repair". Si es un enlace, haz clic en él.
Si es una casilla, márcala y haz clic en el botón "Repair Database" o "Repair" que aparecerá en la parte inferior de la lista.

Este proceso puede tardar unos segundos. Una vez terminado, intenta acceder a tu sitio web.

[INFO] Esta herramienta es segura y no borra datos. Simplemente intenta arreglar las tablas dañadas de la base de datos.

Si el error persiste, pasamos a la causa más común: las credenciales.

Paso 4: Revisa el archivo `wp-config.php` (La causa más común)

WordPress guarda la "receta" para conectarse a la base de datos en un archivo llamado wp-config.php. Si esta receta está mal, la conexión falla.

Necesitas acceder a los archivos de tu hosting. Tienes dos opciones:

Opción A: Usando el Administrador de Archivos de cPanel (La más fácil)

En cPanel, busca la sección "Archivos" y haz clic en "Administrador de Archivos" (File Manager).
Busca la carpeta public_html (o htdocs). Ahí es donde vive tu WordPress.
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit".
Se abrirá un editor de texto. Busca las líneas que dicen:

// ** Configuración de la base de datos ** //
define( 'DB_NAME', 'tu_usuario_wp_nombrebasededatos' );
define( 'DB_USER', 'tu_usuario_wp_usuariodb' );
define( 'DB_PASSWORD', 'tu_contraseña_db' );
define( 'DB_HOST', 'localhost' );

Opción B: Usando FTP (FileZilla)

Conecta con tu cliente FTP (como FileZilla) usando los datos de tu hosting.
Navega a public_html y descarga el archivo wp-config.php a tu ordenador.
Ábrelo con el Bloc de notas o cualquier editor de texto (como Sublime Text).

Ahora, ¿qué buscamos?

Verifica el nombre de la base de datos (DB_NAME): En cPanel, los nombres de usuario y base de datos suelen tener un prefijo. Por ejemplo, si tu usuario de cPanel es usuario1, la base de datos se llamará usuario1_wordpress. Asegúrate de que el nombre en el archivo coincide EXACTAMENTE con el que ves en cPanel.
Verifica el usuario (DB_USER): Igual que arriba, el usuario será algo como usuario1_wpuser. Verifica que coincide.
Verifica la contraseña (DB_PASSWORD): Este es el error más común. Si cambiaste la contraseña de la base de datos en cPanel, la que está en este archivo será la vieja y no funcionará.
Verifica el servidor (DB_HOST): Normalmente es localhost. Pero algunos proveedores usan algo como mysql.tudominio.com o localhost:/var/run/mysqld/mysqld.sock. Si no estás seguro, déjalo como localhost.

[TIP] Te recomiendo que no modifiques la contraseña directamente en el archivo. En su lugar, cambia la contraseña dentro de cPanel para el usuario de la base de datos y luego copia esa nueva contraseña al archivo wp-config.php.

Para cambiar la contraseña en cPanel:

Ve a "MySQL Databases".
Desplázate hasta la sección "Usuarios en la base de datos" (Users in the database).
Busca el usuario que usas para WordPress y haz clic en "Cambiar contraseña" (Change Password).
Introduce una nueva contraseña segura y cópiala.
Pega esa contraseña en el archivo wp-config.php en la línea DB_PASSWORD.

Una vez que hayas corregido el archivo, guárdalo. Si lo editaste con FileZilla, súbelo de nuevo al servidor, sobrescribiendo el antiguo.

Paso 5: Repara la base de datos usando wp-admin (Si puedes)

A veces, el error aparece solo en la parte pública del sitio, pero el panel de administración (wp-admin) funciona. Si puedes acceder a tudominio.com/wp-admin, WordPress tiene una herramienta de reparación integrada.

Añade esta línea a tu archivo wp-config.php, justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y sube los cambios si es necesario.
Ve a tudominio.com/wp-admin/maint/repair.php
Verás una página con dos botones: "Repair Database" y "Repair and Optimize Database". Haz clic en el primero.
Espera a que termine. Te mostrará un mensaje de éxito o error.
IMPORTANTE: Después de la reparación, ELIMINA la línea define('WP_ALLOW_REPAIR', true); de tu archivo wp-config.php y guárdalo de nuevo. Dejarlo activo es un riesgo de seguridad.

Paso 6: Revisa si el problema es un plugin o tema (Si el error es intermitente)

Si el error aparece y desaparece, el culpable podría ser un plugin o un tema que está haciendo demasiadas consultas a la base de datos y saturando el servidor.

Para solucionarlo, necesitas desactivar todos los plugins:

Ve a cPanel > Administrador de Archivos > public_html > wp-content.
Verás una carpeta llamada plugins. Haz clic derecho sobre ella y selecciona "Renombrar".
Cámbiale el nombre a algo como plugins_desactivados. (Esto desactiva todos los plugins a la vez).
Intenta acceder a tu sitio web.

Si el sitio funciona ahora, el problema es uno de tus plugins. Para encontrar cuál:

Renombra la carpeta de nuevo a plugins.
Ve a wp-admin > "Plugins".
Actívalos uno por uno, recargando tu sitio después de cada activación. Cuando el error vuelva a aparecer, habrás encontrado al culpable. Elimínalo o busca una alternativa.

[WARNING] Si renombras la carpeta de plugins, perderás las activaciones de todos ellos, pero no los datos. Tendrás que reactivarlos uno a uno después.

Paso 7: Verifica los archivos del núcleo de WordPress

A veces, un archivo del núcleo de WordPress se daña. La forma más segura de arreglarlo es reinstalar WordPress sin borrar tu contenido.

Esto es más fácil de lo que parece:

Descarga la versión más reciente de WordPress desde es.wordpress.org (en tu idioma).
Descomprime el archivo en tu ordenador.
Sube TODOS los archivos y carpetas (excepto wp-content y wp-config.php) a tu servidor, sobrescribiendo los existentes. Puedes usar el Administrador de Archivos de cPanel o FTP.
Sube también el archivo .htaccess si lo tienes (aunque no es crítico).
Esto reemplazará los archivos dañados del núcleo sin tocar tus publicaciones, medios o configuraciones.

Paso 8: Contacta con tu proveedor de hosting

Si has llegado hasta aquí y el error "Error establishing a database connection" persiste, es muy probable que el problema esté en el servidor de tu proveedor de hosting.

Contacta con su soporte técnico. Diles que has seguido todos los pasos de solución de problemas (revisar credenciales, reparar base de datos, desactivar plugins) y que el problema continúa. Ellos podrán verificar los logs del servidor y el estado de MySQL. Es posible que el servicio MySQL esté caído o que tu cuenta esté siendo limitada por uso de recursos.

Preguntas Frecuentes (FAQ)

¿Perderé mis datos si reparo la base de datos?

No. La herramienta de reparación de cPanel y la de WordPress solo intentan arreglar la estructura de las tablas. No borran publicaciones, páginas ni comentarios.

¿Qué es DB_HOST y por qué a veces no es localhost?

DB_HOST es la dirección del servidor donde se encuentra la base de datos. En la mayoría de los hostings compartidos es localhost. Pero en configuraciones más avanzadas, o en algunos proveedores específicos, puede ser una dirección IP o un nombre de servidor. Si tu proveedor no te ha dado uno específico, déjalo como localhost.

¿Puedo cambiar la contraseña de la base de datos desde cPanel sin romper mi sitio?

Sí, pero debes actualizar la contraseña en el archivo wp-config.php inmediatamente después. Si no lo haces, WordPress usará la contraseña vieja y dará el error de conexión.

¿Qué es Syspanel?

[INFO] Syspanel es el nombre que le damos al panel de control alternativo (comúnmente conocido como HestiaCP). Si tu hosting usa Syspanel, el acceso a la gestión de archivos y bases de datos se realiza a través del puerto 2106 (ej. tudominio.com:2106). Los pasos para arreglar el error son los mismos, pero la interfaz será diferente a la de cPanel. Busca las secciones de "Bases de Datos" o "MySQL" dentro de Syspanel.

¿El error puede ser por un ataque de hackers?

Es posible, pero no es lo más común. Si sospechas de un ataque, revisa si hay usuarios extraños en tu base de datos o si tu archivo wp-config.php ha sido modificado. Si la reparación y la verificación de credenciales no funcionan, contacta con tu proveedor para que revisen los logs de seguridad.

Resumen y Consejo Final

Hemos recorrido un largo camino. Para solucionar el error base de datos WordPress, el orden de acción recomendado es:

Reinicia todo (router y servidor).
Repara la base de datos desde cPanel.
Verifica las credenciales en wp-config.php.
Desactiva los plugins.
Reinstala el núcleo de WordPress.
Contacta con tu soporte.

[TIP] Si no te sientes cómodo editando archivos, empieza siempre por el paso de reparación en cPanel y la verificación de credenciales. Es ahí donde está la solución en el 80% de los casos.

Respira, tómate tu tiempo y sigue los pasos con calma. Este error, aunque parezca grave, es uno de los más fáciles de resolver en WordPress. ¡Mucha suerte!