Cómo solucionar el error de conexión con la base de datos en WordPress

solucionar error de conexión con base de datos en WordPress paso a paso

Cómo solucionar el error de conexión con la base de datos en WordPress

«Error al establecer una conexión con la base de datos.» Este mensaje aparece cuando WordPress no puede conectarse a MySQL y deja la web completamente en blanco. Aunque parece grave, las causas son bastante concretas y en la mayoría de casos se resuelve en minutos siguiendo las causas en orden.

Causa 1: credenciales incorrectas en wp-config.php

La causa más frecuente después de una migración o cambio de hosting. El wp-config.php tiene las credenciales de conexión a la base de datos: nombre de la base de datos, usuario, contraseña y host. Si alguna no coincide con la base de datos real del servidor, WordPress no puede conectarse.

Abre el wp-config.php con FTP o el administrador de archivos de cPanel y verifica estas cuatro líneas:

define('DB_NAME', 'nombre_de_la_base_de_datos');
define('DB_USER', 'usuario_de_mysql');
define('DB_PASSWORD', 'contraseña_de_mysql');
define('DB_HOST', 'localhost');

En cPanel, las bases de datos MySQL están en la sección «Bases de datos MySQL». Verifica que la base de datos existe, que el usuario existe, que el usuario tiene permisos asignados y que la contraseña es correcta. El valor de DB_HOST es casi siempre «localhost» en hosting compartido, pero en algunos proveedores puede ser una dirección IP o un hostname diferente.

Causa 2: el servidor MySQL está caído

Si las credenciales son correctas y el error persiste, puede que el servidor MySQL esté caído temporalmente por sobrecarga, mantenimiento o un problema del servidor. Para verificarlo: intenta acceder a phpMyAdmin desde cPanel. Si phpMyAdmin tampoco carga o muestra error de conexión, el problema está en el servidor MySQL, no en tu instalación.

En ese caso la solución está en manos del proveedor de hosting. Abre un ticket indicando que MySQL no responde y comprueba si hay incidencias activas reportadas en el panel de estado.

Causa 3: la base de datos está corrupta

Una base de datos corrupta puede impedir la conexión o causar errores intermitentes. Ocurre después de una caída del servidor sin cierre correcto de MySQL o de una interrupción durante una operación de escritura.

Para reparar desde phpMyAdmin: selecciona la base de datos, ve a la pestaña «SQL» y ejecuta:

REPAIR TABLE wp_options, wp_posts, wp_postmeta, wp_users, wp_usermeta;

WordPress también tiene una herramienta de reparación integrada. Añade esta línea al wp-config.php:

define('WP_ALLOW_REPAIR', true);

Luego accede a tudominio.com/wp-admin/maint/repair.php. Después de la reparación, elimina esa línea del wp-config.php.

Causa 4: el servidor ha superado el límite de conexiones

MySQL tiene un límite configurable de conexiones simultáneas. En hosting compartido con muchos sitios en el mismo servidor, ese límite puede alcanzarse en picos de tráfico. El error de WordPress es el mismo que con credenciales incorrectas, pero la causa es diferente.

Si el error aparece solo en picos de tráfico y desaparece después, probablemente es un problema de conexiones simultáneas. Si el error es constante, las causas 1, 2 o 3 son más probables.

A corto plazo, activar la caché de WordPress reduce drásticamente el número de conexiones a la base de datos porque las páginas cacheadas no necesitan hacer consultas SQL.

Diagnosticar con WordPress en modo debug

Con el modo debug activo, WordPress muestra mensajes de error más específicos. Añade al wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Los errores se guardan en wp-content/debug.log. Después de diagnosticar, desactiva el modo debug cambiando los valores a false.

Hosting Web SSD ultrarrápido e ilimitado

Hosting Web SSD NVMe, 100% Ecológico y sostenible, máxima velocidad y tráfico ilimitado en tu Hosting Web, con certificado SSL gratuito 

Hosting Web logo

Hosting Web ecológico, profesional e ilimitado en España,  somos especialistas en servicios de Hosting SSD, con más de 22 años de experiencia y un equipo de profesionales altamente cualificados a su disposición las 24 Horas.