Error de Conexión con la Base de Datos en WordPress

Que significa este error

El mensaje “Error establishing a database connection” indica que WordPress no puede comunicarse con la base de datos MySQL o MariaDB.

Los archivos de la web pueden seguir presentes, pero WordPress necesita la base de datos para obtener entradas, paginas, usuarios y ajustes. Cuando la conexion falla, la web y el area de administracion pueden quedar inaccesibles.

Antes de modificar archivos o tablas, crea una copia de seguridad siempre que sea posible (ver backup y restauracion de WordPress).

Por que ocurre

Las causas mas habituales son: un nombre de base de datos, usuario o contrasena incorrectos; un DB_HOST equivocado; un usuario sin permisos sobre la base de datos; una base de datos eliminada, renombrada o movida; el servicio MySQL detenido o saturado; tablas danadas; el servidor sin espacio disponible; una restauracion o migracion incompleta; o un cambio reciente en wp-config.php.

Paso 1: comprobar si el error afecta a toda la web

Prueba https://tudominio.com y https://tudominio.com/wp-admin. Si el mismo error aparece en ambas, lo mas probable es un problema de conexion, credenciales o del servicio MySQL. Si la web publica muestra el error pero /wp-admin indica que la base de datos debe repararse, puede existir alguna tabla danada.

Tambien conviene comprobar si otras aplicaciones que usan bases de datos en la misma cuenta estan fallando; si fallan todas, el problema puede estar en el servicio de base de datos.

Paso 2: revisar las credenciales en wp-config.php

Abre wp-config.php, en la carpeta principal de WordPress, y localiza:

define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contrasena_base_datos' );
define( 'DB_HOST', 'localhost' );

Comprueba que no haya espacios anadidos dentro de las comillas, que las mayusculas y minusculas sean correctas, que el nombre incluya el prefijo asignado por el panel y que DB_HOST coincida con el valor indicado por el hosting. En muchos alojamientos DB_HOST es localhost, pero no debe darse por hecho.

No envies el archivo completo por correo o chat: contiene la contrasena de la base de datos y otras claves sensibles.

Paso 3: verificar que la base de datos y el usuario existan

Accede a la gestion de MySQL desde DirectAdmin o cPanel.

En DirectAdmin: abre Gestion de MySQL, comprueba que la base de datos indicada en DB_NAME aparezca en la lista y revisa que usuario esta asociado.

En cPanel: abre Bases de datos MySQL, comprueba la base de datos y el usuario, y revisa que el usuario este anadido a esa base con los privilegios necesarios.

Los nombres visibles pueden incorporar el prefijo de la cuenta (por ejemplo cuenta_basedatos); debes utilizar el nombre completo.

Paso 4: restablecer la contrasena del usuario MySQL

Si no puedes confirmar la contrasena actual, cambiala desde el panel usando una contrasena larga y unica, actualiza DB_PASSWORD en wp-config.php, guarda el archivo y prueba la web. Asegurate de modificar el usuario correcto: una misma cuenta puede tener varias bases de datos y usuarios.

Paso 5: revisar los privilegios

El usuario debe tener permisos suficientes sobre la base de datos de WordPress. En cPanel normalmente puedes quitar el usuario de la base y volver a anadirlo seleccionando Todos los privilegios. En DirectAdmin, revisa la relacion entre usuario y base de datos desde la seccion de MySQL. No concedas permisos globales a usuarios que no los necesiten.

Paso 6: probar la conexion con phpMyAdmin

Abre phpMyAdmin, selecciona la base de datos y comprueba si se muestran las tablas de WordPress, como wp_options, wp_posts y wp_users (el prefijo puede ser distinto de wp_). Si phpMyAdmin no abre o muestra un error del servidor, puede existir una incidencia en MySQL o MariaDB que requiera revision tecnica.

Paso 7: comprobar el prefijo de las tablas

En wp-config.php encontraras una linea como $table_prefix = 'wp_';. Comprueba que coincida con el prefijo real de las tablas. Un prefijo incorrecto no siempre muestra exactamente el error de conexion; tambien puede provocar que WordPress parezca una instalacion nueva o que falten datos.

Paso 8: reparar tablas danadas

Si WordPress puede conectar pero detecta tablas danadas, anade temporalmente en wp-config.php:

define( 'WP_ALLOW_REPAIR', true );

Despues abre https://tudominio.com/wp-admin/maint/repair.php y selecciona Reparar base de datos. Esta pagina no requiere iniciar sesion mientras la constante esta activa, asi que elimina la linea de wp-config.php en cuanto termines.

Paso 9: comprobar espacio y limites de la cuenta

Si el servidor o la cuenta se quedan sin espacio, MySQL puede no escribir datos temporales y WordPress puede fallar. Revisa el uso de disco, la cuota de la cuenta, el tamano de la base de datos, los registros y las copias de seguridad acumuladas.

Paso 10: revisar una migracion o restauracion reciente

Despues de mover la web, confirma que importaste la base de datos correcta, que wp-config.php contiene las credenciales del servidor nuevo, que el usuario esta asociado a la base de datos, que la importacion termino sin errores y que el prefijo de tablas es correcto. Consulta migrar WordPress de hosting si el error aparecio tras un traslado.

Paso 11: descartar una incidencia del servidor MySQL

Si las credenciales son correctas y phpMyAdmin tampoco conecta, el servicio MySQL o MariaDB podria estar detenido, reiniciandose o saturado. Contacta con soporte indicando el dominio afectado, el nombre de la base de datos (sin la contrasena), la hora aproximada de inicio, el mensaje exacto y si phpMyAdmin funciona.

Que no conviene hacer

No reemplaces WordPress completo sin diagnosticar primero, no elimines la base de datos ni crees otra con el mismo nombre sin una copia, no publiques wp-config.php, no cambies DB_HOST al azar y no restaures una copia antigua sin valorar los contenidos recientes que podrias perder.

Preguntas frecuentes

Este error significa que la base de datos se ha borrado?

No. Con frecuencia se debe a una contrasena incorrecta, falta de permisos o una caida temporal del servicio.

Por que aparecio despues de cambiar la contrasena de MySQL?

Porque WordPress sigue intentando conectarse con el valor antiguo guardado en wp-config.php. Actualiza DB_PASSWORD.

Puedo crear un usuario nuevo para recuperar la web?

Si, siempre que lo asocies a la base de datos y actualices DB_USER y DB_PASSWORD en wp-config.php.

El error puede deberse a demasiadas visitas?

Si. Una sobrecarga puede agotar conexiones o recursos del servidor. En ese caso conviene revisar consultas lentas, cache, plugins y capacidad del plan.

Conclusion

El error de conexion con la base de datos de WordPress suele resolverse revisando las cuatro constantes de wp-config.php, la existencia de la base de datos, el usuario y sus privilegios.

Si todos los datos son correctos y tampoco puedes acceder mediante phpMyAdmin, es probable que el servicio de base de datos necesite una revision tecnica. Facilita a soporte el mensaje exacto y las comprobaciones realizadas, pero nunca envies contrasenas en texto abierto.