Error al establecer una conexión con la base de datos: cómo solucionarlo

El mensaje «Error al establecer una conexión con la base de datos» aparece cuando WordPress no logra conectarse a la base de datos donde guarda todo el contenido. Casi siempre se debe a datos incorrectos en el archivo wp-config.php; con menos frecuencia, a un servidor de base de datos caído o a tablas dañadas. Tu contenido normalmente sigue intacto.

Por qué ocurre

WordPress guarda las entradas, páginas, usuarios y ajustes en una base de datos MySQL o MariaDB. Cada vez que alguien visita el sitio, WordPress se conecta a ella usando los datos que están en wp-config.php. Si alguno de esos datos no coincide con la realidad, o si el servidor de base de datos no responde, no puede mostrar nada y muestra este error.

Las situaciones típicas en que aparece son:

• Acabas de migrar el sitio a otro hosting y los datos de la base de datos cambiaron.
• Cambiaste la contraseña del usuario de la base de datos en el panel, pero no en wp-config.php.
• El servidor de base de datos está caído o saturado, por ejemplo durante un pico de tráfico.
• Alguna tabla se dañó, algo poco común pero posible tras un corte durante una escritura.

Cómo solucionarlo paso a paso

1. Abre wp-config.php y anota los datos

   En la carpeta principal del sitio, abre wp-config.php y busca las líneas con DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. No cambies nada todavía.

2. Compáralos con tu panel de hosting

   En la sección de bases de datos de tu panel, confirma que existe una base de datos con ese nombre exacto y un usuario con ese nombre exacto asignado a ella, con todos los privilegios. Muchos hostings agregan un prefijo con tu usuario, por ejemplo cuenta_wp.

3. Prueba el usuario y la contraseña

   Si tienes dudas sobre la contraseña, cámbiala en el panel y escribe la nueva en DB_PASSWORD. Luego entra a phpMyAdmin: si puedes ver las tablas de la base de datos, los datos de conexión son válidos.

4. Revisa DB_HOST

   En la mayoría de los hostings compartidos el valor correcto es localhost. Si tu proveedor usa un servidor de base de datos aparte, el dato exacto aparece en el panel o en su documentación.

5. Repara la base de datos si hace falta

   Si el escritorio dice que una o más tablas no están disponibles, agrega temporalmente define( 'WP_ALLOW_REPAIR', true ); en wp-config.php, visita /wp-admin/maint/repair.php y, al terminar, borra esa línea.

Así se ven los datos en wp-config.php

Este es el bloque que debes revisar. Los valores son de ejemplo: los tuyos aparecen en la sección de bases de datos de tu panel de hosting.

define( 'DB_NAME', 'cuenta_wp' );
define( 'DB_USER', 'cuenta_usuario' );
define( 'DB_PASSWORD', 'tu-contraseña' );
define( 'DB_HOST', 'localhost' );

Ojo con los detalles que más fallan: mayúsculas y minúsculas, espacios al copiar y pegar, comillas que se borraron y caracteres especiales en la contraseña. Si la contraseña contiene una comilla simple, lo más simple es cambiarla por otra que no la tenga.

Cómo saber si el problema es el servidor

Si las credenciales están bien y phpMyAdmin tampoco logra conectarse, o muestra un error del servidor, el problema no está en WordPress. Otras señales de que la causa es del servidor:

• Otros sitios de la misma cuenta también muestran el error.
• El error aparece y desaparece en pocos minutos.
• El panel de tu hosting informa un mantenimiento o un incidente.

En esos casos, contacta al soporte de tu hosting: el estado del servidor de base de datos solo lo pueden revisar ellos.

Guía revisada con WordPress 7.1.