Solucionar Error de Conexión MySQL en WordPress - Guía Definitiva

¿Qué significa este error y por qué aparece?

Cuando visitas tu sitio web WordPress y ves el mensaje "Error establishing a database connection" o "Can't connect to MySQL server", significa que tu instalación de WordPress no puede comunicarse con la base de datos donde se almacenan tus artículos, páginas, usuarios y configuraciones.

Este es uno de los errores más comunes en WordPress y puede deberse a múltiples causas. La buena noticia es que, en la mayoría de los casos, tiene solución sin necesidad de ser un experto. Vamos a desglosarlo paso a paso, desde lo más simple hasta lo más técnico.

Entendiendo la conexión a la base de datos en WordPress

Para que WordPress funcione, necesita tres elementos conectados entre sí:

El archivo wp-config.php: contiene las credenciales de acceso a tu base de datos (nombre de la base, usuario, contraseña y servidor).
El servidor MySQL: es el motor de base de datos que guarda toda tu información.
El servidor web (Apache, Nginx, etc.): es el que ejecuta WordPress y se comunica con MySQL.

Si cualquiera de estos tres elementos falla, verás el error de conexión. A continuación, te explico las causas más frecuentes y cómo solucionarlas.

Paso 1: Verifica que tu base de datos esté activa

El primer paso es comprobar si el servidor MySQL está corriendo. A veces, por mantenimiento o un fallo del sistema, el servicio se detiene.

En un hosting compartido (cPanel, Syspanel, etc.)

Si tu sitio está en un hosting compartido, normalmente no tienes acceso directo al servidor. Lo que puedes hacer es:

Accede a tu panel de control (por ejemplo, Syspanel, que se accede por el puerto 2106).
Busca la sección de "Bases de datos" o "MySQL".
Verifica que el estado de tu base de datos sea "Activa" o "Corriendo".

Si ves que está "Detenida" o "Suspendida", intenta reiniciarla. Si no puedes, contacta con el soporte de tu hosting, ya que puede ser un problema del servidor.

En un servidor VPS o dedicado

Si tienes acceso por SSH, puedes ejecutar el siguiente comando para ver el estado del servicio:

systemctl status mysql

O si usas MariaDB (muy común):

systemctl status mariadb

Si el servicio está inactivo, puedes iniciarlo con:

sudo systemctl start mysql

[TIP] Si el servicio se detiene solo, puede ser por falta de memoria. Revisa los logs del sistema con sudo journalctl -u mysql para ver el motivo exacto.

Paso 2: Revisa las credenciales en wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Si las credenciales son incorrectas, la conexión fallará.

Para revisarlo, necesitas acceder a tu sitio por FTP o desde el administrador de archivos de tu hosting.

Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress.
Ábrelo con un editor de texto (como el Bloc de notas o Visual Studio Code).
Busca las siguientes líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

Errores comunes en este archivo

Nombre de la base de datos mal escrito: asegúrate de que coincide exactamente con el que ves en tu panel de control.
Usuario incorrecto: a veces se añade un prefijo, como usuario_bd.
Contraseña con espacios o caracteres especiales: si copiaste la contraseña y tiene un espacio al final, fallará.

[WARNING] Nunca cambies el DB_HOST a menos que sepas lo que haces. En la mayoría de los casos, localhost es correcto. Si tu hosting usa un servidor MySQL externo, te lo indicarán en su documentación.

¿Cómo obtener las credenciales correctas?

En Syspanel, por ejemplo, puedes ir a la sección "Bases de datos" y verás el nombre de la base, el usuario y podrás cambiar la contraseña desde ahí. Asegúrate de actualizar el archivo wp-config.php con esos datos.

Paso 3: Comprueba la dirección del servidor de base de datos (DB_HOST)

Aunque lo más común es localhost, algunos hosts usan una dirección diferente, como mysql.tudominio.com o una IP específica.

Para saber cuál es la correcta:

Revisa la documentación de tu proveedor de hosting.
Si usas Syspanel, en la sección de bases de datos suele aparecer la dirección del servidor.

Si recientemente cambiaste de hosting y el error apareció, es muy probable que la dirección del servidor haya cambiado. Actualiza DB_HOST con la nueva dirección.

Paso 4: Verifica el usuario y los permisos de la base de datos

A veces las credenciales son correctas, pero el usuario no tiene permisos suficientes para acceder a la base de datos.

En cPanel o Syspanel, puedes comprobar que el usuario esté vinculado a la base de datos y que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

Cómo solucionarlo en Syspanel

Accede a Syspanel (puerto 2106).
Ve a "Bases de datos".
Busca tu base de datos y haz clic en "Usuarios".
Asegúrate de que el usuario correcto está asignado y que tiene todos los permisos marcados.

Si no es así, añade el usuario y otórgale todos los privilegios.

Paso 5: Revisa si el servidor MySQL está sobrecargado

Si tu sitio recibe mucho tráfico o tienes una consulta muy pesada, el servidor MySQL puede colapsar y rechazar conexiones.

Esto es más común en servidores compartidos donde otros sitios consumen muchos recursos.

¿Cómo saber si es este el problema?

El error aparece y desaparece de forma intermitente.
Otros sitios en el mismo servidor también tienen problemas.
El sitio tarda mucho en cargar antes de mostrar el error.

Soluciones

Optimiza tu base de datos: elimina transitorios, revisiones de entradas antiguas y spam. Puedes usar plugins como WP-Optimize.
Habilita el caché: plugins como W3 Total Cache o WP Super Cache reducen las consultas a la base de datos.
Contacta con tu hosting: si el problema es recurrente, quizás necesitas un plan superior o un servidor dedicado.

Paso 6: Comprueba los archivos .htaccess y wp-config.php

A veces, un archivo .htaccess corrupto puede interferir con la conexión, aunque no es lo más común. Para descartarlo:

Ve a la raíz de tu WordPress por FTP.
Renombra .htaccess a .htaccess.bak.
Intenta acceder a tu sitio.

Si el error desaparece, el problema era ese archivo. Ve a Ajustes > Enlaces permanentes en WordPress y pulsa "Guardar cambios" para regenerarlo.

Paso 7: Verifica si hay un plugin o tema conflictivo

Un plugin o tema mal codificado puede intentar conectarse a una base de datos externa o hacer consultas que rompen la conexión.

Para probarlo:

Accede a tu servidor por FTP.
Renombra la carpeta wp-content/plugins a wp-content/plugins.bak.
Si el error desaparece, el problema es un plugin. Ve reactivándolos uno a uno hasta encontrar el culpable.

Si no es el plugin, prueba con el tema:

Renombra la carpeta wp-content/themes/tu-tema a wp-content/themes/tu-tema.bak.
WordPress usará un tema por defecto (Twentytwenty, etc.).

Paso 8: Repara la base de datos con wp-admin

WordPress tiene una herramienta integrada para reparar la base de datos. Para activarla:

Añade la siguiente línea a tu wp-config.php:

define('WP_ALLOW_REPAIR', true);

Ve a tudominio.com/wp-admin/maint/repair.php.
Haz clic en "Reparar base de datos".

[WARNING] Después de reparar, elimina esa línea del wp-config.php por seguridad.

Paso 9: Revisa los logs del servidor

Si nada de lo anterior funciona, necesitas ver los registros del servidor para entender qué está pasando.

En la mayoría de los paneles de control, como Syspanel, puedes acceder a los logs desde la sección "Registros" o "Logs". Busca errores relacionados con MySQL o con tu dominio.

Si no encuentras nada, contacta con el soporte técnico de tu hosting y diles que necesitas revisar los logs de error de MySQL.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si se produce este error?

No. El error es de conexión, no de pérdida de datos. Tus publicaciones y configuraciones siguen en la base de datos, solo que no puedes acceder a ellas temporalmente.

¿Cuánto tiempo tarda en solucionarse?

Depende de la causa. Si es un problema de credenciales, se soluciona en minutos. Si es un fallo del servidor, puede tardar horas. La mayoría de los casos se resuelven en menos de 30 minutos.

¿Por qué me pasa esto después de cambiar de hosting?

Es muy común. Al migrar, las credenciales de la base de datos suelen cambiar. Asegúrate de actualizar wp-config.php con los datos del nuevo hosting.

¿Qué hago si el error persiste?

Si has probado todos los pasos anteriores y el error continúa, contacta con tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden diagnosticar el problema en minutos.

Resumen rápido de solución

Causa probable	Solución
Servidor MySQL caído	Reinicia el servicio o contacta con soporte
Credenciales incorrectas	Revisa `wp-config.php` y actualiza datos
Usuario sin permisos	Otorga todos los privilegios en el panel
Servidor sobrecargado	Optimiza BD y activa caché
Plugin o tema conflictivo	Desactiva plugins y cambia de tema
Base de datos corrupta	Usa la herramienta de reparación de WordPress

Consejos finales para evitar este error en el futuro

Haz copias de seguridad periódicas de tu base de datos. Puedes usar plugins como UpdraftPlus.
Mantén WordPress, plugins y temas actualizados.
No uses plugins de caché incompatibles entre sí.
Contrata un hosting de calidad que ofrezca soporte técnico rápido y servidores estables.

[INFO] Recuerda que si tu sitio está en Syspanel, puedes acceder a todas las herramientas de gestión de bases de datos desde el puerto 2106, y su soporte técnico está disponible 24/7 para ayudarte con este tipo de incidencias.

El error "Can't connect to MySQL server" en WordPress es frustrante, pero siguiendo estos pasos, en la gran mayoría de los casos lo resolverás sin necesidad de ser un experto. Respira, ve paso a paso y no hagas cambios bruscos sin entender qué estás modificando. ¡Tu sitio volverá a estar en línea pronto!