Si está mirando el mensaje “Error al establecer una conexión con la base de datos” (en inglés, “Error establishing a database connection”) en su sitio WordPress, esta es la versión corta: WordPress no puede hablar con la base de datos donde vive todo su contenido, así que no tiene nada que mostrar. No necesariamente se perdió nada — sus entradas, páginas y ajustes casi seguro siguen ahí. Simplemente WordPress no puede llegar a ellos en este momento. Esta guía explica por qué pasa y lo guía por los arreglos en orden.
Todo sitio WordPress tiene en realidad dos partes: los archivos (su tema, sus plugins y el propio WordPress) y la base de datos (su contenido real y sus ajustes). Cuando se rompe la conexión entre las dos, aparece este error. Solo hay unas pocas razones por las que se rompe, así que vamos a repasarlas.
Qué causa el error
Los sospechosos habituales, del más al menos común:
- Datos de acceso a la base de datos equivocados en su archivo
wp-config.php(el archivo principal de configuración de WordPress) — muchas veces después de una mudanza o de un cambio de proveedor. - El servidor de base de datos está caído o sobrecargado — algo común en el hosting compartido barato durante los picos de tráfico.
- Una base de datos dañada — normalmente tras una caída, un plugin defectuoso o una actualización interrumpida.
- Un servidor hackeado o al límite que se quedó sin conexiones o sin recursos.
Paso 1: compruebe si es solo la parte visible
Intente entrar en su área de administración en yoursite.com/wp-admin. Puede que vea un mensaje un poco distinto: “Una o más tablas de la base de datos no están disponibles. Puede que haya que reparar la base de datos”. Si ve ese, salte al paso de reparación — WordPress le está diciendo que la propia base de datos está dañada, no que los datos de acceso estén mal. Si tanto la parte visible como la administración muestran el mismo error de conexión genérico, siga en orden.
Paso 2: confirme los datos de acceso a la base de datos
Es el arreglo más común, sobre todo si el error apareció justo después de cambiar de proveedor o de cambiar algo. El archivo wp-config.php de su sitio (en la carpeta principal de WordPress) tiene cuatro líneas que deben coincidir exactamente con lo que le dio su proveedor:
DB_NAME— el nombre de la base de datosDB_USER— el nombre de usuario de la base de datosDB_PASSWORD— la contraseñaDB_HOST— normalmentelocalhost, pero algunos proveedores usan la dirección de un servidor concreto
Abra el archivo por SFTP (una forma segura de conectarse a los archivos de su sitio) o con el administrador de archivos de su proveedor y compare esos cuatro valores con el panel de control de su hosting. Un solo carácter equivocado — una contraseña que se cambió, o un DB_HOST que debería ser otra cosa distinta de localhost — provoca exactamente este error. Corrija cualquier diferencia, guarde y vuelva a cargar su sitio. Nunca pegue estos valores en una ventana de chat, en un correo ni en un foro de soporte; son las llaves de sus datos.
Paso 3: repare la base de datos
Si los datos de acceso son correctos pero vio ese mensaje de “puede que haya que reparar las tablas”, WordPress tiene una herramienta de reparación integrada. Agregue esta línea a wp-config.php, justo encima del comentario “That’s all, stop editing”:
define('WP_ALLOW_REPAIR', true);
Ahora visite yoursite.com/wp-admin/maint/repair.php en su navegador y haga clic en “Reparar base de datos” (o “Reparar y optimizar”). No hace falta iniciar sesión, y justo por eso debe quitar esa línea otra vez en cuanto termine — dejarla es un agujero de seguridad. Si la reparación sale bien, su sitio debería volver enseguida.
Paso 4: compruebe si el servidor de base de datos simplemente está caído
Si sus datos de acceso son correctos y la base de datos no está dañada, puede que el servidor que aloja su base de datos esté caído, sobrecargado o rechazando conexiones nuevas. Aquí es donde el hosting compartido barato deja ver sus costuras: decenas o cientos de sitios comparten un solo servidor de base de datos y, cuando tiene mucho trabajo, el suyo no consigue conexión.
Un par de formas de saberlo:
- Si tiene otros sitios con el mismo proveedor, revise si también están caídos — una caída compartida apunta al servidor.
- Revise la página de estado de su proveedor, o pregúntele a su soporte si el servidor de base de datos está bien.
Si el problema es el servidor, no hay nada que arreglar en sus archivos — es trabajo del proveedor. Y si se repite, es su sitio diciéndole que ya superó un plan de ganga.
Cuando el problema es del proveedor
Un error de conexión con la base de datos que se repite y que no es un error en los datos de acceso es una de las señales más claras de que está en un hosting demasiado lleno o demasiado débil para su sitio. No debería tener que vigilar una herramienta de reparación porque el pico de tráfico de un vecino tumbó un servidor de base de datos compartido.
Esta es una de las razones por las que la gente se pasa al hosting de WordPress administrado. En nuestra plataforma, los sitios no se pelean entre sí por una sola base de datos sobrecargada, los recursos del servidor se vigilan automáticamente para que una falta de recursos se detecte antes de convertirse en una caída, y cada actualización que aplicamos se verifica para asegurarnos de que su sitio se siga viendo y funcionando bien después — sin daños por actualizaciones interrumpidas. La mudanza es gratis y la hacemos nosotros, así que los datos de acceso no se configuran incorrectamente durante la mudanza. Si su error de base de datos sigue volviendo, ese suele ser el arreglo de verdad.
Si nada funciona: restaure desde una copia de seguridad
De vez en cuando la base de datos está de verdad dañada más allá de una reparación rápida — después de una caída o de un plugin que escribió mal. Para eso están las copias de seguridad. Una copia limpia y reciente devuelve su contenido al último estado bueno conocido en minutos. Siga los pasos de nuestra guía sobre cómo restaurar WordPress desde una copia de seguridad. (Cada plan que administramos incluye copias de seguridad externas 3 veces al día, así que siempre hay una copia limpia esperando.)
Un resumen rápido
- Compruebe si el área de administración muestra un mensaje de “reparar”.
- Verifique sus cuatro datos de acceso a la base de datos en
wp-config.php. - Use la herramienta de reparación integrada — y luego quite la línea que la activa.
- Descarte un servidor de base de datos caído o sobrecargado (eso es cosa del proveedor).
- ¿Sigue roto? Restaure su última copia de seguridad limpia.
Si este error es un visitante frecuente — o simplemente prefiere no editar archivos de configuración bajo presión — déjelo en nuestras manos. Es un arreglo de rutina para nuestro equipo con base en EE. UU., y mudarse a un hosting donde la base de datos no tenga que pelear por las sobras suele acabar con él para siempre. Si su sitio también muestra otros síntomas, nuestra lista de revisión de emergencia y nuestra guía sobre la pantalla blanca de la muerte cubren los problemas parecidos.