Error establishing a database connection: Guía definitiva para solucionarlo. Imprimir

Si al intentar entrar a tu sitio web te encuentras con una pantalla en blanco y un texto gigante que dice "Error establishing a database connection" (Error estableciendo una conexión con la base de datos), respira profundo.

Aunque parece catastrófico, tus datos, tus artículos y tus diseños siguen ahí, a salvo.

Imagina que tu sitio web es una tienda y tu base de datos es el almacén donde guardas todos los productos. Este error simplemente significa que el empleado de la tienda ha perdido las llaves del almacén y no puede entrar a buscar lo que el cliente le pide.

En el 90% de los casos, este problema se resuelve en un par de minutos corrigiendo un error tipográfico. A continuación, te explicamos cómo revisar las "llaves" de tu base de datos y solucionar el problema.

Causa 1: Credenciales incorrectas (El culpable más común)

Para que tu sitio web (por ejemplo, WordPress) pueda conectarse a la base de datos, necesita cuatro datos exactos. Si cambiaste tu contraseña de cPanel recientemente, migraste tu sitio o modificaste algún usuario, es probable que estas credenciales ya no coincidan.

Paso A: Revisa el archivo de configuración de tu web.

1. Ingresa a tu cPanel y ve al Administrador de Archivos.

2. Entra a la carpeta de tu sitio web (generalmente tu directorio public_html).

3. Busca el archivo de configuración. Si usas WordPress, se llama wp-config.php.

4. Haz clic derecho sobre él y selecciona View (Ver) o Edit (Editar).

5. Busca las siguientes líneas de código:

define( 'DB_NAME', 'usuario_basededatos' );
define( 'DB_USER', 'usuario_usuariodb' );
define( 'DB_PASSWORD', 'TuContraseñaSegura123' );
define( 'DB_HOST', 'localhost' );

Mantén esta pestaña abierta, necesitarás comparar estos datos con los de cPanel.

Paso B: Verifica los datos en cPanel

1. Abre una nueva pestaña, ve a tu cPanel y entra a Bases de datos MySQL.

2. Verifica el nombre de la BD: Desplázate hasta "Bases de datos actuales". Asegúrate de que el nombre exacto de la base de datos coincida letra por letra con el DB_NAME de tu archivo (incluyendo el prefijo de tu usuario de cPanel, ej. miusuario_wp1).

3. Verifica el usuario: En esa misma fila, mira la columna "Usuarios privilegiados". ¿Aparece el usuario que está en tu DB_USER? Si no está, el sitio no conectará.

4. Verifica la contraseña: Las contraseñas de las bases de datos no se pueden ver por seguridad. Si no estás 100% seguro de que la contraseña del archivo wp-config.php es correcta, lo mejor es restablecerla.

   • Desplázate abajo hasta Usuarios actuales, busca a tu usuario, haz clic en Cambiar contraseña, crea una nueva y luego actualízala en tu archivo wp-config.php.

Causa 2: Olvidaste asignar los privilegios (Típico en migraciones)

Un error súper común al crear una base de datos manualmente en cPanel es crear la base de datos, crear el usuario, pero olvidar presentarlos entre sí. Si el usuario existe pero no tiene permiso para leer la base de datos, obtendrás el error de conexión.

1. En tu cPanel, entra a Bases de datos MySQL.

2. Desplázate casi hasta el final, a la sección Añadir usuario a la base de datos.

3. En el primer menú desplegable, selecciona tu Usuario (DB_USER).

4. En el segundo menú, selecciona tu Base de datos (DB_NAME).

5. Haz clic en Añadir.

6. En la siguiente pantalla, marca la casilla TODOS LOS PRIVILEGIOS (All Privileges) y haz clic en Hacer cambios.

Causa 3: El Host de la base de datos es incorrecto

En el 99% de las cuentas de hosting compartido y servidores con cPanel, la base de datos y los archivos del sitio web viven en la misma máquina. Por lo tanto, el parámetro host debe ser el sistema local.

• Revisa tu archivo wp-config.php. La línea del host debería verse exactamente así: define( 'DB_HOST', 'localhost' );

• Si en su lugar ves una dirección IP extraña o un enlace externo (algo común si migraste desde ciertos proveedores de hosting especializados que separan sus servidores), cámbialo a localhost y guarda el archivo.

Causa 4: Base de datos corrupta o servidor saturado.

Si ya comprobaste que los nombres, usuarios, contraseñas y privilegios están absolutamente correctos dentro de tu directorio public_html y el error persiste, el problema podría estar en el estado de la base de datos:

• Tablas corruptas: A veces tu sitio conecta, pero una tabla clave está dañada. En WordPress, esto suele mostrarse como un error de conexión parcial o te pide "reinstalar" el sitio.

• Límite de conexiones: Si tu sitio está recibiendo muchísimo tráfico de golpe, podrías estar chocando con el límite de conexiones simultáneas. Te recomendamos leer nuestro artículo sobre.

¿Revisaste todo y tu web sigue sin conectar? No pierdas más tiempo buscando el error tipográfico invisible. Abre un ticket de soporte técnico, indícanos el dominio afectado y nuestro equipo revisará tus credenciales de conexión y los registros del servidor en cuestión de minutos para volver a poner tu sitio en línea.