Solucionar error de conexión a base de datos en Plesk: FAQ

¿Alguna vez has abierto tu sitio web y te has encontrado con un mensaje como "Error al establecer una conexión a la base de datos" o "Can't connect to local MySQL server"? No te preocupes, es uno de los problemas más comunes en el mundo del hosting, y con Plesk suele tener solución en pocos pasos. En esta guía extensa, te explicaré las causas más frecuentes y, lo más importante, cómo solucionar el error de conexión a base de datos en Plesk paso a paso, sin necesidad de ser un experto en servidores.

Vamos a dividir el artículo en secciones muy claras, con un enfoque de preguntas frecuentes (FAQ) para que encuentres rápido lo que buscas. Recuerda que el objetivo es que tú mismo puedas diagnosticar y reparar el problema.

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

Cuando ves un error de conexión a la base de datos, significa que tu aplicación (WordPress, Joomla, Magento, etc.) no puede comunicarse con el servidor de bases de datos (normalmente MySQL o MariaDB). Las causas pueden ser varias, pero las más comunes son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos no coinciden con los que tiene configurados tu aplicación.
Servicio de base de datos detenido: El motor de MySQL/MariaDB no está funcionando en el servidor.
Puerto incorrecto: Por defecto MySQL usa el puerto 3306, pero a veces se configura otro.
Archivos de configuración dañados: En Plesk, a veces los archivos de configuración de la base de datos se corrompen.
Firewall o reglas de red: El puerto 3306 está bloqueado para conexiones remotas (aunque en el mismo servidor no debería pasar).
Límite de conexiones alcanzado: Demasiadas conexiones simultáneas.

Primeros pasos: diagnóstico rápido

Antes de lanzarte a hacer cambios, es importante que verifiques lo básico. Sigue estos pasos en orden.

1. Verifica que el servicio de base de datos esté activo

Lo primero es asegurarte de que MySQL/MariaDB esté funcionando. Accede a Plesk como administrador o como usuario con permisos de administración.

Ve a Herramientas y Configuración (en el menú de la izquierda).
Busca la sección Servicios y haz clic en Administración de servicios.
Localiza el servicio MySQL o MariaDB (depende de lo que tengas instalado).
Verifica que su estado sea Activo (o "Running"). Si aparece Detenido, haz clic en el botón de inicio (triángulo verde).

[TIP]: Si el servicio se detiene solo, puede ser por falta de memoria o un error en los logs. Anota cualquier mensaje de error que veas.

2. Revisa las credenciales en tu aplicación

El error más común es tener mal escritas las credenciales en el archivo de configuración de tu sitio. Por ejemplo, en WordPress es el archivo wp-config.php.

Accede a Sitios web y dominios.
Haz clic en Administrador de archivos (icono de carpeta).
Busca el archivo de configuración (por ejemplo, wp-config.php).
Ábrelo y busca las líneas que definen:
- DB_NAME (nombre de la base de datos)
- DB_USER (usuario)
- DB_PASSWORD (contraseña)
- DB_HOST (normalmente es localhost o 127.0.0.1)

[WARNING]: Ten mucho cuidado al editar este archivo. No borres ni añadas caracteres extra. Si no estás seguro, copia el contenido a un bloc de notas antes de modificar.

Compara estos valores con los que tienes en Plesk:

Ve a Bases de datos en el panel de tu suscripción.
Haz clic en el nombre de la base de datos que usa tu sitio.
Ahí verás el nombre, el usuario y la contraseña. Si no recuerdas la contraseña, puedes cambiarla desde ese mismo panel (pero luego deberás actualizarla también en el archivo de configuración de tu aplicación).

3. Prueba la conexión desde la línea de comandos (si tienes acceso SSH)

Si te sientes cómodo con la terminal, puedes probar la conexión directamente. Esto te dará un mensaje de error más detallado.

Conéctate a tu servidor por SSH.
Ejecuta: mysql -u tu_usuario -p -h localhost
Te pedirá la contraseña. Si no funciona, prueba con -h 127.0.0.1.

Si el comando falla, el error te dirá si es por credenciales, por servicio caído o por otro motivo.

Soluciones paso a paso para los casos más comunes

Ahora que ya has hecho el diagnóstico, pasemos a las soluciones concretas.

Solución 1: Reiniciar el servicio de base de datos desde Plesk

A veces el servicio se queda colgado. Reiniciarlo limpia procesos temporales.

Ve a Herramientas y Configuración > Administración de servicios.
Marca la casilla junto a MySQL o MariaDB.
Haz clic en Reiniciar (icono de flecha circular).

[INFO]: Esto no borra datos, solo reinicia el motor. Es seguro hacerlo.

Solución 2: Reparar la base de datos desde Plesk

Si la base de datos está corrupta (por ejemplo, por un corte de luz), puedes repararla.

Ve a Bases de datos.
Haz clic en el nombre de la base de datos problemática.
En la parte superior, verás un botón Reparar (o "Check & Repair"). Haz clic.

Esto ejecutará comandos como REPAIR TABLE y CHECK TABLE en todas las tablas. Si hay errores, los corregirá automáticamente.

Solución 3: Cambiar el host de la base de datos

A veces, en lugar de localhost, tu servidor necesita 127.0.0.1 o incluso la IP pública del servidor (si la base de datos está en otro servidor). Prueba a cambiar el valor de DB_HOST en tu archivo de configuración.

Prueba con 127.0.0.1
Prueba con la IP real del servidor (la puedes ver en Plesk > Herramientas y Configuración > Información del servidor)

[WARNING]: Si usas una IP externa, asegúrate de que el puerto 3306 esté abierto en el firewall y de que el usuario de la base de datos tenga permisos para conectarse desde esa IP (en Plesk esto se configura en los privilegios del usuario de la base de datos).

Solución 4: Verificar los logs de errores de MySQL

Los logs son tus mejores amigos. Te dirán exactamente qué está fallando.

Accede por SSH a tu servidor.
Ejecuta: tail -f /var/log/mysql/error.log (la ruta puede variar; en algunos sistemas es /var/log/mariadb/mariadb.log).
Mientras ves los logs, intenta acceder a tu sitio web. Verás aparecer mensajes de error.

Los errores comunes que puedes ver:

Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock': El socket no existe. Suele significar que MySQL no está corriendo o que el archivo de socket está mal configurado.
Access denied for user 'usuario'@'localhost': Contraseña incorrecta.
Too many connections: Límite de conexiones alcanzado. Puedes aumentarlo en el archivo de configuración de MySQL.

Solución 5: Aumentar el límite de conexiones (si ves "Too many connections")

Si tu sitio recibe mucho tráfico, puede que el límite predeterminado (151 conexiones) sea insuficiente.

Accede por SSH.
Edita el archivo de configuración de MySQL: nano /etc/mysql/my.cnf o /etc/my.cnf.
Busca la línea max_connections y cámbiala a un valor más alto, por ejemplo 500.
Guarda y reinicia MySQL: systemctl restart mysql.

[TIP]: No pongas un número excesivo (más de 1000) a menos que tu servidor tenga mucha RAM, porque cada conexión consume memoria.

Solución 6: Reconstruir la configuración de la base de datos desde Plesk

A veces Plesk pierde la configuración de las bases de datos. Puedes forzar una reconstrucción.

Ve a Herramientas y Configuración > Administración de servicios.
Haz clic en Reconfigurar junto a MySQL (o MariaDB). Esto regenerará los archivos de configuración y reiniciará el servicio.

[WARNING]: Esta opción puede tardar unos segundos y dejar el servicio fuera de línea momentáneamente. Asegúrate de que no haya visitas en ese momento.

Preguntas frecuentes (FAQ) sobre errores de conexión a base de datos en Plesk

Aquí tienes las dudas más comunes que resuelven los técnicos de soporte.

¿Por qué mi base de datos funciona en localhost pero no desde otro servidor?

Esto es normal. Por seguridad, Plesk configura las bases de datos para que solo acepten conexiones desde localhost (el mismo servidor). Si necesitas conectarte desde otro servidor (por ejemplo, para usar un gestor remoto), debes:

Crear un usuario de base de datos con privilegios desde cualquier host (especificando % en lugar de localhost).
Abrir el puerto 3306 en el firewall de tu servidor.

[INFO]: No es recomendable por seguridad. Mejor usa un túnel SSH o una VPN.

¿El error puede deberse a que mi plan de hosting ha caducado?

Sí, si tu suscripción ha expirado, Plesk puede desactivar los servicios de base de datos. Revisa el estado de tu cuenta en el panel de facturación.

¿Cómo sé si el problema es de mi código o del servidor?

Prueba a crear una base de datos nueva en Plesk y conectar tu aplicación a ella (cambiando las credenciales en el archivo de configuración). Si funciona, el problema está en la base de datos original (corrupta o con credenciales incorrectas). Si no funciona, el problema es del servidor (servicio caído, firewall, etc.).

¿Puedo usar Syspanel (antes HestiaCP) para gestionar bases de datos?

Si estás migrando desde Syspanel (antiguo HestiaCP) a Plesk, ten en cuenta que el puerto de acceso para Syspanel es el 2106. Pero en Plesk la gestión de bases de datos se hace desde el panel web (puertos 8443 para HTTPS o 8880 para HTTP). No intentes acceder a Syspanel desde Plesk, son paneles diferentes.

¿Qué hago si después de todo sigue sin funcionar?

Si has seguido todos los pasos y el error persiste, puede tratarse de un problema más profundo, como:

Corrupción del sistema de archivos: Pide a tu proveedor de hosting que revise el disco.
Problemas de hardware: Memoria RAM defectuosa o disco duro con errores.
Ataque DDoS: El servidor está sobrecargado.

En ese caso, contacta con el soporte técnico de tu hosting y proporcionales los logs de error que hayas recopilado. Ellos podrán escalar el problema.

Consejos finales para evitar futuros errores

Para que no vuelvas a tener este dolor de cabeza, te dejo algunas buenas prácticas:

Haz copias de seguridad periódicas: En Plesk puedes programar backups automáticos de las bases de datos desde Herramientas y Configuración > Administrador de copias de seguridad.
Mantén actualizado Plesk y las aplicaciones: Las actualizaciones corrigen bugs que pueden causar errores de conexión.
No compartas contraseñas de bases de datos entre sitios: Si un sitio se infecta, puede comprometer los demás.
Monitorea el uso de recursos: En Plesk puedes ver el consumo de CPU y RAM. Si ves picos, puede que necesites más recursos.

[TIP]: Si tu sitio tiene mucho tráfico, considera usar un servicio de base de datos externo (como Amazon RDS) o un servidor de base de datos dedicado, aunque esto ya es para casos más avanzados.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la mayoría de los errores de conexión a base de datos en Plesk se solucionan con los pasos que te he dado: verificar el servicio, revisar credenciales y reparar la base de datos. Si no, ya sabes que los logs son tu mejor aliado.

¡No te rindas! Con paciencia y método, lo resolverás. Y si te surge alguna otra duda, no dudes en consultar la documentación oficial de Plesk o preguntar a tu proveedor de hosting.