«Error al establecer una conexión con la base de datos»: qué significa y cómo arreglarlo

Tu sitio muestra solo una frase en grande: «Error al establecer una conexión con la base de datos». Ni portada ni panel. Parece el fin del mundo, pero es un error muy concreto: WordPress no logra conversar con la base de datos donde guarda todo tu contenido.

Imagina que WordPress es una persona que tiene que llamar por teléfono a la base de datos. Este error significa que la llamada no se pudo hacer: o marcó mal el número, o la clave estaba equivocada, o al otro lado nadie contesta. Revisemos cada posibilidad.

Antes de tocar nada: ¿es solo tu sitio?

• Si tienes otros sitios en el mismo hosting, ábrelos. Si todos fallan, lo más probable es que el servidor de bases de datos esté caído. Eso lo arregla tu proveedor: escríbele al soporte y espera.
• Si el error aparece y desaparece solo, sobre todo en horas de mucha visita, puede ser que el servidor esté sobrecargado. Más abajo hablamos de eso.
• Si falla siempre y solo tu sitio, sigue leyendo.

Paso 1. Pregúntate qué cambió

¿Migraste el sitio?, ¿cambiaste la contraseña de algo en cPanel?, ¿restauraste un respaldo? Estas son las causas más comunes y casi siempre llevan al paso 2.

Paso 2. Revisa los datos de conexión en wp-config.php

WordPress guarda los «datos para llamar» en el archivo wp-config.php.

1. En cPanel, abre el Administrador de archivos y entra a public_html (o la carpeta de tu sitio).
2. Haz clic derecho en wp-config.php → Descargar, para tener una copia de seguridad.
3. Haz clic derecho otra vez → Ver o Editar. Busca estas cuatro líneas:

define( 'DB_NAME', 'usuario_wp123' );
define( 'DB_USER', 'usuario_wpuser' );
define( 'DB_PASSWORD', 'la-contraseña' );
define( 'DB_HOST', 'localhost' );

Ahora compáralas con lo que realmente existe:

4. En cPanel, abre Bases de datos MySQL (o MySQL Databases).
5. En Bases de datos actuales, verifica que exista una con el nombre exacto de DB_NAME. En cPanel, los nombres siempre empiezan con tu usuario de cPanel y un guion bajo.
6. En la misma fila, en la columna Usuarios con privilegios, verifica que aparezca el usuario de DB_USER.

En la gran mayoría de los hostings con cPanel, DB_HOST es localhost. Si tu proveedor usa un servidor de base de datos separado, te lo habrá indicado; en ese caso, revisa su documentación.

Paso 3. Restablece la contraseña del usuario de la base de datos

No puedes «ver» la contraseña actual de un usuario de base de datos, pero sí cambiarla. Así te aseguras de que coincida con la de wp-config.php:

1. En Bases de datos MySQL, baja hasta Usuarios actuales.
2. Junto al usuario de DB_USER, haz clic en Cambiar contraseña.
3. Usa el generador para crear una contraseña segura, cópiala y guárdala.
4. Edita wp-config.php y pégala en DB_PASSWORD, entre las comillas simples. Guarda.

Si la contraseña contiene una comilla simple ('), WordPress la leerá mal. Genera otra sin ese carácter.

Paso 4. Verifica que el usuario tenga permisos

Si en el paso 2 el usuario no aparecía asociado a la base de datos:

1. En Bases de datos MySQL, baja hasta Agregar usuario a la base de datos.
2. Elige el usuario y la base de datos correctos y pulsa Agregar.
3. En la pantalla siguiente marca Todos los privilegios y guarda.

Recarga tu sitio. En la mayoría de los casos, con los pasos 2 a 4 el sitio vuelve.

Paso 5. ¿La base de datos tiene tablas?

Si migraste o restauraste un respaldo, puede que la base de datos exista pero esté vacía.

1. En cPanel abre phpMyAdmin y haz clic en el nombre de tu base de datos, en la columna izquierda.
2. Deberías ver tablas como wp_posts, wp_options o wp_users (el prefijo wp_ puede ser otro).
3. Si no hay tablas, falta importar el respaldo de la base de datos.
4. Si hay tablas, revisa que el prefijo coincida con la línea $table_prefix de wp-config.php.

Paso 6. Si el error aparece y desaparece

Suele ser el servidor de bases de datos saturado: demasiadas visitas, un plugin que hace consultas muy pesadas o un ataque de bots. Qué hacer:

• Instala o revisa tu plugin de caché, para que menos visitas necesiten consultar la base de datos.
• Pregunta a tu proveedor si tu cuenta está llegando a su límite de conexiones o recursos.
• Si tu sitio muestra el aviso «Una o más tablas necesitan reparación», WordPress tiene una herramienta: agrega temporalmente define( 'WP_ALLOW_REPAIR', true ); en wp-config.php, visita tudominio.cl/wp-admin/maint/repair.php, repara y quita la línea al terminar (esa página no pide contraseña).

¿Revisaste todo y sigue igual? Cuéntanos en el foro qué pasos hiciste y qué viste en cada uno. Nunca publiques tu contraseña de base de datos: con los nombres (sin claves) basta para ayudarte.