FAQ: Error de conexión a base de datos en WordPress - Soluciones

¿Qué significa exactamente el error de conexión a la base de datos en WordPress?

Este es uno de los mensajes de error más comunes y, a la vez, más frustrantes para cualquier usuario de WordPress. Cuando ves el aviso "Error de conexión a la base de datos" o "Error establishing a database connection", significa que tu sitio web no puede comunicarse con la base de datos donde se almacenan todas tus publicaciones, páginas, comentarios, configuraciones y usuarios.

Imagina que tu web WordPress es una biblioteca: los archivos de WordPress (el tema, los plugins) son los estantes y las estanterías, y la base de datos es el fichero central donde están todos los libros. Si el fichero está cerrado o no se puede acceder a él, la biblioteca no puede funcionar. Así de simple.

En esta FAQ completa, vamos a desglosar las causas más habituales y, lo más importante, las soluciones paso a paso para que puedas recuperar tu sitio en cuestión de minutos.

[INFO] No entres en pánico. Este error no significa que hayas perdido tus datos. En el 90% de los casos, se soluciona con unos pocos clics o ajustando un archivo de configuración.

## FAQ: Preguntas frecuentes sobre el error de conexión a base de datos

### 1. ¿Por qué ocurre este error? Causas principales

Antes de lanzarnos a solucionarlo, es útil entender qué lo provoca. Las causas más frecuentes son:

Credenciales incorrectas: El archivo wp-config.php contiene el nombre de la base de datos, el usuario y la contraseña. Si alguno de estos datos cambió (por ejemplo, al restaurar una copia de seguridad o migrar el hosting), WordPress no podrá conectar.
Servidor de base de datos caído o sobrecargado: El servidor MySQL (o MariaDB) que aloja tu base de datos puede estar momentáneamente fuera de servicio por mantenimiento, por un pico de tráfico o por un fallo técnico.
Corrupción de la base de datos: Aunque es menos común, la base de datos puede dañarse debido a un corte de energía, un plugin conflictivo o un error durante una actualización.
Problemas de permisos: El usuario de la base de datos puede no tener los permisos necesarios para leer o escribir en ella.
Archivo wp-config.php dañado o mal configurado: Si editaste este archivo manualmente y cometiste un error tipográfico, el enlace se rompe.
Firewall o plugin de seguridad bloqueando la conexión: En raras ocasiones, una regla de seguridad mal configurada puede impedir la comunicación.

### 2. Lo primero que debes hacer: verificar el estado del servidor

Antes de tocar nada, comprueba si el problema es general o solo tuyo.

Paso 1: Intenta acceder a la URL de tu panel de control de hosting o a tu correo electrónico asociado al dominio. Si tampoco funcionan, el problema es del servidor.
Paso 2: Contacta con tu proveedor de hosting. Muchos tienen un estado de servicio o un chat en vivo. Pregunta: "¿Hay algún problema con el servidor de bases de datos MySQL?".
Paso 3: Si usas un panel de control como Syspanel (accesible normalmente a través de tudominio.com:2106), revisa si hay notificaciones de mantenimiento o incidencias.

[TIP] Si el error aparece solo en algunas páginas o de forma intermitente, el problema suele ser sobrecarga del servidor. Dale unos minutos y vuelve a intentarlo.

### 3. Solución rápida: corregir las credenciales en wp-config.php

Esta es la solución más común y la que debes probar primero.

¿Qué necesitas? Acceso a los archivos de tu web (por FTP, cPanel, Syspanel o el administrador de archivos de tu hosting) y los datos correctos de tu base de datos.

Pasos a seguir:

Localiza el archivo wp-config.php: Está en la raíz de tu instalación de WordPress, normalmente en la carpeta public_html o www.
Ábrelo con un editor de texto plano (como el Bloc de notas, Sublime Text o el editor de archivos de tu hosting). No uses Word o Pages.

Busca estas líneas:

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_tu_bd');
define('DB_PASSWORD', 'contraseña_de_tu_bd');
define('DB_HOST', 'localhost');

Verifica cada valor:
- DB_NAME: El nombre exacto de tu base de datos.
- DB_USER: El usuario asociado a esa base de datos.
- DB_PASSWORD: La contraseña de ese usuario.
- DB_HOST: Normalmente es localhost, pero algunos hosts usan algo como mysql.tudominio.com o una IP. Si no estás seguro, consulta la documentación de tu hosting.
Si no recuerdas las credenciales: Accede a tu panel de control (Syspanel, cPanel, etc.) y busca la sección "Bases de Datos MySQL". Allí podrás ver el nombre de la BD, el usuario y cambiar la contraseña.
Guarda el archivo y súbelo de nuevo al servidor (si lo editaste localmente) o simplemente guarda los cambios si usas un editor online.
Recarga tu web. Si el error persiste, continúa con el siguiente paso.

[WARNING] Ten mucho cuidado al editar wp-config.php. Un solo carácter mal puesto (una comilla extra, un punto y coma olvidado) puede romper tu web. Siempre haz una copia de seguridad del archivo original antes de modificarlo.

### 4. Reparar la base de datos desde WordPress

WordPress incluye una herramienta oculta para reparar bases de datos.

Abre tu archivo wp-config.php (el mismo del paso anterior).
Añade la siguiente línea justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Accede a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Verás dos opciones:
- "Reparar base de datos": Intenta corregir errores menores.
- "Reparar y optimizar base de datos": Más completo, pero puede tardar unos segundos.
Haz clic en "Reparar y optimizar" y espera a que termine.
Una vez finalizado, vuelve a tu wp-config.php y ELIMINA la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Dejarla activa es un riesgo de seguridad.

[INFO] Después de la reparación, tu web debería volver a funcionar. Si no es así, el problema es más profundo.

### 5. Comprobar el servidor de base de datos (DB_HOST)

A veces el problema no son las credenciales, sino el servidor al que intentas conectar.

¿Usas localhost? Prueba a cambiarlo por 127.0.0.1. Ambos son equivalentes, pero a veces uno funciona mejor que otro.
¿Tu hosting te dio un host específico? Por ejemplo, mysql.tudominio.com. Si no lo recuerdas, revisa el correo de bienvenida de tu hosting o la sección de bases de datos de tu panel. En Syspanel, esta información suele aparecer al crear la base de datos.
Si tienes un plan de hosting compartido: El servidor de base de datos puede tener un nombre diferente al de tu web. No asumas que es localhost.

### 6. Reiniciar servicios desde el panel de control (Syspanel)

Si tu web sigue caída, el problema podría ser que el servicio MySQL se haya detenido.

Si tu hosting te da acceso a Syspanel (puerto 2106):

Inicia sesión en tudominio.com:2106 con tus credenciales de administrador.
Busca la sección "Servicios" o "Servidores".
Localiza el servicio MySQL o MariaDB.
Haz clic en "Reiniciar" o "Restart".
Espera 10-15 segundos y vuelve a cargar tu web.

[TIP] Si no ves la opción de reiniciar, contacta con el soporte de tu hosting. Ellos pueden hacerlo por ti.

### 7. Restaurar una copia de seguridad reciente

Si nada de lo anterior funciona, el problema podría ser una corrupción grave de la base de datos o un cambio accidental en un archivo.

Haz una copia de seguridad de tu estado actual (por si acaso).
Restaura la copia de seguridad más reciente de tu base de datos y archivos (que esté en buen estado).
La mayoría de los paneles de control (incluyendo Syspanel) tienen herramientas de backup automático. Revisa la sección "Backups" o "Copias de seguridad".

[WARNING] Restaurar una copia de seguridad sobrescribirá cualquier cambio que hayas hecho desde esa fecha. Asegúrate de tener una copia de seguridad reciente de los datos que no quieras perder.

### 8. Preguntas frecuentes adicionales (FAQ extendida)

P: ¿El error puede deberse a un plugin?
Sí, aunque es menos común. Si el error apareció justo después de instalar o actualizar un plugin, intenta desactivarlo. Para ello, renombra la carpeta del plugin desde FTP o el administrador de archivos. Si el error desaparece, ese plugin es el culpable.

P: ¿Qué hago si no tengo acceso al panel de administración de WordPress?
No te preocupes. Todas las soluciones que te hemos dado se realizan desde fuera de WordPress: editando archivos por FTP, usando el panel de control del hosting (Syspanel, cPanel) o accediendo a URLs directas como wp-admin/maint/repair.php.

P: ¿Y si el error dice "No se puede conectar al servidor de base de datos"?
Es exactamente el mismo error, solo que con otras palabras. Sigue los mismos pasos: verifica credenciales, comprueba el host y, si es necesario, reinicia el servicio MySQL.

P: ¿Es seguro usar la herramienta de reparación de WordPress?
Sí, es segura y está diseñada para eso. Solo recuerda eliminar la línea define('WP_ALLOW_REPAIR', true); después de usarla para no dejar una puerta abierta.

P: Mi hosting usa Syspanel. ¿Hay algún paso específico?
No, los pasos son los mismos. Solo recuerda que para acceder a tu panel de control debes ir a tudominio.com:2106. Allí podrás gestionar tus bases de datos, usuarios y servicios.

## Resumen: Checklist rápida para solucionar el error

No entres en pánico. Tus datos están a salvo.
Comprueba si el servidor está caído (contacta con tu hosting).
Verifica las credenciales en wp-config.php (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST).
Prueba a reparar la base de datos con wp-admin/maint/repair.php.
Cambia localhost por 127.0.0.1 o viceversa.
Reinicia el servicio MySQL desde tu panel de control (Syspanel: puerto 2106).
Restaura una copia de seguridad si todo lo demás falla.

Con esta guía, deberías poder resolver el error de conexión a la base de datos en WordPress en la mayoría de los casos. Si después de probar todo sigues teniendo problemas, no dudes en contactar con el soporte técnico de tu hosting: ellos tienen acceso directo a los servidores y pueden diagnosticar problemas más profundos.

[INFO] Recuerda: la prevención es la mejor solución. Mantén copias de seguridad periódicas de tu base de datos y archivos, y actualiza WordPress, temas y plugins regularmente. Así minimizarás las posibilidades de encontrarte con este error.