Error conexión base de datos WordPress | Solución en cPanel/Plesk

Imagina que llegas a tu web de WordPress y, en lugar del contenido habitual, te encuentras con un mensaje en blanco o un texto que dice: "Error al establecer una conexión a la base de datos". Es frustrante, ¿verdad? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía completa y muy visual, te explicaré paso a paso cómo solucionar el error conexión base datos WordPress de forma sencilla, incluso si no eres un experto técnico.

Vamos a desglosar todo lo que necesitas saber para recuperar tu sitio web. Desde lo más básico (como revisar contraseñas) hasta soluciones un poco más avanzadas (como reparar la base de datos). Sigue cada paso con calma y, antes de que te des cuenta, tu web estará funcionando de nuevo.

¿Qué significa realmente el error "Conexión a la base de datos"?

Para entenderlo, piensa en tu web como una biblioteca. WordPress es el bibliotecario, y la base de datos es el almacén lleno de libros (tus artículos, páginas, usuarios, configuraciones). Cuando alguien visita tu web, el bibliotecario (WordPress) necesita ir al almacén (base de datos) a buscar la información correcta.

El WordPress error base datos aparece cuando el bibliotecario no puede abrir la puerta del almacén. Las razones pueden ser varias: la llave no es la correcta (credenciales equivocadas), el almacén está cerrado (servidor de base de datos caído), o la puerta está rota (archivos de configuración dañados).

No entres en pánico. Vamos a revisar las causas una por una y a solucionarlas.

Causas comunes del error de conexión a la base de datos

Antes de lanzarnos a las soluciones, es útil saber qué puede estar provocando el problema. Las causas más frecuentes son:

Credenciales incorrectas en el archivo wp-config.php: Es la causa más común. Al cambiar de hosting, restaurar una copia de seguridad o modificar contraseñas, los datos de acceso a la base de datos pueden quedar desactualizados.
Servidor de base de datos caído o sobrecargado: A veces el problema no está en tu web, sino en el servidor donde se aloja tu base de datos. Esto es más habitual en hosting compartido.
Base de datos corrupta: Aunque es menos frecuente, una tabla de la base de datos puede dañarse por un corte de luz, un plugin conflictivo o una actualización fallida.
Problemas de permisos o archivos del core de WordPress: Archivos esenciales como wp-config.php pueden tener permisos incorrectos o estar dañados.
Firewall o plugin de seguridad bloqueando la conexión: En raras ocasiones, una regla de seguridad mal configurada puede impedir la conexión a la base de datos.

Soluciones paso a paso para solucionar el error de conexión a la base de datos

Aquí tienes una lista de acciones ordenadas de la más sencilla a la más técnica. Empieza siempre por la primera y ve avanzando hasta que el error desaparezca.

1. Verificar las credenciales de la base de datos en wp-config.php

Este es el primer lugar donde debes mirar. El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress (normalmente en la carpeta public_html o www). Contiene la configuración esencial, incluyendo el nombre de la base de datos, el usuario, la contraseña y el servidor.

Cómo hacerlo:

Accede a tu panel de control de hosting. Si usas Syspanel (antes conocido como HestiaCP), entra a través de tu-dominio.com:2106 con tus credenciales de administrador.
Busca el Administrador de Archivos (File Manager). Normalmente está en la sección de "Archivos" o "Avanzado".
Navega hasta la carpeta raíz de tu web (por ejemplo, public_html o public_html/tu-dominio).
Localiza el archivo wp-config.php. Haz clic derecho sobre él y selecciona Editar (o "View/Edit").

Busca las siguientes líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'tu_usuario_de_base_de_datos');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Comprueba que estos datos sean correctos. Si no los recuerdas, puedes encontrarlos en la sección de Bases de Datos de tu panel de control. En Syspanel, ve a "Bases de Datos" y busca la base de datos asociada a tu web. Allí verás el nombre, el usuario y podrás cambiar la contraseña si es necesario.
Si cambiaste la contraseña en el panel de bases de datos, asegúrate de actualizarla también en el archivo wp-config.php. Guarda los cambios y vuelve a cargar tu web.

[TIP] Si no estás seguro de qué datos poner, la opción más segura es crear una nueva contraseña desde tu panel de bases de datos y luego copiarla exactamente en el archivo wp-config.php. Así evitas errores de tipeo.

2. Reparar la base de datos de WordPress

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

Cómo activarla:

Accede de nuevo al archivo wp-config.php a través del Administrador de Archivos.
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Ahora, abre una nueva pestaña en tu navegador y ve a esta dirección (reemplaza tudominio.com con tu dominio real):

https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos opciones:
- "Repair Database" (Reparar base de datos): Intenta corregir los errores.
- "Repair and Optimize Database" (Reparar y optimizar): Además de reparar, optimiza las tablas para un mejor rendimiento.
Haz clic en "Repair Database". El proceso puede tardar unos segundos.
Una vez terminado, es muy importante que elimines la línea que añadiste en el paso 2 del archivo wp-config.php. Si no lo haces, cualquiera podría acceder a la herramienta de reparación y dañar tu web.
Guarda el archivo wp-config.php sin esa línea y vuelve a cargar tu web.

[WARNING] No dejes la línea define('WP_ALLOW_REPAIR', true); activa. Es una puerta de seguridad abierta. Bórrala inmediatamente después de usarla.

3. Comprobar el estado del servidor de base de datos

A veces el problema no está en tu web, sino en el servidor. Si tu base de datos está en un servidor diferente al de tu web (algo común en hosting gestionado o en servidores dedicados), puede que ese servidor esté caído o sobrecargado.

¿Cómo saberlo?

Pregunta a tu soporte técnico: Si tu hosting tiene soporte (chat, ticket, teléfono), pregunta directamente si el servidor de bases de datos está funcionando correctamente.
Revisa el panel de control: En Syspanel, ve a la sección de "Servicios" o "Estado del servidor". Busca si el servicio de base de datos (normalmente llamado MySQL o MariaDB) aparece como "Activo" o "Running". Si está detenido, puedes intentar reiniciarlo desde el mismo panel (busca un botón de "Restart" o "Reiniciar").
Prueba con otro sitio: Si tienes otras webs en el mismo hosting y funcionan bien, es probable que el problema sea específico de tu base de datos. Si ninguna funciona, el problema es del servidor.

[INFO] Si estás en un hosting compartido, es común que el servidor de bases de datos se sature si hay muchos sitios haciendo consultas pesadas. En ese caso, solo te queda esperar a que se libere o contactar al soporte.

4. Restaurar una copia de seguridad reciente

Si has llegado hasta aquí y el error persiste, puede que la base de datos esté gravemente dañada o que un cambio reciente (una actualización de plugin, un cambio de configuración) haya roto algo. Restaurar una copia de seguridad es la solución más rápida y segura.

Cómo hacerlo (método general):

Accede a tu panel de control de hosting. En Syspanel, busca la sección de "Backups".
Localiza una copia de seguridad de tu web (de la base de datos y los archivos) de una fecha anterior a cuando apareció el error.
Restaura primero la base de datos. Normalmente hay una opción de "Restore" para la base de datos. Selecciona la copia y confirma.
Luego restaura los archivos (si es necesario). Esto sobrescribirá todo, incluyendo el archivo wp-config.php, así que asegúrate de que la copia sea de antes del error.
Una vez restaurado, comprueba tu web.

[TIP] Si no tienes copia de seguridad, este es un buen momento para configurar una. Muchos paneles como Syspanel ofrecen copias automáticas diarias o semanales. Revisa la configuración de backups de tu hosting.

5. Contactar al soporte técnico de tu hosting

Si después de todos estos pasos el error conexión base datos WordPress sigue apareciendo, es hora de pedir ayuda profesional. El soporte técnico de tu empresa de hosting tiene acceso a herramientas y registros que tú no ves.

Qué información proporcionarles para agilizar la ayuda:

El mensaje de error exacto que ves.
Los pasos que ya has intentado (por ejemplo: "Verifiqué las credenciales en wp-config.php, ejecuté la reparación de base de datos y el servidor parece activo").
La fecha y hora aproximada en que comenzó el error.
Si hiciste algún cambio justo antes del error (instalaste un plugin, cambiaste una contraseña, etc.).

[WARNING] No compartas tus contraseñas de acceso (ni de WordPress ni de la base de datos) a menos que estés 100% seguro de que estás hablando con el soporte oficial de tu hosting. Un técnico legítimo nunca te pedirá tu contraseña por correo o chat no oficial.

Preguntas Frecuentes (FAQ) sobre el error de conexión a la base de datos en WordPress

Para terminar, respondo a las dudas más comunes que suelen tener los usuarios.

¿Por qué aparece este error después de cambiar de hosting?

Es muy común. Al migrar tu web, las credenciales de la base de datos cambian (nuevo servidor, nuevo usuario, nueva contraseña). Si no actualizas el archivo wp-config.php con los nuevos datos, WordPress no podrá conectar. Revisa el Paso 1 de esta guía.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos frecuente. Un plugin o tema mal codificado puede realizar consultas que dañen las tablas de la base de datos. Si el error apareció justo después de instalar o actualizar un plugin, intenta desactivarlo. Para ello, necesitarás acceder a la base de datos por phpMyAdmin y cambiar el nombre del plugin en la tabla wp_options, o renombrar la carpeta del plugin desde el Administrador de Archivos.

¿Qué hago si no puedo acceder al panel de administración de WordPress (wp-admin)?

No te preocupes. Todas las soluciones de esta guía se realizan desde el panel de control de tu hosting (como Syspanel) o directamente sobre los archivos. No necesitas acceder a wp-admin para solucionar el error. De hecho, el error de conexión a la base de datos te impedirá entrar, pero las herramientas de tu hosting siguen funcionando.

¿Puedo perder datos si reparo la base de datos?

La herramienta de reparación de WordPress (Paso 2) está diseñada para ser segura. Intenta corregir errores sin eliminar datos. Sin embargo, como medida de precaución, siempre es recomendable hacer una copia de seguridad antes de realizar cualquier acción sobre la base de datos.

¿Cada cuánto debo hacer copias de seguridad?

Idealmente, tu hosting debería hacer copias automáticas diarias. Tú, por tu parte, deberías hacer una copia manual cada vez que realices cambios importantes (actualizar WordPress, instalar un plugin nuevo, cambiar el tema, etc.). La frecuencia mínima recomendada es semanal.

Recuerda, el WordPress base datos error es un problema común y, en la mayoría de los casos, solucionable siguiendo estos pasos. Respira hondo, empieza por lo más sencillo y, si te atascas, no dudes en pedir ayuda a tu soporte técnico. ¡Tu web volverá a la vida en poco tiempo!