Error Conexión MySQL WordPress | Solución Paso a Paso

¡Hola! Si estás leyendo esto, probablemente te has encontrado con el temido mensaje "Error establishing a database connection" o el más técnico "Can't connect to MySQL server" en tu sitio WordPress. No te preocupes, es uno de los errores más comunes y, en la mayoría de los casos, tiene solución en pocos minutos.

Este error significa que WordPress no puede comunicarse con tu base de datos, donde se almacenan todas tus publicaciones, páginas, comentarios y configuraciones. Sin esa conexión, tu sitio no puede cargar ningún contenido.

En esta guía extensa y paso a paso, vamos a desglosar cómo solucionar el error de conexión MySQL en WordPress de forma clara y sencilla, incluso si no eres un experto en tecnología. Vamos a ir desde lo más simple (y frecuente) hasta lo más complejo.

1. Lo Primero: No Entres en Pánico y Haz una Copia de Seguridad

Antes de tocar nada, respira. Este error no significa que hayas perdido tus datos. Tu base de datos sigue ahí, solo que WordPress no puede "hablar" con ella.

[WARNING] No modifiques archivos sin antes tener una copia de seguridad. Si cometes un error al editar archivos de configuración, podrías empeorar la situación. Si tienes acceso a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.), busca la opción de "Copias de seguridad" o "Backups" y crea una. Si no sabes cómo, contacta con tu proveedor de hosting para que te ayude a hacer una copia de seguridad completa de tu sitio y tu base de datos.

2. La Causa Más Común: Credenciales Incorrectas en `wp-config.php`

En el 90% de los casos, este error se debe a que la información de conexión a la base de datos en tu archivo de configuración principal es incorrecta. Esto puede pasar después de mover el sitio a otro servidor, después de un cambio de contraseña de la base de datos, o simplemente por un error al escribirlo.

### ¿Cómo encontrar y editar el archivo wp-config.php?

Este archivo es el corazón de la configuración de WordPress. Está en la raíz de tu instalación, es decir, en la carpeta principal donde están los archivos de WordPress.

Accede a tu hosting por FTP usando un cliente como FileZilla, o a través del Administrador de Archivos de tu panel de control (cPanel, Syspanel, etc.).
Navega hasta la carpeta donde está instalado WordPress (normalmente es public_html, htdocs o www).
Busca el archivo llamado wp-config.php.
Ábrelo con un editor de texto (como el Bloc de notas o un editor de código).

### ¿Qué debo buscar y corregir?

Dentro del archivo, busca las líneas que empiezan con define. Necesitas verificar estos tres datos:

DB_NAME: Es el nombre de tu base de datos.
DB_USER: Es el nombre de usuario de la base de datos.
DB_PASSWORD: Es la contraseña de ese usuario.

Asegúrate de que estos valores sean exactamente los mismos que tienes en tu panel de hosting. Un error tipográfico (una letra mayúscula de más, un espacio) es suficiente para romper la conexión.

[TIP] Si no recuerdas tus credenciales de la base de datos, entra en tu panel de control de hosting. Busca la sección de "Bases de Datos MySQL" o similar. Ahí podrás ver el nombre de la base de datos y el usuario. A menudo, tendrás que restablecer la contraseña desde ahí para asegurarte de cuál es la correcta.

[WARNING] Nunca cambies el prefijo de las tablas ($table_prefix) a menos que sepas lo que estás haciendo. Si lo cambias sin migrar los datos, tu sitio se romperá por completo.

3. El Host de la Base de Datos: No Siempre es "localhost"

Otro punto de fallo es el valor de DB_HOST. En muchos servidores de hosting compartido, este valor es localhost. Sin embargo, en configuraciones más avanzadas, o si tu base de datos está en un servidor separado (como en la nube), el host puede ser una dirección IP o un nombre de dominio como mysql.sudominio.com.

### ¿Cómo saber cuál es el host correcto?

Revisa la documentación de tu proveedor de hosting. A menudo, envían un correo de bienvenida con estos datos.
En tu panel de control de hosting (como Syspanel, que se accede por el puerto 2106), busca la sección de bases de datos. A veces, junto al nombre de la base de datos, se indica el host.
Si tu hosting es de tipo "compartido", lo más probable es que sea localhost. Pero si no funciona, prueba con 127.0.0.1 (es la dirección IP de localhost). A veces, esto soluciona el problema si hay problemas con la resolución de nombres.

[INFO] En Syspanel (el panel de control que mencionamos), puedes encontrar todos los detalles de tu base de datos en la sección "Bases de Datos". Recuerda que el acceso a este panel es a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Ahí podrás ver el host, el usuario y el nombre de la base de datos.

4. El Servidor MySQL Está Caído o Sobrecargado

A veces, el problema no es tu configuración, sino el propio servidor de bases de datos. El servidor MySQL puede estar caído, reiniciándose, o simplemente sobrecargado por demasiadas conexiones.

### ¿Cómo comprobarlo?

Entra en tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).
Busca la sección de "Estado del Servidor" o "Información del Sistema".
Si ves que el servicio MySQL/MariaDB no está activo o está "down", intenta reiniciarlo desde el propio panel. Normalmente hay un botón para "Reiniciar" o "Iniciar" el servicio.

[WARNING] Si no encuentras la opción de reiniciar el servicio MySQL, no fuerces la situación. Contacta con el soporte de tu hosting. Ellos son los únicos que pueden reiniciar servicios a nivel de servidor sin riesgo de causar más problemas.

5. Problemas de Permisos: El Usuario No Tiene Acceso a la Base de Datos

Es posible que las credenciales sean correctas, pero que el usuario de la base de datos no tenga los permisos necesarios para acceder a ella. Esto es más común después de una migración o una restauración de una copia de seguridad.

### ¿Cómo verificar los permisos?

Accede a tu panel de control de hosting.
Ve a la sección de "Bases de Datos MySQL".
Busca la opción para "Administrar usuarios" o "Añadir usuario a base de datos".
Asegúrate de que el usuario que estás usando en wp-config.php esté asociado a la base de datos correcta y que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Si no lo está, añade el usuario a la base de datos y selecciona "Todos los privilegios".

6. Archivos Corruptos o Tablas Dañadas en la Base de Datos

Otra posibilidad es que la propia base de datos tenga tablas dañadas. Esto puede ocurrir por cortes de energía, errores durante una actualización o ataques maliciosos.

### ¿Cómo reparar las tablas?

Puedes usar la herramienta wp-admin o phpMyAdmin.

Opción A: Usando phpMyAdmin (la más común)

Entra en tu panel de control de hosting y busca "phpMyAdmin".
Selecciona tu base de datos en el panel izquierdo.
Verás una lista de tablas. Selecciona todas.
En el menú desplegable de abajo (que dice "Con selección:"), elige "Reparar tabla".
Esto intentará arreglar cualquier tabla dañada.

Opción B: Usando WP-CLI (si tienes acceso SSH)

Si eres más avanzado y tienes acceso SSH, puedes usar el comando:

wp db repair

[INFO] Esta acción es segura y no borra datos. Simplemente intenta reconstruir la estructura de las tablas para que vuelvan a funcionar correctamente.

7. El Archivo `.maintenance` Está Bloqueando el Acceso

Este es un pequeño archivo temporal que WordPress crea durante una actualización automática. Si el proceso de actualización falla y se queda a medias, este archivo puede quedarse, haciendo que WordPress muestre un mensaje de error y no se conecte correctamente a la base de datos.

### ¿Cómo solucionarlo?

Accede a tu sitio por FTP o al Administrador de Archivos del hosting.
Busca un archivo llamado .maintenance en la carpeta raíz de WordPress.
Si existe, bórralo. Es un archivo temporal y es seguro eliminarlo.

8. Problemas con el Firewall o el Plugin de Seguridad

En raras ocasiones, un firewall de seguridad (como Wordfence o Sucuri) o un plugin de caché mal configurado puede estar bloqueando la conexión a la base de datos. Esto es especialmente probable si cambiaste recientemente la configuración de uno de estos plugins.

### ¿Cómo descartar esto?

Renombra la carpeta de plugins. Accede por FTP a wp-content y renombra la carpeta plugins a plugins_old. Esto desactiva todos los plugins de golpe.
Intenta acceder a tu sitio. Si el error desaparece, el problema era un plugin.
Para encontrar el culpable, renombra la carpeta de nuevo a plugins y luego ve renombrando los plugins de uno en uno dentro de la carpeta (por ejemplo, plugin1 a plugin1_old) hasta que el error desaparezca. El último que renombraste es el problemático.

9. Verificar la Configuración del Servidor (PHP y MySQL)

A veces, el problema es una incompatibilidad de versiones. Por ejemplo, si tu WordPress es muy antiguo y tu servidor tiene una versión de PHP muy nueva (o viceversa), pueden surgir problemas de conexión.

### ¿Qué puedo hacer?

En tu panel de control de hosting, busca la sección "Gestión de PHP" o "Select PHP Version".
Asegúrate de que estás usando una versión de PHP compatible con tu versión de WordPress. Generalmente, las versiones 7.4, 8.0, 8.1 y 8.2 son seguras.
Si cambiaste la versión de PHP recientemente, intenta volver a la anterior para ver si el error se soluciona.

10. El Último Recurso: Contactar con tu Proveedor de Hosting

Si has seguido todos los pasos anteriores y el error persiste, es hora de pedir ayuda profesional. El problema puede estar en un nivel más profundo del servidor que no puedes ver o modificar.

### ¿Qué información debo proporcionar al soporte?

Para que te ayuden rápido, ten a mano esta información:

El mensaje de error exacto que ves.
La URL de tu sitio web.
Los pasos que ya has intentado (para que no te hagan repetir).
Si recientemente hiciste algún cambio en el hosting, en el sitio o en la base de datos.

Preguntas Frecuentes (FAQ) sobre el Error de Conexión MySQL en WordPress

P: ¿Este error afecta a mis visitantes?
R: Sí, mientras el error esté activo, tu sitio mostrará un mensaje de error en lugar de tu contenido. Es un problema crítico que debe resolverse lo antes posible.

P: ¿Perderé mis datos si intento arreglar esto?
R: No, siempre que sigas las instrucciones y no modifiques ni borres la base de datos. Los pasos descritos aquí (como reparar tablas o borrar el archivo .maintenance) son seguros.

P: ¿Puedo usar el mismo usuario de la base de datos para dos sitios web?
R: Sí, es posible, pero no es recomendable. Si un sitio tiene un problema de seguridad, el otro también se verá comprometido. Es mejor tener una base de datos y un usuario únicos por sitio.

P: ¿Qué es DB_HOST y por qué no puedo usar localhost?
R: DB_HOST es la dirección del servidor donde se encuentra tu base de datos. En la mayoría de los hostings compartidos es localhost, pero en servidores más complejos, puede ser una dirección IP o un nombre de dominio. Consulta la documentación de tu hosting para saber el valor correcto.

P: Mi hosting usa Syspanel. ¿Cómo accedo a la información de la base de datos?
R: Accede a tu Syspanel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Una vez dentro, busca la sección de "Bases de Datos". Ahí encontrarás toda la información que necesitas: nombre de la base de datos, usuario, contraseña (a veces tendrás que restablecerla) y el host.

Conclusión

El error "Can't connect to MySQL server" en WordPress puede parecer aterrador, pero como has visto, casi siempre tiene una solución clara y lógica. La clave es ir paso a paso, sin prisas y con una copia de seguridad a mano.

La mayoría de las veces, el problema se resuelve corrigiendo las credenciales en el archivo wp-config.php o reiniciando el servicio MySQL desde el panel de control. Si has llegado al final de esta guía sin éxito, no dudes en contactar con el soporte de tu hosting, que es quien tiene la última palabra sobre la configuración del servidor.

Esperamos que esta guía te haya sido de gran ayuda. ¡Mucha suerte con tu sitio web!