Solucionar error de conexión a base de datos en WordPress

¿Por qué WordPress pierde la conexión con MySQL?

Cuando tu sitio web muestra el temido mensaje "Error al establecer una conexión con la base de datos", no significa que hayas perdido tus artículos o tu diseño. Simplemente, WordPress no puede comunicarse con el servidor MySQL donde se almacena toda tu información. Este es uno de los errores más comunes en el mundo del hosting, y la buena noticia es que casi siempre tiene solución.

Antes de entrar en pánico, respira. Este error puede deberse a algo tan simple como un cambio de contraseña, un archivo mal configurado o un servidor de base de datos que se ha detenido. A lo largo de esta guía, te explicaré paso a paso cómo diagnosticar y solucionar el problema, incluso si no tienes experiencia técnica avanzada.

Para entenderlo mejor, imagina que WordPress es una tienda y MySQL es el almacén donde guardas todos tus productos. Si la puerta entre la tienda y el almacén está cerrada con una llave equivocada, no podrás mostrar nada a tus clientes. Eso es exactamente lo que ocurre con este error.

Primeros pasos: verifica si el problema es general o solo tuyo

El primer paso es determinar si el error afecta a todo tu sitio o solo a algunas partes. Esto te dará pistas sobre dónde está el fallo.

Revisa si el error aparece en todo el sitio

Abre tu sitio en una ventana de incógnito de tu navegador. Si el error aparece tanto en la parte pública como en el panel de administración (/wp-admin), el problema es global. Si solo aparece en una página específica, puede ser un plugin o tema el que esté causando el conflicto.

Comprueba el estado de otros sitios en tu mismo hosting

Si tienes otros sitios web en el mismo servidor, revísalos. Si todos presentan el mismo error, es probable que el problema esté en el servidor de bases de datos, no en tu instalación de WordPress. Si solo tu sitio falla, el problema está en la configuración de tu WordPress.

Observa si el error es intermitente

¿El error aparece y desaparece? Esto podría indicar que el servidor de MySQL se está sobrecargando o reiniciando. En ese caso, el problema puede estar en el proveedor de hosting, y deberías contactar con su soporte técnico.

Diagnóstico básico: el archivo wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene los datos de conexión a la base de datos, y cualquier error aquí provocará el fallo que estás viendo. Este archivo se encuentra en la raíz de tu instalación de WordPress.

Cómo localizar y editar wp-config.php

Para acceder a este archivo, necesitas un cliente FTP como FileZilla o el administrador de archivos de tu panel de hosting. Si usas Syspanel (el panel de control que tienes en el puerto 2106), puedes acceder al administrador de archivos directamente desde su interfaz web.

Una vez que tengas acceso, busca el archivo wp-config.php en la carpeta principal de tu sitio. Ábrelo con un editor de texto plano (nunca uses Word o programas similares) y busca las siguientes líneas:

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

Qué debe contener cada campo

DB_NAME: El nombre exacto de tu base de datos. Si la has creado recientemente, verifica que el nombre esté bien escrito.
DB_USER: El usuario que tiene permisos para acceder a esa base de datos.
DB_PASSWORD: La contraseña correspondiente a ese usuario. Es la causa más común de este error.
DB_HOST: Normalmente es localhost, pero en algunos servidores puede ser una dirección IP o un nombre como mysql.tudominio.com.

Cómo verificar tus credenciales

Si no estás seguro de que las credenciales sean correctas, entra en tu panel de hosting (recuerda, Syspanel en el puerto 2106) y busca la sección de bases de datos MySQL. Allí podrás ver todas tus bases de datos, los usuarios asociados y cambiar sus contraseñas.

[TIP] Si cambias la contraseña de la base de datos, asegúrate de actualizarla también en el archivo wp-config.php. De lo contrario, WordPress seguirá intentando conectar con la contraseña antigua.

Solución paso a paso para el error de conexión MySQL

Ahora que ya sabes qué archivo revisar, vamos a la parte práctica. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Verifica que el servidor MySQL esté activo

En muchas ocasiones, el servidor de bases de datos se detiene por un reinicio, falta de recursos o mantenimiento. Para comprobarlo:

Accede a tu panel de hosting (Syspanel en el puerto 2106).
Busca la sección de servicios o estado del servidor.
Localiza el servicio MySQL o MariaDB y verifica que esté "activo" o "en ejecución".

Si está detenido, intenta iniciarlo. Si no puedes, contacta con tu proveedor de hosting, ya que el reinicio de servicios suele requerir acceso de administrador.

Paso 2: Comprueba la sintaxis del wp-config.php

Un error de sintaxis en este archivo puede romper la conexión. Busca:

Que todas las líneas terminen con punto y coma (;).
Que las comillas estén correctamente cerradas.
Que no haya caracteres invisibles o espacios extra.

Si no estás seguro, puedes descargar una copia limpia de WordPress y comparar el archivo wp-config.php de muestra con el tuyo.

Paso 3: Revisa los permisos de la base de datos

A veces, el usuario de la base de datos no tiene todos los permisos necesarios. Esto puede pasar si alguien modificó los privilegios. En tu panel de hosting:

Ve a la sección de bases de datos MySQL.
Selecciona tu base de datos y busca la opción de "usuarios" o "privilegios".
Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.).

[WARNING] Si el usuario solo tiene permisos de lectura (SELECT), WordPress podrá mostrar el contenido, pero fallará al guardar comentarios o publicar entradas.

Paso 4: Cambia la contraseña y actualiza el archivo

Esta es una solución clásica y efectiva. A veces, la contraseña se corrompe o se cambia sin que lo notes. Para hacerlo:

Entra en la sección de bases de datos de tu hosting.
Cambia la contraseña del usuario asociado a tu base de datos.
Actualiza el archivo wp-config.php con la nueva contraseña.
Guarda los cambios y sube el archivo de nuevo al servidor.

Paso 5: Prueba con el host de base de datos alternativo

Si tu DB_HOST está configurado como localhost, puedes probar a cambiarlo por 127.0.0.1. Aunque parezcan lo mismo, en algunos servidores funcionan de manera diferente. También puedes probar con el nombre del servidor MySQL que aparece en tu panel de hosting.

Paso 6: Repara la base de datos

WordPress tiene una función de reparación automática que puede solucionar tablas corruptas. Para activarla:

Añade la siguiente línea a tu wp-config.php, justo antes de la línea que dice That's all, stop editing!:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y visita https://tudominio.com/wp-admin/maint/repair.php.
Haz clic en "Reparar base de datos".
Cuando termine, elimina esa línea del archivo wp-config.php y guarda los cambios.

[INFO] Esta función no debe dejarse activa permanentemente, ya que supone un riesgo de seguridad.

Paso 7: Desactiva plugins y temas mediante FTP

Si el error comenzó después de instalar un plugin o cambiar de tema, es posible que estén causando un conflicto. Para desactivarlos:

Accede a tu sitio por FTP.
Renombra la carpeta wp-content/plugins a wp-content/plugins_bak.
Intenta acceder a tu sitio. Si funciona, el problema está en un plugin.
Ve renombrando los plugins uno a uno para identificar al culpable.

Si el problema persiste, haz lo mismo con la carpeta wp-content/themes, renombrándola a themes_bak.

Errores comunes y sus soluciones rápidas

Aquí tienes una lista de errores específicos que puedes encontrar y cómo resolverlos:

"Error al establecer una conexión con la base de datos"

Este es el mensaje genérico. Sigue todos los pasos anteriores, pero empieza por verificar las credenciales en wp-config.php.

"One or more database tables are unavailable"

Este error indica que algunas tablas están dañadas. Usa la función de reparación del Paso 6.

"Access denied for user"

Este mensaje indica que el usuario o la contraseña son incorrectos. Ve al Paso 4 y cambia la contraseña.

"Unknown database"

El nombre de la base de datos es incorrecto. Verifica que DB_NAME coincida exactamente con el nombre que aparece en tu panel de hosting.

"Can't connect to local MySQL server through socket"

Este error suele aparecer cuando el servidor MySQL no está en ejecución o el socket no es accesible. Contacta con tu proveedor de hosting.

Cómo prevenir futuros errores de conexión

La prevención es la mejor estrategia. Aquí tienes algunas buenas prácticas:

Realiza copias de seguridad periódicas

Guarda copias de tu sitio y de tu base de datos regularmente. Así, si algo falla, podrás restaurar todo en minutos.

Mantén WordPress actualizado

Las actualizaciones corrigen errores y vulnerabilidades que pueden causar problemas de conexión.

Documenta tus credenciales

Guarda en un lugar seguro el nombre de tu base de datos, usuario y contraseña. Te será muy útil cuando necesites hacer cambios.

Utiliza contraseñas seguras

Evita contraseñas fáciles de adivinar. Una contraseña robusta reduce el riesgo de ataques que puedan corromper la base de datos.

[TIP] Si usas Syspanel (puerto 2106), aprovecha su herramienta de copias de seguridad automáticas. Configúrala para que se ejecute al menos una vez por semana.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si falla la conexión?

No. El error de conexión no borra tus datos. Solo impide que WordPress acceda a ellos. Una vez solucionado el problema, todo volverá a estar en su lugar.

¿Necesito ser un experto para solucionar este error?

No. La mayoría de las soluciones requieren solo acceder a tu panel de hosting y editar un archivo de texto. Si sigues esta guía paso a paso, podrás resolverlo sin conocimientos avanzados.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Cambiar una contraseña y actualizar el archivo puede llevar menos de 10 minutos. Si el problema es más complejo, como una base de datos corrupta, puede llevar un poco más.

¿Debo contactar con mi proveedor de hosting?

Si después de seguir todos los pasos el error persiste, sí. El problema puede estar en el servidor, y solo ellos pueden solucionarlo. Cuando les escribas, incluye los pasos que ya has probado para que puedan ayudarte más rápido.

Conclusión

El error de conexión a la base de datos en WordPress puede ser frustrante, pero en la gran mayoría de los casos tiene una solución sencilla. Hemos visto cómo revisar el archivo wp-config.php, verificar las credenciales, comprobar el estado del servidor MySQL y aplicar soluciones como la reparación de tablas o la desactivación de plugins.

Recuerda siempre empezar por lo más simple: verificar que las credenciales sean correctas y que el servidor de bases de datos esté activo. Si no encuentras el problema, no dudes en contactar con tu proveedor de hosting, ya que ellos tienen acceso a herramientas y registros que tú no puedes ver.

Con esta guía, ya tienes el conocimiento para enfrentarte a este problema con confianza. La próxima vez que veas el temido mensaje, sabrás exactamente qué hacer para recuperar tu sitio web. Y si todo falla, siempre puedes recurrir a las copias de seguridad para restaurar tu sitio a un estado anterior.