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

¡Hola! Soy tu técnico de soporte amigable. Entiendo lo frustrante que es ver el temido mensaje "Error de conexión a la base de datos" en tu sitio WordPress. No te preocupes, es uno de los problemas más comunes y, por lo general, tiene solución rápida.

En esta guía completa, vamos a desglosar paso a paso qué significa este error, por qué ocurre y, lo más importante, cómo solucionarlo. No necesitas ser un experto en tecnología; solo sigue las instrucciones con calma.

¿Qué significa "Error de conexión a la base de datos"?

Imagina que tu sitio web es una biblioteca enorme. Los archivos de WordPress (temas, plugins, código) son los estantes, los libros y el mobiliario. La base de datos es el catálogo central que contiene toda la información: tus artículos, páginas, comentarios, usuarios, configuraciones, etc. Para que tu sitio funcione, WordPress necesita abrir ese catálogo constantemente.

El error "Error de conexión a la base de datos" significa que WordPress no puede encontrar o comunicarse con ese catálogo. Es como si la biblioteca estuviera cerrada, el bibliotecario no estuviera o la llave no funcionara. Sin acceso a los datos, tu sitio se queda en blanco.

Causas comunes del error

Antes de lanzarnos a solucionarlo, identifiquemos qué pudo haber pasado. Las causas más frecuentes son:

Credenciales incorrectas en wp-config.php: El archivo de configuración principal de WordPress tiene los datos de acceso a la base de datos (nombre, usuario, contraseña, servidor). Si algo cambió, se rompe la conexión.
El servidor de base de datos está caído o sobrecargado: A veces, el problema no es tuyo, sino del servidor donde se aloja tu web. Puede estar en mantenimiento o tener mucho tráfico.
Corrupción de la base de datos: Un plugin defectuoso, una actualización fallida o un ataque pueden dañar las tablas de la base de datos.
Límite de conexiones excedido: Cada sitio tiene un número máximo de conexiones simultáneas a la base de datos. Si tu web recibe muchos visitantes o un plugin consume muchas conexiones, puedes llegar al límite.
Problemas con el hosting (servidor web): A veces, el problema es más general y afecta a todos los sitios en el mismo servidor.
Cambios recientes: ¿Instalaste un nuevo plugin? ¿Actualizaste WordPress? ¿Modificaste algo en el panel de control de tu hosting? Estos cambios suelen ser los culpables.

Solución paso a paso: De lo más simple a lo más técnico

Sigue estos pasos en orden. La mayoría de las veces, el error se soluciona en los primeros pasos.

Paso 1: Verifica si el error es general o solo tuyo

A veces, el problema es temporal y del servidor. Antes de hacer nada, prueba esto:

Intenta acceder a tu sitio desde otro dispositivo (otro móvil, otra computadora) o desde una red diferente.
Usa una herramienta como "Down for everyone or just me". Ve a un sitio web que verifique si tu página está caída para todos o solo para ti.
Revisa el correo electrónico asociado a tu hosting. Tu proveedor de hosting suele enviar avisos si hay mantenimiento o incidencias en el servidor.

[INFO] Si el sitio funciona para otros o la herramienta dice que está caído para todos, el problema es del servidor. Contacta a tu soporte de hosting. Si solo falla para ti, puede ser un problema de tu conexión o de tu navegador (prueba borrar la caché).

Paso 2: Accede a tu panel de control de hosting (Syspanel)

Para los pasos siguientes, necesitarás acceder al lugar donde se administra tu sitio web. Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es:

Dirección: https://tudominio.com:2106 (reemplaza tudominio.com con tu dominio real).
Usuario y contraseña: Son los que te proporcionó tu proveedor de hosting al contratar el servicio.

Una vez dentro, busca la sección de Bases de Datos o Base de Datos MySQL. Ahí verás una lista con todas las bases de datos de tus sitios.

Paso 3: Revisa y corrige el archivo wp-config.php (La solución más común)

Este es el archivo clave. Es como la llave de tu biblioteca. Vamos a asegurarnos de que tenga los datos correctos.

Localiza el archivo wp-config.php: Puedes hacerlo desde el panel de archivos de Syspanel (buscando la carpeta public_html o tu_dominio) o mediante un cliente FTP (como FileZilla). Normalmente está en la raíz de tu sitio.
Abre el archivo con un editor de texto (como el Bloc de notas, pero mejor usa un editor de código como Notepad++ o Sublime Text). No uses Word o Pages.
Busca las siguientes líneas:
```
define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_la_base_de_datos');
define('DB_HOST', 'localhost');
```
Estos son los datos de conexión. Deben coincidir exactamente con los que aparecen en Syspanel en la sección de Bases de Datos.
- DB_NAME: El nombre de la base de datos que creaste para este WordPress.
- DB_USER: El usuario asociado a esa base de datos.
- DB_PASSWORD: La contraseña de ese usuario.
- DB_HOST: Normalmente es localhost, pero a veces tu hosting te da una dirección como mysql.tudominio.com. Verifica este valor en Syspanel.
¿Cómo obtener los datos correctos desde Syspanel?
- Ve a la sección Bases de Datos.
- Busca la base de datos que corresponde a tu sitio (por el nombre).
- Haz clic en el icono de Editar o Ver (normalmente un lápiz o un ojo).
- Ahí verás el nombre de la base de datos, el usuario y la opción de Mostrar contraseña. Anótalos o cópialos exactamente.
Actualiza el archivo wp-config.php: Si algún dato no coincide, corrígelo. Guarda el archivo y vuelve a cargar tu sitio web.

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde Syspanel (en la misma sección de edición de la base de datos) y luego actualizar wp-config.php con la nueva. Importante: Si cambias la contraseña desde Syspanel, también debes actualizarla en el archivo wp-config.

Paso 4: Repara la base de datos (Si está corrupta)

Si las credenciales son correctas pero el error persiste, la base de datos podría estar dañada. WordPress tiene una herramienta de reparación automática.

Abre tu archivo wp-config.php (como en el paso anterior).
Agrega la siguiente línea justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Accede a esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php (reemplaza tudominio.com con tu dominio).
Verás una pantalla con dos opciones: "Repair Database" (Reparar base de datos) y "Repair and Optimize Database" (Reparar y optimizar base de datos). Haz clic en "Repair Database" primero.
El proceso puede tardar unos segundos. Te mostrará un informe de las tablas reparadas.
IMPORTANTE: Una vez terminado, ELIMINA la línea que añadiste en wp-config.php. Si la dejas, cualquiera podría ejecutar la reparación. Vuelve a poner define('WP_ALLOW_REPAIR', false); o simplemente borra la línea que añadiste.

Paso 5: Verifica el servidor de base de datos (Hosting)

Si nada de lo anterior funciona, el problema es del servidor.

Contacta a tu soporte de hosting. Explícales que tienes un "Error de conexión a la base de datos" y que ya verificaste las credenciales y reparaste la base de datos.
Pregunta específicamente:
- ¿El servidor MySQL está funcionando correctamente?
- ¿Hay algún bloqueo o mantenimiento?
- ¿Se ha excedido el límite de conexiones simultáneas a la base de datos?
- ¿Pueden reiniciar el servicio MySQL?

[WARNING] Si tu hosting es muy económico (compartido), es posible que el límite de conexiones se alcance con facilidad si tienes muchos plugins o tráfico. Pregunta si puedes aumentar este límite o si necesitas migrar a un plan superior.

Paso 6: Restaura una copia de seguridad

Si todo falla y tienes una copia de seguridad reciente (deberías tenerla siempre), este es el momento de usarla.

Accede a Syspanel y busca la sección de Backups.
Selecciona la copia de seguridad más reciente (anterior al error).
Restaura la base de datos (no necesitas restaurar los archivos si el resto funciona).
Si no tienes backups automáticos, puedes restaurar manualmente usando phpMyAdmin (desde Syspanel) o un plugin como UpdraftPlus (si puedes acceder al wp-admin, que probablemente no podrás).

Preguntas Frecuentes (FAQ)

¿Por qué veo este error después de migrar mi sitio?

Es muy común. Al migrar, las rutas y credenciales cambian. Asegúrate de haber actualizado correctamente las líneas de DB_NAME, DB_USER, DB_PASSWORD y especialmente DB_HOST en tu nuevo archivo wp-config.php. A veces, el nuevo hosting usa DB_HOST diferente a localhost (por ejemplo, mysql.tudominio.com).

¿Puedo solucionar el error sin acceso al panel de administración de WordPress?

Sí, la mayoría de las soluciones se hacen desde el panel de control de hosting (Syspanel) o mediante FTP, sin necesidad de entrar a /wp-admin. De hecho, si ves el error, probablemente no puedas acceder a tu escritorio de WordPress.

¿El error puede ser por un plugin?

Sí, un plugin defectuoso o mal configurado puede saturar la base de datos o modificar sus tablas. Si el error apareció justo después de instalar o actualizar un plugin, intenta desactivarlo. ¿Cómo? Desde el panel de archivos de Syspanel, renombra la carpeta del plugin (por ejemplo, de nombre-plugin a nombre-plugin-desactivado) dentro de wp-content/plugins. Esto lo desactivará.

¿Qué hago si el error dice "Una o más tablas de la base de datos no están disponibles"?

Eso indica corrupción. Sigue el Paso 4 (reparar la base de datos) inmediatamente.

¿El error puede deberse a un ataque?

Sí, un ataque de fuerza bruta o malware puede corromper la base de datos o cambiar las credenciales. Si sospechas de un ataque, además de reparar la base de datos, cambia todas las contraseñas (de WordPress, de la base de datos, de FTP, de Syspanel) y escanea tu sitio con un plugin de seguridad (una vez que puedas acceder).

Resumen y consejos finales

El error de conexión a la base de datos en WordPress es alarmante, pero casi siempre reparable. Recuerda:

Mantén la calma. No borres nada sin saber qué haces.
Sigue los pasos en orden: Verifica el servidor, revisa wp-config.php, repara la base de datos.
Usa Syspanel (puerto 2106) para gestionar tus bases de datos y archivos.
Ten siempre una copia de seguridad actualizada. Es tu mejor seguro.
Si no te sientes seguro, contacta a tu soporte de hosting. Para eso están.

Espero que esta guía te haya sido de gran ayuda. Si sigues teniendo problemas, no dudes en preguntar a tu proveedor de hosting o a un desarrollador. ¡Tu sitio web volverá a funcionar en poco tiempo!