Solucionar errores comunes de conexión a base de datos en WordPress

¡Hola! Soy tu técnico de soporte amigable y hoy vamos a resolver uno de los problemas más frustrantes que puedes encontrar en tu sitio web: el temido error de conexión a la base de datos en WordPress.

No te preocupes, es más común de lo que crees y, por lo general, tiene una solución sencilla. Vamos a desglosarlo paso a paso, como si lo hiciéramos juntos. Al final de esta guía, sabrás exactamente qué hacer para que tu web vuelva a la vida.

¿Qué significa el error "Error al establecer una conexión a la base de datos"?

Imagina que tu web WordPress es una tienda. El código de WordPress (el edificio) necesita un almacén donde guardar todos los productos, los pedidos, los usuarios y las configuraciones. Ese almacén es la base de datos. Cuando ves el mensaje "Error al establecer una conexión a la base de datos", significa que el edificio (WordPress) no puede abrir la puerta del almacén (Base de datos). Puede ser porque la llave es incorrecta, la puerta está atascada, o el almacén está cerrado por reformas.

Vamos a convertirte en un experto en abrir esa puerta.

Antes de empezar: Lo primero que debes hacer

Respira hondo. Este error no suele significar que hayas perdido tus datos. Lo más probable es que sea un problema de configuración o un recurso temporal del servidor.

1. Refresca la página varias veces: A veces es un fallo momentáneo del servidor. Un simple F5 (o Cmd+R en Mac) puede solucionarlo.
2. Revisa otros sitios en tu mismo hosting: Si tienes otros sitios web en el mismo plan de hosting y también fallan, el problema es del servidor (sobrecarga, mantenimiento, etc.). En ese caso, contacta a tu proveedor de hosting.
3. Desactiva plugins recién instalados (si puedes acceder al panel de administración): Si puedes entrar a /wp-admin, aunque sea lento, desactiva el último plugin que instalaste. Si no puedes acceder, no te preocupes, lo haremos por FTP o por el panel de control.

Causa #1: Credenciales de la base de datos incorrectas (La más común)

WordPress guarda las "credenciales" (nombre de usuario, contraseña, nombre de la base de datos y servidor) en un archivo llamado wp-config.php. Si estos datos no coinciden exactamente con los que creaste en tu panel de hosting, la conexión falla.

¿Cómo solucionarlo?

Vamos a revisar y corregir el archivo wp-config.php.

Paso 1: Accede a tus archivos por FTP o cPanel

• Opción A (FTP): Usa un cliente FTP como FileZilla. Conéctate a tu servidor con los datos que te proporcionó tu hosting.
• Opción B (cPanel, Plesk, DirectAdmin o Syspanel): Es más fácil. Entra al panel de control de tu hosting.
  • cPanel: Busca el icono "Administrador de Archivos".
  • Plesk: Ve a "Archivos" o "Administrador de Archivos".
  • DirectAdmin: Busca "Administrador de Archivos" en el menú principal.
  • Syspanel (para HestiaCP): Accede a tu Syspanel (normalmente en tu-dominio.com:2106). Ve a la sección "Web" y luego a "Administrador de Archivos".

Paso 2: Encuentra y edita wp-config.php

Una vez dentro del administrador de archivos, navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta como public_html/miweb). Busca el archivo wp-config.php. Haz clic derecho y selecciona "Editar" o "Ver/Editar".

Paso 3: Verifica las credenciales

Dentro del archivo, busca estas líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_tu_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_tu_base_de_datos');
define('DB_HOST', 'localhost');

Ahora, vamos a obtener los datos correctos desde tu panel de control.

Paso 4: Obtén las credenciales correctas desde tu panel

• En cPanel: Busca la sección "Bases de Datos" > "Bases de Datos MySQL". Ahí verás una lista de bases de datos y usuarios. Si no recuerdas la contraseña, puedes crear un nuevo usuario y asignarlo a la base de datos, o cambiar la contraseña del usuario existente.
• En Plesk: Ve a "Bases de Datos". Selecciona tu base de datos. Ahí verás el usuario y la opción de cambiar la contraseña.
• En DirectAdmin: Ve a "Administración de MySQL". Ahí verás tus bases de datos y usuarios. Puedes gestionar las contraseñas.
• En Syspanel (HestiaCP): Busca la sección "Bases de Datos". Verás una lista con el nombre de la base de datos, el usuario y un botón para generar o cambiar la contraseña.

Paso 5: Corrige el archivo y guarda

Copia EXACTAMENTE el nombre de la base de datos, el usuario y la contraseña desde tu panel al archivo wp-config.php. Asegúrate de que estén entre comillas simples, como en el ejemplo.

[WARNING] ¡Cuidado con las mayúsculas, minúsculas y espacios! Un simple espacio extra puede romper la conexión. Es mejor copiar y pegar.

Paso 6: El caso especial de DB_HOST

Normalmente, el valor es 'localhost'. Sin embargo, algunos proveedores de hosting utilizan un servidor de base de datos separado. Si tu hosting te ha proporcionado un host específico (por ejemplo, mysql.tudominio.com o 127.0.0.1), cámbialo. Si no, déjalo como 'localhost'.

[INFO] Si tu web sigue sin funcionar después de cambiar las credenciales, a veces el servidor de base de datos tarda unos minutos en actualizar los cambios de contraseña. Espera 5 minutos y vuelve a intentarlo.

Causa #2: El servidor de base de datos está caído o sobrecargado

A veces, el problema no es tuyo, sino del servidor. Es como si el almacén estuviera cerrado por inventario.

¿Cómo verificarlo?

1. Pregunta a tu proveedor de hosting: La forma más rápida. Muchos tienen un estado del servicio en su web o un chat de soporte.
2. Revisa si otros sitios en el mismo servidor fallan: Como mencionamos al principio, si otros sitios también dan error, es un problema general.
3. Usa una herramienta externa (si eres más técnico): Puedes usar ping o telnet desde tu computadora para ver si el puerto de la base de datos (normalmente el 3306) responde. Pero esto ya es más avanzado.

¿Qué hacer?

• Si es un problema general: Solo te queda esperar a que tu proveedor lo solucione. No te preocupes, suelen ser rápidos.
• Si es un problema de recursos (tu web tiene mucho tráfico): Puede que tu plan de hosting sea insuficiente. Un pico de visitas puede saturar el servidor de base de datos. La solución a largo plazo es mejorar tu plan de hosting o usar un plugin de caché.

Causa #3: Base de datos corrupta

Al igual que un archivo de Excel se puede corromper, una base de datos de WordPress también puede dañarse. Esto puede pasar por un corte de luz, un plugin defectuoso o un error al actualizar.

¿Cómo repararla?

WordPress tiene una herramienta de reparación incorporada, pero primero hay que activarla.

Paso 1: Activar el modo de reparación

Añade la siguiente línea a tu archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.

Paso 2: Ejecutar la reparación

Ahora, en tu navegador, ve a esta dirección: tudominio.com/wp-admin/maint/repair.php

Verás dos opciones:

• Reparar base de datos: Intenta arreglar los problemas.
• Reparar y optimizar base de datos: Hace lo mismo, pero además optimiza las tablas (las limpia un poco).

Recomiendo empezar con "Reparar base de datos". Si no funciona, prueba con la segunda opción.

[WARNING] Una vez que termines, es muy importante que borres la línea que añadiste (define('WP_ALLOW_REPAIR', true);) del archivo wp-config.php. Si la dejas, cualquiera podría acceder a la herramienta de reparación y dañar tu web.

Alternativa: Reparar desde el panel de control

Si no te sientes cómodo editando archivos, la mayoría de los paneles de control tienen una herramienta para reparar bases de datos.

• En cPanel: Ve a "Bases de Datos MySQL". Busca tu base de datos y haz clic en "Reparar base de datos".
• En Plesk: Ve a "Bases de Datos", selecciona tu base de datos y busca la opción "Reparar".
• En DirectAdmin: Ve a "Administración de MySQL", selecciona la base de datos y busca "Reparar".
• En Syspanel (HestiaCP): Normalmente, la reparación se hace desde la línea de comandos (más técnico), pero puedes exportar la base de datos y luego importarla de nuevo para "limpiarla". Si no te sientes seguro, contacta al soporte.

Causa #4: Problemas con el prefijo de las tablas (ataque de seguridad)

En casos raros, un ataque malicioso puede cambiar el prefijo de las tablas de tu base de datos (por ejemplo, de wp_ a wp_old_). WordPress entonces no encuentra las tablas y da el error.

¿Cómo solucionarlo?

Esto requiere acceso a la base de datos a través de phpMyAdmin (una herramienta web para gestionar bases de datos).

1. Accede a phpMyAdmin:

   • cPanel: Busca el icono "phpMyAdmin".
   • Plesk: Ve a "Bases de Datos" y haz clic en "phpMyAdmin".
   • DirectAdmin: Busca "phpMyAdmin" en el menú.
   • Syspanel (HestiaCP): No tiene phpMyAdmin preinstalado, pero puedes instalarlo desde el panel de aplicaciones, o usar la línea de comandos. Si no te sientes cómodo, contacta al soporte.

2. Selecciona tu base de datos: En phpMyAdmin, a la izquierda, verás una lista de bases de datos. Haz clic en la tuya.

3. Revisa el prefijo de las tablas: Verás una lista de tablas. Todas deberían empezar con el mismo prefijo (ej. wp_posts, wp_options, etc.). Si ves que algunas tablas tienen un prefijo diferente (ej. wp_old_posts), significa que el prefijo ha sido cambiado.

4. Solución rápida (si sabes el prefijo nuevo): Ve al archivo wp-config.php y busca la línea:

   $table_prefix = 'wp_';
   

   Cambia 'wp_' por el nuevo prefijo (ej. 'wp_old_'). Guarda el archivo y prueba tu web.

5. Solución más segura (recomendada): Si no estás seguro, es mejor restaurar una copia de seguridad de la base de datos anterior al ataque. Si no tienes copia, contacta a un profesional.

[INFO] Si sospechas de un ataque, cambia todas tus contraseñas (WordPress, FTP, base de datos, panel de control) inmediatamente después de solucionar el error.

Preguntas Frecuentes (FAQ)

P: ¿El error de conexión a la base de datos significa que he perdido mis datos?
R: No, en el 99% de los casos no. Tus datos siguen en la base de datos, solo que WordPress no puede acceder a ellos. Siguiendo los pasos de esta guía, lo más probable es que los recuperes.

P: He cambiado la contraseña de la base de datos en cPanel, pero sigo teniendo el error.
R: Recuerda que también debes actualizar la contraseña en el archivo wp-config.php. Si ya lo hiciste, espera unos minutos y borra la caché de tu navegador.

P: No encuentro el archivo wp-config.php en mi administrador de archivos.
R: Asegúrate de estar en la carpeta correcta (normalmente public_html). También puede estar oculto. En la mayoría de los administradores de archivos, hay una opción para "Mostrar archivos ocultos". Actívala.

P: Mi hosting usa Syspanel (HestiaCP) y no encuentro la base de datos.
R: Recuerda que el acceso a Syspanel es a través del puerto 2106 (ej. tudominio.com:2106). Una vez dentro, busca la sección "Bases de Datos". Si no ves nada, es posible que tu plan no incluya bases de datos. Contacta a tu proveedor.

P: He probado todo y nada funciona. ¿Qué hago?
R: No te desesperes. Contacta al soporte técnico de tu hosting. Diles que has verificado las credenciales en wp-config.php, has reparado la base de datos y has comprobado que el servidor de base de datos responde. Ellos podrán revisar los logs del servidor para encontrar la causa exacta.

Conclusión: No temas al error

El error de conexión a la base de datos en WordPress es un problema común pero, como has visto, casi siempre solucionable. La clave está en ir paso a paso, con calma y verificando cada detalle.

Recuerda que lo más importante es:

1. Verificar las credenciales en wp-config.php.
2. Reparar la base de datos si está corrupta.
3. Contactar a tu hosting si el problema es del servidor.

Con esta guía, ya tienes las herramientas para ser el héroe de tu propia web. ¡Ánimo y a seguir creciendo!