Error al establecer una conexión con la base de datos en WordPress

Lo que dice el mensaje

En cada página que muestra, WordPress abre una conexión con su base de datos MySQL o MariaDB usando cuatro datos escritos en wp-config.php, en la raíz del sitio:

define( 'DB_NAME', 'nombre_de_la_base' );
define( 'DB_USER', 'usuario' );
define( 'DB_PASSWORD', 'contraseña' );
define( 'DB_HOST', 'localhost' );

«Error al establecer una conexión con la base de datos» significa que esa conexión ha fallado. Cuatro causas lo producen: unas credenciales que ya no coinciden, un servidor de base de datos detenido o inalcanzable, un servidor saturado o una base de datos dañada. Las secciones siguientes las recorren de la más sencilla de comprobar a la más rara.

1. ¿Responde el servidor de base de datos?

• La página de estado del proveedor de hosting: allí se anuncia una avería o un mantenimiento del servidor MySQL.
• Los demás sitios de la misma cuenta: si muestran el mismo error a la vez, la causa está en el servidor, y la solución, en manos del proveedor.
• phpMyAdmin, desde el panel del proveedor: si abre la base de datos y muestra sus tablas, el servidor funciona y la base de datos existe.

Si la causa es el servidor, abra un ticket con el proveedor indicando la hora de inicio de la avería y el mensaje exacto. Mientras tanto no hay nada que modificar en el sitio.

2. ¿Son correctas las credenciales de wp-config.php?

Es la causa más frecuente después de una migración del sitio, de un cambio de contraseña de la base de datos en el panel del proveedor o de una restauración. Compare los cuatro valores de wp-config.php con el apartado de bases de datos de su proveedor:

• DB_NAME y DB_USER: muchos proveedores les añaden como prefijo el nombre de la cuenta (cuenta_wordpress). El prefijo forma parte del nombre.
• DB_PASSWORD: en caso de duda, defina una contraseña nueva para el usuario en el panel y cópiela en el archivo.
• DB_HOST: localhost en muchos proveedores, pero no en todos. Algunos dan un nombre de servidor o una dirección, a veces seguida de un puerto (:3306). El valor exacto figura en el panel.
• El usuario debe tener permisos sobre la base de datos: en el panel, compruebe que el usuario está asociado a la base de datos, con todos los privilegios.

Una contraseña que contiene un apóstrofo (') corta la cadena PHP que la rodea en wp-config.php. Póngale delante una barra invertida (\'), o elija una contraseña sin apóstrofo.

Probar las credenciales fuera de WordPress

WordPress muestra un mensaje genérico. MySQL, en cambio, dice exactamente qué falla. Dos formas de consultarlo con los valores de wp-config.php:

En línea de comandos, si tiene acceso SSH

mysql -h localhost -u usuario -p nombre_de_la_base

Con WP-CLI, wp db check lee directamente wp-config.php y comprueba las tablas con esas credenciales.

Con un archivo PHP temporal

Deje este archivo en la raíz del sitio con un nombre difícil de adivinar, ábralo en el navegador y elimínelo inmediatamente: contiene la contraseña de la base de datos.

<?php
mysqli_report(MYSQLI_REPORT_OFF);
$enlace = @mysqli_connect('localhost', 'usuario', 'contraseña', 'nombre_de_la_base');
echo $enlace ? 'Conexión correcta' : 'Error: ' . mysqli_connect_error();

La primera línea importa: desde PHP 8.1, una conexión que falla lanza una excepción por defecto, y la página se quedaría en blanco en lugar de mostrar el mensaje de MySQL.

3. Una base de datos dañada: la herramienta de reparación

Cuando las credenciales son correctas pero hay tablas dañadas, el sitio público muestra el mismo mensaje de error de conexión, y la administración un mensaje más preciso: «Una o más tablas de la base de datos no están disponibles. La base de datos podría necesitar ser reparada». WordPress incluye una herramienta para ello. Añada esta línea en wp-config.php:

define( 'WP_ALLOW_REPAIR', true );

Abra después https://www.su-sitio.com/wp-admin/maint/repair.php y pulse «Reparar base de datos». Retire la línea en cuanto termine la reparación: mientras esté presente, cualquiera puede acceder a esa página, sin iniciar sesión.

Antes de cualquier reparación, exporte la base de datos (wp db export, o la pestaña Exportar de phpMyAdmin). Si la reparación falla, el proveedor puede restaurar la base de datos desde sus copias de seguridad.

4. Un error que aparece y desaparece: la carga

Un error que aparece a ciertas horas y desaparece por sí solo indica un servidor saturado más que un ajuste erróneo. Las causas más habituales:

• Un pico de tráfico, a menudo de robots: intentos de acceso repetidos a wp-login.php o xmlrpc.php, visibles en los registros de acceso del proveedor.
• Los límites del hosting compartido: número de conexiones simultáneas o de procesos limitado por cuenta. El panel del proveedor suele mostrarlos en su apartado de consumo de recursos.
• Un plugin pesado: estadísticas, registros de actividad o tareas programadas que escriben en la base de datos en cada visita.

Las soluciones: bloquear los intentos de acceso abusivos, instalar una caché de páginas, desactivar xmlrpc.php si ninguna aplicación lo usa, y pedir al proveedor los registros del periodo con errores.