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

¿Qué significa el error "Can't connect to MySQL server" en WordPress?

Este es uno de los avisos más temidos por cualquier persona que gestiona una web. Ver un mensaje como "Error establishing a database connection" o directamente "Can't connect to MySQL server" en tu WordPress significa que tu sitio web no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, comentarios y ajustes.

Sin esa conexión, WordPress es como un coche sin motor: la estructura existe, pero no puede funcionar. La buena noticia es que, en la mayoría de los casos, este error tiene una solución sencilla que puedes aplicar tú mismo, incluso sin ser un experto en informática.

A lo largo de esta guía, vamos a desglosar todas las causas posibles y te daremos soluciones paso a paso para solucionar mysql wordpress, tanto si tu hosting usa cPanel como si usa Plesk. No te preocupes, iremos de lo más simple a lo más complejo, y siempre con un lenguaje claro.

Primeros pasos: respira y comprueba lo básico

Antes de entrar en configuraciones complejas, es fundamental descartar los problemas más tontos. Muchas veces el error can't connect to mysql server aparece por un mantenimiento programado del hosting o por un pico de tráfico.

1. Comprueba si es un problema general

Entra en tu navegador y visita tu web. ¿Te da el error también en el panel de administración (/wp-admin)? Ahora, intenta acceder a otra web que tengas en el mismo hosting (si tienes más de una). Si todas fallan, el problema no es WordPress, sino el servidor de bases de datos en sí.

[INFO] Si todas tus webs dan error, contacta con tu proveedor de hosting inmediatamente. Puede que estén haciendo un mantenimiento de emergencia o que el servidor MySQL se haya caído.

2. Reinicia tu router y tu equipo

A veces la solución más tonta es la correcta. Un fallo temporal en tu conexión a internet puede impedir que tu ordenador (o el móvil) llegue al servidor. Prueba con otra red, por ejemplo, los datos móviles del teléfono.

Solución paso a paso en cPanel

cPanel es el panel de control más popular del mundo. Si tu hosting lo usa, sigue estos pasos en orden.

Paso 1: Verifica las credenciales en wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene el nombre de la base de datos, el usuario y la contraseña. Si estos datos no coinciden con los reales, tendrás el error error conexion mysql wordpress.

Cómo hacerlo:

Accede a tu cPanel y busca la opción "Administrador de archivos" (File Manager).
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html).
Busca el archivo wp-config.php, haz clic derecho y selecciona "Editar".
Busca estas líneas:

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

¿Qué debes comprobar?

DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos en cPanel.
DB_USER: Debe coincidir con el usuario de la base de datos.
DB_PASSWORD: Debe ser la contraseña correcta. Ojo con las mayúsculas y minúsculas.
DB_HOST: Normalmente es localhost, pero algunos hostings usan 127.0.0.1 o un nombre de servidor específico como mysql.tudominio.com. Revisa el correo de bienvenida de tu hosting.

[WARNING] No cambies nada todavía. Primero, ve a la sección "Bases de datos MySQL" en cPanel y verifica que los datos coinciden. Si no estás seguro de la contraseña, es mejor cambiarla desde cPanel (ver siguiente paso).

Paso 2: Cambia la contraseña de la base de datos desde cPanel

Si sospechas que la contraseña es incorrecta, la forma más segura de arreglarlo es cambiarla directamente desde el panel.

En cPanel, busca la sección "Bases de datos MySQL".
Localiza tu base de datos y el usuario asociado.
Haz clic en "Cambiar contraseña" para ese usuario.
Genera una contraseña segura o escribe una que recuerdes.
Ahora, vuelve al archivo wp-config.php y actualiza la línea DB_PASSWORD con la nueva contraseña.
Guarda los cambios y recarga tu web.

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

WordPress tiene una función oculta para reparar bases de datos. Es muy útil si el problema es una corrupción de tablas.

Abre tu archivo wp-config.php y añade esta línea justo después de la línea define('DB_HOST', ...):

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ve a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Haz clic en "Reparar base de datos".
Cuando termine, elimina inmediatamente la línea que añadiste del wp-config.php para evitar riesgos de seguridad.

Paso 4: Comprueba los límites del servidor (recurso temporal)

A veces, el error can't connect to mysql server aparece solo en momentos de mucho tráfico. Esto se debe a que tu servidor ha alcanzado el límite de conexiones simultáneas.

No hay una solución mágica en cPanel, pero puedes optimizar tu base de datos. Instala un plugin de caché (como W3 Total Cache o WP Super Cache) para reducir la carga de consultas a MySQL. Esto alivia la presión sobre el servidor.

Solución paso a paso en Plesk

Plesk es otro panel de control muy común, sobre todo en VPS y servidores dedicados. El proceso es similar pero con nombres diferentes.

Paso 1: Accede a la sección de bases de datos

Entra en Plesk.
En el menú de la izquierda, busca tu dominio y haz clic en "Bases de datos" (o "Databases").
Verás la lista de bases de datos asociadas a tu sitio web.

Paso 2: Verifica el usuario y la contraseña

Haz clic en el nombre de la base de datos que utiliza WordPress.
Verás la lista de usuarios que tienen acceso a ella.
Asegúrate de que el usuario que aparece en tu wp-config.php está en esa lista.
Si no recuerdas la contraseña, haz clic en el usuario y selecciona "Cambiar contraseña".

[TIP] En Plesk, el nombre de la base de datos y el usuario suelen tener un prefijo como tuusuario_. Asegúrate de que en wp-config.php escribiste el nombre completo, incluyendo ese prefijo.

Paso 3: Edita el wp-config.php desde el administrador de archivos de Plesk

Plesk también tiene un administrador de archivos, aunque el acceso es un poco distinto.

Ve a "Administrador de archivos" en el menú del dominio.
Navega a la carpeta httpdocs (es el equivalente a public_html).
Busca wp-config.php y edítalo.
Aplica los mismos cambios que explicamos en el paso 1 de cPanel (verificar nombre, usuario y host).

Paso 4: Comprueba el estado del servicio MySQL en Plesk

Si estás en un VPS o servidor dedicado, puedes reiniciar el servicio MySQL desde Plesk.

Ve a "Herramientas y ajustes" (Tools & Settings) en la pantalla principal de Plesk.
Busca la sección "Servidor" y haz clic en "Servicios" (o "Services Management").
Busca el servicio MySQL o MariaDB.
Haz clic en el icono de reiniciar (suele ser un círculo con una flecha).

[WARNING] Reiniciar MySQL provocará una caída de todos los sitios web de tu servidor durante unos segundos. Hazlo con precaución si tienes otros clientes o webs críticas.

Soluciones avanzadas para ambos paneles

Si has llegado hasta aquí y nada funciona, el problema es más profundo. No te desanimes, aún quedan opciones.

1. Revisa el archivo hosts (problema local)

En raras ocasiones, el problema está en tu ordenador, no en el servidor.

En Windows: Abre el Bloc de notas como administrador y abre el archivo C:\Windows\System32\drivers\etc\hosts.
En Mac/Linux: Abre una terminal y escribe sudo nano /etc/hosts.

Busca líneas que contengan localhost o 127.0.0.1. Si hay algo extraño relacionado con tu dominio, bórralo y guarda.

2. Aumenta el límite de memoria de PHP

A veces, el error es un síntoma de falta de memoria.

Accede a tu archivo wp-config.php.
Añade esta línea antes del final del archivo:

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

3. Desactiva plugins y temas (si puedes acceder a wp-admin)

Si el error es intermitente y a veces puedes entrar, intenta desactivar todos los plugins.

Ve a wp-admin/plugins.php.
Selecciona todos y elige "Desactivar" en el menú desplegable.
Si no puedes acceder, renombra la carpeta wp-content/plugins a wp-content/plugins_backup desde el administrador de archivos.

4. Contacta con tu proveedor de hosting

Si después de todo esto el error can't connect to mysql server persiste, es hora de llamar a los profesionales. Pídeles que verifiquen:

Que el servicio MySQL está activo y corriendo.
Que no hay un bloqueo de IP (fail2ban).
Que los logs del servidor no muestran errores críticos.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el panel de control se accede por el puerto 2106. Los pasos para editar la base de datos son idénticos a los de Plesk, pero en lugar de httpdocs, la carpeta raíz se llama public_html. La gestión de bases de datos está en la sección "Bases de datos" del menú lateral.

Preguntas frecuentes (FAQ)

¿Qué es el host de la base de datos en WordPress?

Es la dirección del servidor donde se aloja MySQL. En la mayoría de los hostings compartidos es localhost. En otros casos (como algunos VPS) puede ser 127.0.0.1 o un nombre de dominio interno.

¿Por qué mi web funciona a veces y otras no?

Esto suele indicar que el servidor MySQL se está quedando sin recursos o que está alcanzando el límite de conexiones simultáneas. Prueba a instalar un plugin de caché y contacta con tu hosting para aumentar los límites.

¿Puedo perder mis datos si cambio la contraseña de MySQL?

No. Cambiar la contraseña del usuario de la base de datos no borra ninguna información. Solo cambia la "llave" de acceso. Eso sí, debes actualizar el wp-config.php inmediatamente después.

¿Qué hago si no encuentro el archivo wp-config.php?

Asegúrate de que estás en la carpeta raíz de tu instalación de WordPress (normalmente public_html o httpdocs). Si usas un cliente FTP, activa la opción "Mostrar archivos ocultos", ya que a veces no se ve por defecto.

¿El error "can't connect to mysql server" es lo mismo que "Error establishing a database connection"?

Sí, son equivalentes. El primero es el mensaje técnico que da el servidor, y el segundo es la traducción que hace WordPress para mostrarlo de forma más amigable.

Conclusión

Hemos recorrido todas las causas posibles del temido error can't connect to mysql server. Desde un simple error de contraseña hasta un problema de configuración del servidor, ahora tienes un mapa completo para solucionar mysql wordpress sin entrar en pánico.

Recuerda el orden lógico:

Verifica credenciales (wp-config.php vs panel de control).
Cambia la contraseña y actualiza el archivo.
Repara la base de datos con la herramienta de WordPress.
Revisa los recursos del servidor (memoria, caché).
Contacta con tu hosting si nada funciona.

La clave está en la paciencia y en no hacer cambios a lo loco. Cambia una cosa a la vez y comprueba si la web responde. Con esta guía, ya no tendrás que temer a ese mensaje, porque sabrás exactamente cómo atacarlo. ¡Éxito con tu WordPress!