Errores de conexión a base de datos en Plesk: Soluciones rápidas

Conectar una base de datos en Plesk es una tarea habitual, pero a veces surgen contratiempos que pueden resultar frustrantes, sobre todo si no tienes experiencia técnica. No te preocupes, es más común de lo que crees. En esta guía extensa y muy práctica, vamos a desglosar los errores base de datos más frecuentes, sus causas y, lo más importante, cómo solucionar errores Plesk paso a paso. Al final, serás capaz de diagnosticar y resolver estos problemas de conexión por ti mismo.

[INFO] Esta guía está pensada para usuarios de Plesk (cualquier versión reciente). Si usas otro panel como Syspanel (antes conocido como HestiaCP), recuerda que su puerto de acceso por defecto es el 2106.

Error 1: "Access denied for user" (Acceso denegado para el usuario)

Este es, sin duda, el error de conexión más común. Aparece cuando intentas conectar tu aplicación (WordPress, Joomla, etc.) a la base de datos y el sistema te rechaza.

¿Por qué ocurre?

Contraseña incorrecta: El usuario y la contraseña que has puesto en el archivo de configuración no coinciden con los que creaste en Plesk.
Usuario equivocado: Has copiado mal el nombre de usuario (a veces Plesk añade un prefijo automáticamente, como usuario_bd).
Privilegios insuficientes: El usuario no tiene permisos para acceder a la base de datos específica.

Soluciones paso a paso

Verifica las credenciales en Plesk:
- Inicia sesión en tu panel de Plesk.
- Ve a Bases de Datos.
- Localiza la base de datos que estás usando. Haz clic en el nombre de la base de datos.
- Verás el nombre de usuario asociado. Cópialo exactamente (con mayúsculas/minúsculas y prefijo).
- Si no recuerdas la contraseña, haz clic en Cambiar contraseña y establece una nueva. Anótala en un lugar seguro.
Comprueba tu archivo de configuración:
- Abre el archivo donde tu aplicación guarda los datos de conexión (por ejemplo, wp-config.php en WordPress).
- Busca las líneas:
```
define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'nombre_de_tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');
```
- Asegúrate de que coinciden exactamente con los datos de Plesk. Un simple espacio extra o una mayúscula mal puesta puede provocar el error.
Reasigna privilegios (si es necesario):
- En Plesk, ve a Bases de Datos > haz clic en tu base de datos.
- Busca la sección de Usuarios de base de datos.
- Asegúrate de que el usuario correcto esté marcado y tenga todos los permisos (SELECT, INSERT, UPDATE, DELETE, etc.). Si no, selecciona Añadir usuario o edita los existentes.

[TIP] Si después de cambiar la contraseña sigues teniendo el error, espera unos minutos. A veces el cambio tarda un poco en propagarse.

Error 2: "Can't connect to MySQL server on 'localhost'" (No se puede conectar al servidor MySQL)

Este error indica que tu aplicación no encuentra el servidor de bases de datos en la dirección especificada. Es un problema de conexión a nivel de red o de servicio.

¿Por qué ocurre?

El servicio MySQL/MariaDB está caído: El servidor de bases de datos no se está ejecutando.
El host es incorrecto: A veces, en lugar de localhost, se necesita usar 127.0.0.1 o una IP externa.
Firewall bloqueando el puerto: El puerto por defecto (3306) está siendo bloqueado.

Soluciones paso a paso

Reinicia el servicio desde Plesk:
- En tu panel de Plesk, ve a Herramientas y Configuración.
- En la sección Servicios, busca Administrador de servicios o Servicios del sistema.
- Localiza MySQL o MariaDB (depende de tu servidor).
- Haz clic en Reiniciar. Espera unos segundos y vuelve a intentar la conexión.
Verifica el host en tu configuración:
- En tu archivo de configuración (ej. wp-config.php), cambia 'localhost' por '127.0.0.1'. A veces el sistema de resolución de nombres falla.
- Guarda los cambios y prueba de nuevo.
Comprueba el firewall (si tienes acceso):
- Si tu aplicación está en un servidor externo y tu base de datos en otro, asegúrate de que el puerto 3306 esté abierto en el firewall del servidor de la base de datos.
- En Plesk, puedes usar el Administrador de Firewall (Herramientas y Configuración > Firewall) para permitir conexiones entrantes en ese puerto, pero solo si es necesario.

[WARNING] Abrir el puerto 3306 a todo Internet es un riesgo de seguridad. Si necesitas conexión remota, limita las IPs que pueden acceder.

Error 3: "Unknown database" (Base de datos desconocida)

Este error suele aparecer cuando la aplicación intenta conectarse a una base de datos que no existe o cuyo nombre está mal escrito.

¿Por qué ocurre?

Nombre mal escrito: Un error tipográfico en el nombre de la base de datos.
Base de datos no creada: Olvidaste crearla en Plesk.
Prefijo incorrecto: En Plesk, a menudo se añade un prefijo al nombre de la base de datos (por ejemplo, tuusuario_miweb). Si escribes solo miweb, fallará.

Soluciones paso a paso

Verifica el nombre exacto en Plesk:
- Ve a Bases de Datos en tu panel.
- Localiza la base de datos que quieres usar.
- Copia el nombre exacto (incluyendo cualquier prefijo o guión bajo). Pega ese nombre en tu archivo de configuración.
Crea la base de datos si no existe:
- En Bases de Datos, haz clic en Añadir Base de Datos.
- Dale un nombre descriptivo (por ejemplo, blog_bd).
- Plesk te mostrará el nombre completo (con prefijo). Anótalo.
Asocia un usuario a la base de datos:
- Al crear la base de datos, Plesk te pedirá que crees un usuario o que añadas uno existente. Asegúrate de hacerlo.

Error 4: "Too many connections" (Demasiadas conexiones)

Este error es menos común pero muy molesto. Ocurre cuando el servidor MySQL ha alcanzado el límite máximo de conexiones simultáneas permitidas.

¿Por qué ocurre?

Tu sitio web tiene mucho tráfico: Muchas visitas simultáneas.
Scripts mal optimizados: Plugins de WordPress o código personalizado que no cierran las conexiones correctamente.
Ataque DDoS: Un intento de saturar el servidor.

Soluciones paso a paso

Aumenta el límite de conexiones (si tienes acceso):
- Esto normalmente requiere acceso de administrador del servidor (root). Si usas un hosting compartido, contacta con tu proveedor.
- Desde la línea de comandos (SSH), puedes modificar la variable max_connections en el archivo my.cnf (o my.ini en Windows) y reiniciar MySQL.
Optimiza tu aplicación:
- En WordPress: Desactiva plugins pesados o mal codificados. Usa un plugin de caché (como W3 Total Cache o WP Super Cache) para reducir las consultas a la base de datos.
- Revisa los logs: En Plesk, ve a Herramientas y Configuración > Logs > Log de errores de MySQL. Busca qué script está generando muchas conexiones.
Contacta con tu soporte técnico:
- Si no puedes aumentar el límite, tu proveedor de hosting (o el equipo de soporte de tu servidor) puede hacerlo por ti.

Error 5: "Connection refused" (Conexión rechazada)

Este error es parecido al error 2, pero más específico. El servidor MySQL está funcionando, pero rechaza activamente la conexión.

¿Por qué ocurre?

El host no permite conexiones remotas: MySQL está configurado para escuchar solo en localhost (127.0.0.1) y no en la IP pública.
El usuario no tiene permisos de conexión remota: El usuario de la base de datos solo puede conectarse desde localhost.

Soluciones paso a paso

Cambia el host en tu aplicación:
- Si tu aplicación está en el mismo servidor que la base de datos, usa localhost o 127.0.0.1. No uses la IP pública.
- Si tu aplicación está en otro servidor, necesitas configurar MySQL para aceptar conexiones remotas. Esto es más avanzado y requiere editar el archivo my.cnf y cambiar la línea bind-address = 127.0.0.1 por bind-address = 0.0.0.0. Luego reinicia MySQL.
Concede permisos remotos al usuario:
- En Plesk, al crear o editar un usuario de base de datos, a veces puedes elegir desde qué hosts puede conectarse. Si no ves esta opción, necesitas usar la línea de comandos de MySQL:
```
GRANT ALL PRIVILEGES ON tu_base.* TO 'tu_usuario'@'%' IDENTIFIED BY 'tu_contraseña';
FLUSH PRIVILEGES;
```
  (El % significa cualquier host. Puedes sustituirlo por una IP específica por seguridad).

[WARNING] Permitir conexiones remotas a MySQL expone tu base de datos. Asegúrate de usar contraseñas fuertes y, si es posible, limita las IPs que pueden acceder.

Preguntas frecuentes (FAQ)

¿Cómo puedo probar la conexión a mi base de datos desde Plesk?

Plesk no tiene una herramienta gráfica para probar la conexión directamente, pero puedes usar la herramienta phpMyAdmin (integrada en Plesk) para acceder a la base de datos. Si puedes iniciar sesión en phpMyAdmin con las credenciales, la conexión funciona.

¿Qué hago si olvido la contraseña de mi base de datos en Plesk?

Es muy sencillo. Ve a Bases de Datos > haz clic en tu base de datos > busca el usuario y haz clic en Cambiar contraseña. Establece una nueva y actualízala en tu aplicación.

¿Es lo mismo MySQL que MariaDB en Plesk?

Sí, para el usuario final son prácticamente iguales. MariaDB es un fork de MySQL y es el motor de base de datos por defecto en muchas versiones de Plesk. Los errores y soluciones son los mismos.

¿Puedo usar una base de datos remota con Plesk?

Sí, pero no es recomendable por razones de rendimiento y seguridad. Si lo haces, asegúrate de que tu servidor de Plesk pueda acceder al servidor remoto y que los puertos estén abiertos.

¿Qué significa el error "Table 'nombre_tabla' doesn't exist"?

Este error no es de conexión, sino de estructura. Significa que la tabla a la que intentas acceder no existe en la base de datos. Puede deberse a una migración incompleta o a que la aplicación no ha creado las tablas correctamente. Revisa los logs de errores de tu aplicación.

Consejos finales para evitar problemas de conexión

Siempre anota las credenciales: Cuando crees una base de datos y un usuario, guarda el nombre completo (con prefijo), el usuario y la contraseña en un lugar seguro.
Usa contraseñas fuertes: Evita contraseñas fáciles como "123456" o "password". Plesk suele generar una segura automáticamente.
Haz copias de seguridad regulares: En Plesk, puedes programar copias de seguridad automáticas de tus bases de datos en Herramientas y Configuración > Administrador de Copias de Seguridad.
Actualiza tu aplicación: Mantén tu CMS (WordPress, Joomla, etc.) y sus plugins actualizados. Las versiones antiguas suelen tener errores que generan problemas de conexión.
No compartas las credenciales: Nunca publiques tu nombre de usuario y contraseña de la base de datos en foros o sitios públicos.

[INFO] Si después de seguir todos estos pasos sigues teniendo errores base de datos en Plesk, contacta con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden ayudarte a diagnosticar problemas más profundos.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia y la revisión paso a paso son tus mejores aliadas. ¡Mucho éxito con tu proyecto!