Preguntas frecuentes sobre problemas de conexión a bases de datos en Plesk

Introducción: ¿Por qué falla la conexión a mi base de datos?

Si estás leyendo esto, probablemente te has encontrado con el temido mensaje de error al intentar conectar tu sitio web o aplicación a una base de datos en Plesk. No te preocupes, es una de las consultas más frecuentes que recibimos. La conexión entre tu aplicación y la base de datos es un paso crítico, y un pequeño error de configuración puede bloquear todo.

En esta FAQ extensa, vamos a desglosar los problemas comunes que impiden una conexión exitosa. Los explicaremos de forma sencilla, paso a paso, para que puedas diagnosticarlos y solucionarlos tú mismo. Al final, tendrás una guía de referencia rápida para resolver la mayoría de los incidentes.

[INFO] Esta guía está pensada para usuarios de Plesk. Si usas otro panel como Syspanel (accesible por el puerto 2106), los principios son similares, pero la interfaz varía ligeramente.

1. El error "Access denied for user" (Acceso denegado para el usuario)

Este es, con diferencia, el error más común. Tu aplicación dice que no puede entrar, como si tuviera la llave equivocada.

¿Qué significa?

Que el nombre de usuario o la contraseña que estás usando en el archivo de configuración de tu web (por ejemplo, wp-config.php en WordPress o .env en Laravel) no coinciden con los que están registrados en Plesk.

Solución paso a paso:

Ve a Plesk: Inicia sesión en tu panel de control.
Busca "Bases de Datos": En el menú lateral, localiza la sección de "Bases de Datos" o "Database".
Identifica tu base de datos: Verás una lista. Haz clic en el nombre de la base de datos que estás intentando usar.
Comprueba el usuario: Dentro de la configuración de la base de datos, busca la sección "Usuarios". Ahí aparecerá el nombre de usuario asociado. Normalmente tiene un prefijo como tuusuario_tubasededatos.
Revisa la contraseña: Al lado del usuario, verás un icono de lápiz o un enlace para "Cambiar contraseña". Si no la recuerdas, lo más seguro es crearla de nuevo.
- Recomendación: Usa una contraseña fuerte (mezcla de letras mayúsculas, minúsculas, números y símbolos) y cópiala exactamente a tu archivo de configuración.
Actualiza tu aplicación: Abre el archivo de configuración de tu sitio web (normalmente en /httpdocs o la raíz de tu dominio) y asegúrate de que el nombre de usuario y la contraseña son idénticos a los que has visto en Plesk.

[WARNING] ¡Cuidado con los espacios! Al copiar y pegar contraseñas, a veces se cuela un espacio al principio o al final. Eso es suficiente para que falle la conexión. Pega la contraseña en un editor de texto plano para verificarla.

2. El error "Unknown database" (Base de datos desconocida)

Aquí la aplicación encuentra al usuario, pero no sabe a qué base de datos tiene que ir.

¿Qué significa?

El nombre de la base de datos que has escrito en tu archivo de configuración no existe en Plesk o está mal escrito.

Solución paso a paso:

Verifica el nombre exacto: En Plesk, dentro de la sección "Bases de Datos", observa el nombre de tu base de datos. Suelen tener el formato tuusuario_nombredelabd.
Copia exactamente: Ve a tu archivo de configuración (ej. wp-config.php) y busca la línea que dice define('DB_NAME', '...');. El nombre dentro de las comillas debe coincidir perfectamente con el que ves en Plesk. Las mayúsculas, minúsculas y guiones bajos cuentan.
Caso especial: Si acabas de crear la base de datos, asegúrate de que el proceso de creación haya finalizado correctamente. A veces, un error de red puede hacer que se cree el usuario pero no la base de datos. En ese caso, bórrala y créala de nuevo.

[TIP] Si tienes varias bases de datos, anota en un bloc de notas el nombre exacto de cada una. Es fácil confundir miproyecto_db con miproyecto_bd.

3. El error "Can't connect to MySQL server" (No se puede conectar al servidor MySQL)

Este error indica que tu aplicación no encuentra el servidor de bases de datos.

¿Qué significa?

El "host" o dirección del servidor de bases de datos es incorrecto. En la mayoría de los entornos de hosting compartido con Plesk, el servidor es localhost. Sin embargo, en configuraciones más avanzadas (servidores dedicados, VPS, o ciertos planes de hosting), puede ser una dirección IP o un nombre de dominio como mysql.tudominio.com.

Solución paso a paso:

Comprueba el host en Plesk:
- Ve a "Bases de Datos" y haz clic en el nombre de tu base de datos.
- Busca la sección "Detalles de conexión" o "Información de acceso". Ahí te dirá el servidor.
- Casi siempre será localhost. Si ves otra cosa, escribe esa dirección exactamente.
Actualiza tu aplicación: Busca la línea que define el host. En WordPress es define('DB_HOST', 'localhost');. Cámbialo si es necesario.
Firewall o puertos: Aunque es raro en hosting compartido, en VPS o servidores dedicados, el puerto por defecto de MySQL (3306) podría estar bloqueado por un firewall. Contacta con tu proveedor de hosting si sospechas de esto.

[INFO] Si estás usando Syspanel (puerto 2106), el concepto es el mismo. Busca la sección de bases de datos dentro del panel para ver el host.

4. Problemas con los privilegios del usuario

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para hacer ciertas operaciones (como crear tablas o insertar datos).

Síntomas

Tu aplicación se conecta pero falla al intentar instalar un plugin, actualizar el CMS, o guardar contenido nuevo.

Solución paso a paso:

Accede a los usuarios de la base de datos: En Plesk, dentro de la configuración de tu base de datos, ve a la pestaña "Usuarios".
Edita los privilegios: Haz clic en el usuario problemático. Verás una lista de "Privilegios".
Selecciona todos: Para la mayoría de las aplicaciones web (WordPress, Joomla, Drupal, etc.), el usuario necesita todos los privilegios sobre la base de datos. Marca la casilla de "Todos" o selecciona uno por uno: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, etc.
Guarda los cambios.

[WARNING] No des privilegios de administrador global (GRANT ALL a nivel de servidor) a menos que sepas exactamente lo que haces. Limítate a los privilegios sobre la base de datos específica.

5. Error de versión de PHP o MySQL

A veces el problema no está en la configuración, sino en la compatibilidad.

¿Qué significa?

Tu aplicación fue hecha para una versión antigua de PHP o MySQL, y tu servidor usa una versión más moderna (o viceversa).

Síntomas

La conexión se establece, pero aparecen errores extraños al ejecutar consultas, especialmente con funciones obsoletas.

Solución paso a paso:

Revisa los requisitos de tu aplicación: La documentación de tu CMS o framework te dirá qué versiones de PHP y MySQL soporta.
Cambia la versión de PHP en Plesk: Ve a "Hosting y DNS" > "Configuración de Hosting". Busca la opción "Versión de PHP" y cámbiala a una compatible (por ejemplo, de 8.0 a 7.4 si tu web es muy antigua).
Contacta con soporte para MySQL: En la mayoría de los planes de hosting, no puedes cambiar la versión de MySQL directamente. Si tu aplicación necesita una versión muy específica (ej. MySQL 5.7 en lugar de 8.0), deberás contactar con el soporte técnico de tu proveedor.

6. El error "Connection timed out" (Tiempo de conexión agotado)

La aplicación intenta conectar, pero el servidor de bases de datos no responde a tiempo.

¿Qué significa?

Suele ser un problema de red, de alta carga en el servidor, o de configuración del firewall. Es menos común en entornos de hosting compartido estable.

Solución paso a paso:

Espera e intenta de nuevo: A veces es un pico de tráfico momentáneo. Espera 5 minutos y recarga la página.
Revisa el estado del servicio: En Plesk, ve a "Herramientas y Ajustes" > "Servicios" (o "Services"). Busca "MySQL" o "MariaDB" y asegúrate de que su estado sea "Corriendo" (Running). Si está detenido, puedes intentar iniciarlo, pero si no sabes por qué se detuvo, contacta con soporte.
Configuración de red (avanzado): Si tienes un VPS, verifica que el puerto 3306 no esté bloqueado en el firewall del sistema operativo (como iptables o firewalld).

7. Problemas con la codificación de caracteres (Collation)

Esto no impide la conexión, pero causa que los caracteres especiales (ñ, tildes) se vean raros.

Solución paso a paso:

Configura la codificación en Plesk: Al crear la base de datos, elige utf8_general_ci o utf8mb4_general_ci (recomendado para emojis y caracteres modernos).
Configura la conexión en tu app: Asegúrate de que tu aplicación también use utf8 en la conexión. En WordPress, por ejemplo, se define automáticamente si el servidor lo soporta.

Resumen rápido de la FAQ

Para ayudarte a diagnosticar más rápido, aquí tienes una tabla resumen de los problemas comunes y su causa más probable:

Error en pantalla	Causa más probable	Solución rápida
`Access denied`	Usuario o contraseña incorrectos.	Revisa y actualiza credenciales en Plesk y en tu app.
`Unknown database`	Nombre de BD mal escrito.	Copia el nombre exacto desde Plesk.
`Can't connect to server`	Host incorrecto o servidor caído.	Usa `localhost` o revisa el host en Plesk.
Errores de privilegios	Usuario sin permisos suficientes.	Asigna todos los privilegios en Plesk.
Errores de versión	Incompatibilidad PHP/MySQL.	Cambia la versión de PHP o contacta a soporte.
`Connection timed out`	Servidor sobrecargado o firewall.	Espera, reinicia el servicio o revisa el firewall.

[TIP FINAL] Siempre que tengas un error de base de datos, el primer paso es ir a Plesk y verificar los datos de conexión (nombre, usuario, contraseña y host). El 90% de las veces, el error está ahí. Si después de revisar todo sigues sin poder conectar, no dudes en contactar a nuestro equipo de soporte. ¡Estamos para ayudarte!