Errores de conexión MySQL en WordPress: Soluciones paso a paso

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque tu sitio web con WordPress te ha dado el temido mensaje de "Error al establecer una conexión con la base de datos". No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía extensa y paso a paso, vamos a desglosar los errores comunes al conectar MySQL en WordPress y, lo más importante, cómo solucionarlos. Vamos allá.

¿Por qué ocurre el error de conexión MySQL en WordPress?

Para entenderlo, imagina que tu WordPress es una tienda y la base de datos WordPress es el almacén donde guardas todos los productos (artículos, páginas, usuarios, comentarios). Si la puerta del almacén está cerrada o la llave no es la correcta, no podrás atender a tus clientes. El error de conexión MySQL significa que WordPress no puede encontrar o acceder a ese almacén.

Las causas más frecuentes suelen ser:

Datos de conexión incorrectos en el archivo de configuración.
El servidor de base de datos (MySQL) está caído o no responde.
Problemas de permisos del usuario de la base de datos.
El servidor de hosting tiene un cortafuegos bloqueando el puerto.
Archivos corruptos o modificados de WordPress.

Vamos a ver cada uno con su solución detallada.

Error 1: Datos incorrectos en wp-config.php

Este es el error más habitual. El archivo wp-config.php contiene las credenciales para que WordPress se conecte a MySQL. Si alguna está mal, la conexión falla.

Síntomas

Aparece el mensaje: "Error al establecer una conexión con la base de datos".
A veces también: "Error de conexión a la base de datos" o "No se puede seleccionar la base de datos".

Solución paso a paso

Accede a tu hosting mediante FTP o el administrador de archivos del panel de control (por ejemplo, cPanel o Syspanel). Si usas Syspanel, recuerda que el puerto de acceso es el 2106.
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress (normalmente en public_html o www).
Abre el archivo con un editor de texto (como el Bloc de notas o un editor de código sin formato).

Busca estas líneas:

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

Verifica que los datos sean correctos. Si no los recuerdas, puedes obtenerlos desde el panel de tu hosting:
- En Syspanel: Ve a "Base de Datos" y allí verás el nombre, usuario y contraseña de tu base de datos.
- En cPanel: Busca "Bases de Datos MySQL" y luego "Usuarios MySQL".
Presta especial atención a DB_HOST. Aunque la mayoría de veces es localhost, algunos proveedores usan direcciones como 127.0.0.1 o un nombre de servidor específico (ej: mysql.tu-dominio.com). Si lo cambiaste o no estás seguro, consulta con tu soporte de hosting.
Guarda el archivo y vuelve a cargar tu sitio.

[TIP] Si después de corregir los datos sigues viendo el error, puede que el archivo esté corrupto. Descarga una copia limpia de WordPress y reemplaza solo el wp-config.php (sin tocar la carpeta wp-content).

Error 2: El servidor MySQL está caído o no responde

A veces el problema no está en tu configuración, sino en el servidor que aloja la base de datos. Esto puede ocurrir por mantenimiento, sobrecarga o un fallo temporal.

Síntomas

El error aparece de repente sin que hayas modificado nada.
Otros sitios en el mismo hosting también tienen problemas.
No puedes acceder a phpMyAdmin ni a herramientas de base de datos.

Solución paso a paso

Comprueba el estado del servidor desde tu panel de hosting. En Syspanel, busca "Servicios" o "Estado del servidor". Si ves que MySQL aparece como "Detenido" o "Error", intenta reiniciarlo.
Reinicia el servicio MySQL:
- En Syspanel: Ve a "Servicios" → busca "MySQL" → haz clic en "Reiniciar".
- En cPanel: Ve a "Servicios" → "MySQL" → "Reiniciar".
Espera unos minutos y vuelve a cargar tu web.
Si no puedes reiniciarlo, contacta con el soporte técnico de tu hosting. Ellos pueden verificar si hay un problema mayor.

[WARNING] Nunca intentes reiniciar servicios si no tienes permisos de administrador. En un hosting compartido, solo el soporte puede hacerlo.

Error 3: Permisos incorrectos del usuario de la base de datos

Cada usuario de base de datos tiene permisos específicos (SELECT, INSERT, UPDATE, DELETE, etc.). Si el usuario que usa WordPress no tiene los permisos necesarios, la conexión falla.

Síntomas

Aparece "Error de conexión a la base de datos" o "Acceso denegado para el usuario".
A veces el error es: "No hay privilegios para crear/drop tablas".

Solución paso a paso

Accede a phpMyAdmin desde tu panel de hosting. En Syspanel, ve a "Base de Datos" → "phpMyAdmin". El puerto de acceso a Syspanel es el 2106.
Selecciona la base de datos que usa tu WordPress (la que aparece en DB_NAME).
Ve a la pestaña "Privilegios" (o "Usuarios").
Busca el usuario que coincide con DB_USER.
Edita sus privilegios y asegúrate de que tenga marcados al menos:
- SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP (para funcionamiento normal).
- A veces basta con marcar "TODOS LOS PRIVILEGIOS".
Guarda los cambios y prueba tu web.

[INFO] Si no ves la opción de editar privilegios, es posible que tu usuario no tenga permisos de administrador sobre esa base de datos. En ese caso, desde el panel de hosting (Syspanel o cPanel) puedes "Agregar usuario a la base de datos" y asignarle todos los privilegios.

Error 4: Puerto de conexión MySQL incorrecto o bloqueado

Por defecto, MySQL usa el puerto 3306. Sin embargo, algunos proveedores de hosting usan puertos alternativos por seguridad. Si el puerto está bloqueado por un cortafuegos o es incorrecto, la conexión falla.

Síntomas

El error dice: "No se puede conectar al servidor MySQL en 'localhost:3307'" (o cualquier otro número).
O simplemente "Conexión rechazada".

Solución paso a paso

Verifica el puerto en la configuración de tu hosting. En Syspanel, ve a "Base de Datos" → "Información de conexión". Allí suele aparecer el puerto (ej: localhost:3306 o localhost:3307).
Edita wp-config.php para incluir el puerto correcto. Por ejemplo:
```
define('DB_HOST', 'localhost:3307');
```
A veces el host es una IP como 127.0.0.1:3307.
Si el puerto es el estándar (3306), pero el error persiste, puede que tu hosting tenga un cortafuegos bloqueando conexiones externas. En ese caso, contacta con soporte.
Prueba cambiando DB_HOST a 127.0.0.1 en lugar de localhost. En algunos entornos, esto resuelve problemas de resolución de nombres.

[TIP] Si usas Syspanel, el puerto de acceso al panel es el 2106, pero el de MySQL suele ser el 3306. No los confundas.

Error 5: Archivos de WordPress corruptos o modificados

A veces, una actualización fallida, un plugin malicioso o un ataque pueden dañar archivos clave de WordPress, incluyendo los que gestionan la conexión a la base de datos.

Síntomas

El error aparece después de instalar un plugin o tema.
La web muestra código PHP en lugar del sitio.
El error es intermitente.

Solución paso a paso

Desactiva todos los plugins (si puedes acceder al panel de administración). Si no, renombra la carpeta wp-content/plugins a wp-content/plugins_old desde FTP. Esto desactivará todos los plugins.
Cambia temporalmente al tema por defecto (Twenty Twenty-Four o similar). Renombra la carpeta de tu tema activo en wp-content/themes para forzar el cambio.
Reemplaza los archivos principales de WordPress (sin tocar wp-content ni wp-config.php). Descarga una copia limpia de WordPress desde wordpress.org, descomprímela y sube las carpetas wp-admin y wp-includes mediante FTP, sobrescribiendo las existentes.
Vuelve a probar tu web.

[WARNING] Si no estás seguro de qué archivos reemplazar, mejor haz una copia de seguridad completa antes. Un error podría empeorar la situación.

Error 6: Problemas con el cacheo de DNS o de la web

A veces, el error es temporal y se debe a que tu navegador o un plugin de caché guardó una versión antigua de la página.

Síntomas

El error aparece solo en tu navegador, pero otros usuarios ven la web bien.
Al usar el modo incógnito, el error desaparece.

Solución paso a paso

Limpia la caché de tu navegador (historial, cookies, archivos temporales).
Prueba en modo incógnito o con otro navegador.
Si usas un plugin de caché (como W3 Total Cache), accede a tu hosting por FTP y renombra la carpeta wp-content/cache a wp-content/cache_old para forzar la limpieza.
Reinicia tu conexión a Internet o cambia de red (por ejemplo, usa datos móviles) para descartar problemas de DNS local.

Preguntas frecuentes (FAQ)

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

A veces el archivo está oculto. Activa la opción "Mostrar archivos ocultos" en tu cliente FTP o en el administrador de archivos. Si no existe, puedes crearlo a partir del archivo wp-config-sample.php que viene con WordPress. Copia ese archivo, renómbralo a wp-config.php y edita los datos.

¿Puedo cambiar la contraseña de la base de datos desde el panel de hosting?

Sí, pero ten cuidado. Si cambias la contraseña desde el panel (Syspanel o cPanel), también debes actualizarla en el wp-config.php. De lo contrario, el error persistirá.

¿Qué significa "Error de conexión a la base de datos" en el móvil?

Es el mismo error, solo que lo ves desde un dispositivo móvil. Las soluciones son idénticas.

¿Necesito conocimientos técnicos para solucionarlo?

No, con seguir los pasos de esta guía podrás resolver la mayoría de los casos. Si te sientes inseguro, siempre puedes pedir ayuda al soporte técnico de tu hosting.

¿El error puede deberse a un ataque?

Sí, aunque es menos común. Si después de seguir todos los pasos el error persiste, revisa si hay archivos extraños en tu instalación o si tu web ha sido marcada como comprometida. En ese caso, contacta con tu proveedor de hosting.

Resumen y consejo final

Recuerda que la mayoría de los errores comunes al conectar MySQL en WordPress se solucionan revisando el archivo wp-config.php, verificando que el servidor MySQL esté activo y que los permisos del usuario sean correctos. Si después de todo esto el problema continúa, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo a los servicios y pueden diagnosticar problemas más profundos.

Espero que esta guía te haya sido de gran ayuda. Si tienes alguna otra duda, aquí estoy para asistirte. ¡Buena suerte con tu WordPress!