Error de conexión a la base de datos WordPress: Solución en cPanel/Plesk

¿Te ha aparecido el temido error conexión base datos wordpress en tu pantalla? No te preocupes, es uno de los avisos más comunes en el mundo de WordPress, pero también uno de los que tiene solución más rápida si sabes dónde mirar. Cuando ves el mensaje "Error establishing a database connection" o un "wordpress database error", significa que tu sitio web no puede comunicarse con la base de datos donde se guardan tus entradas, páginas y configuraciones.

En esta guía extensa y práctica, vamos a desglosar paso a paso cómo solucionar error db wordpress tanto si tu hosting usa cPanel como si usa Plesk. No necesitas ser un experto en programación, solo seguir el orden lógico que te propongo a continuación. Vamos a ello.

¿Por qué ocurre este error?

Antes de lanzarnos a tocar archivos, es fundamental entender la causa raíz. El error de conexión a la base de datos puede deberse a varias razones, desde un simple cambio de contraseña hasta un ataque malintencionado. Las causas más frecuentes son:

Datos de acceso incorrectos en el archivo wp-config.php (nombre de la base de datos, usuario o contraseña).
Servidor de base de datos caído o sobrecargado (problema del proveedor de hosting).
Corrupción de archivos del propio WordPress o de la base de datos.
Límite de memoria PHP agotado o conflictos con plugins recién instalados.
Cambios en el servidor (migración de dominio, cambio de IP, actualización de PHP).

Para resolverlo, vamos a actuar como detectives: primero verificamos lo más simple y luego avanzamos a soluciones más técnicas.

Paso 1: Verifica el estado de tu servidor de hosting

Antes de tocar nada en tu panel, comprueba si el problema es general. Si tu proveedor de hosting tiene una caída, no podrás hacer nada. Revisa el correo electrónico asociado a tu cuenta o visita la página de estado de tu proveedor (la mayoría la tienen, por ejemplo, status.tuproveedor.com).

[TIP] Si usas Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es el 2106. Accede a tu panel para ver si el servicio de base de datos (MySQL/MariaDB) aparece como "activo". Si está detenido, intenta reiniciarlo desde la sección de servicios.

Paso 2: Revisa el archivo wp-config.php (la causa más común)

Este archivo es el corazón de la configuración de WordPress. Contiene las credenciales de acceso a tu base de datos. Un error tipográfico, un carácter extra o una contraseña cambiada recientemente aquí son la fuente del 80% de los problemas.

¿Cómo acceder al archivo?

Desde cPanel: Entra en el Administrador de archivos (File Manager) y navega hasta public_html (o la carpeta raíz de tu sitio). Busca el archivo wp-config.php.
Desde Plesk: Ve a Administrador de archivos dentro de tu dominio y localiza el archivo en la raíz.
Desde Syspanel: Entra por el puerto 2106, ve a la sección de archivos y navega hasta la carpeta de tu dominio.

¿Qué buscar?

Abre el archivo con un editor de texto (clic derecho -> Editar) y localiza estas líneas:

define( 'DB_NAME', 'tu_nombre_de_base' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Comprueba que exactamente esos valores coincidan con los datos de tu base de datos. La forma más segura de verificarlo es:

En cPanel: Busca la sección Bases de datos MySQL. Ahí verás el nombre de la base, el usuario y podrás cambiar la contraseña.
En Plesk: Ve a Bases de datos en el panel del dominio.

[WARNING] Si cambiaste la contraseña de la base de datos recientemente desde el panel y no actualizaste wp-config.php, este será tu problema. Copia y pega la nueva contraseña, guarda el archivo y recarga tu web.

Paso 3: Comprueba el host de la base de datos (DB_HOST)

Aunque la mayoría de los servidores usan localhost, algunos proveedores (especialmente con servidores externos o bases de datos separadas) utilizan una dirección IP o un nombre de host específico. Si tu proveedor te ha indicado un host distinto, como mysql.tudominio.com o localhost:3306, debes actualizarlo aquí.

[INFO] Si no estás seguro, deja localhost. Si tu hosting usa un servidor de bases de datos remoto, el valor correcto suele aparecer en la documentación de bienvenida de tu proveedor o en la sección de bases de datos del panel.

Paso 4: Repara la base de datos desde el panel

A veces, la base de datos se corrompe ligeramente (por ejemplo, por una interrupción del servicio). Tanto cPanel como Plesk tienen herramientas para repararla sin necesidad de comandos.

En cPanel

Accede a Bases de datos MySQL.
Busca tu base de datos y haz clic en Reparar (o "Check/Repair").
Espera a que termine. Suele ser instantáneo.

En Plesk

Ve a tu dominio y entra en Bases de datos.
Selecciona tu base de datos.
Haz clic en el botón Comprobar o Reparar (dependiendo de la versión, puede estar en el menú "Más acciones").

Este proceso revisa las tablas y corrige errores menores de índices o registros.

Paso 5: Aumenta el límite de memoria PHP

Aunque no lo parezca, un límite de memoria bajo puede provocar que WordPress no pueda conectar con la base de datos en momentos de alta demanda. Esto es más común si tienes muchos plugins.

Para solucionarlo, añade esta línea al final de tu archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');

Si el problema persiste, también puedes intentar aumentar el límite desde el panel:

cPanel: Busca Select PHP Version -> pestaña Options y cambia memory_limit a 256M.
Plesk: Ve a Configuración PHP dentro de tu dominio y ajusta el valor.

Paso 6: Desactiva todos los plugins (acceso por FTP)

Si el error apareció justo después de instalar o actualizar un plugin, es el principal sospechoso. El método más rápido es desactivarlos todos manualmente.

Conéctate por FTP (FileZilla, por ejemplo) o usa el Administrador de archivos de tu panel.
Navega a wp-content/plugins.
Renombra la carpeta plugins a plugins_inactivos. Esto desactiva todos los plugins a la vez.
Recarga tu web. Si funciona, el problema estaba en un plugin.

Ahora, renombra la carpeta de nuevo a plugins y ve activando uno a uno desde el escritorio de WordPress para identificar al culpable.

Paso 7: Revisa los logs de error (avanzado)

Si nada funciona, es hora de mirar los registros del servidor. Te darán la pista exacta.

En cPanel: Ve a Errores de error (Error Logs) dentro de Métricas.
En Plesk: Ve a Registros de registro o Logs en el dominio.

Busca líneas que contengan database connection o mysqli_connect. El error te dirá si es un problema de permisos, de host o de contraseña.

Paso 8: Restaura una copia de seguridad reciente

Si has llegado hasta aquí y el error persiste, es probable que haya un problema más profundo. La solución más rápida y segura es restaurar una copia de seguridad de tu sitio de hace unos días (cuando funcionaba).

En cPanel: Usa la herramienta Copias de seguridad o JetBackup si tu proveedor la ofrece.
En Plesk: Ve a Administrador de copias de seguridad y restaura la base de datos y los archivos.

[TIP] Mantén siempre una copia de seguridad externa (por ejemplo, en tu ordenador o en un servicio de nube) para estos casos de emergencia.

Preguntas frecuentes (FAQ)

¿Qué significa exactamente "wordpress database error"?

Significa que WordPress intentó conectarse a tu base de datos MySQL pero no pudo. Puede ser por credenciales incorrectas, por un servidor caído o por un archivo corrupto.

¿El error puede deberse a un ataque hacker?

Sí, aunque es menos común. Si sospechas de un ataque, cambia todas tus contraseñas (cPanel, FTP, base de datos) y revisa que no haya archivos extraños en tu servidor.

¿Tengo que contactar con mi proveedor de hosting?

Definitivamente, si has seguido todos los pasos y no lo resuelves. Ellos pueden verificar si el servidor de bases de datos está funcionando correctamente y revisar los logs a nivel de servidor.

¿Puedo evitar este error en el futuro?

Sí, siguiendo estas buenas prácticas:

Actualiza WordPress, temas y plugins con regularidad.
Realiza copias de seguridad automáticas semanales.
No cambies las contraseñas de la base de datos sin actualizar antes el wp-config.php.
Utiliza un hosting de calidad con buen soporte técnico.

Conclusión

El error conexión base datos wordpress puede ser frustrante, pero en la mayoría de los casos es un problema de configuración que puedes resolver en menos de diez minutos siguiendo este orden lógico. Recuerda: primero revisa el wp-config.php, luego verifica el estado del servidor, y si todo falla, no dudes en contactar con tu proveedor de hosting.

[WARNING] No edites el archivo wp-config.php con un editor que no sea de texto plano (como el Bloc de notas o el editor del panel). Usar Word o programas similares puede introducir caracteres invisibles que rompan la sintaxis del archivo.

Espero que esta guía te haya sido de gran ayuda. Si tu hosting usa Syspanel, recuerda que el acceso es a través del puerto 2106 y que la estructura de archivos es muy similar a la de cPanel. ¡Buena suerte y que tu web vuelva a estar online rápidamente!