Error de base de datos en PrestaShop en Plesk: Solución

¡Hola! Soy tu técnico de soporte amigable. 😊 Hoy vamos a desbloquear uno de los problemas más comunes que enfrentan los dueños de tiendas PrestaShop: el molesto error de conexión de base de datos alojadas en Plesk. No te preocupes, aquí te guiaré paso a paso para que puedas resolverlo tú mismo, sin necesidad de ser un experto en servidores. Vamos a ello.

¿Por qué aparece este error en PrestaShop?

Cuando tu tienda PrestaShop muestra un mensaje como "Error de conexión a la base de datos" o "No se puede conectar al servidor de la base de datos", significa que tu aplicación no puede comunicarse con el motor de base de datos (MySQL/MariaDB) que gestionas desde Plesk. Esto puede deberse a varias causas, desde credenciales incorrectas hasta problemas de configuración del servidor.

Las razones más frecuentes son:

Contraseña de la base de datos mal escrita o caducada.
Usuario de base de datos no asignado correctamente a la base de datos en Plesk.
Puerto de conexión incorrecto (por defecto suele ser 3306, pero a veces cambia).
El servicio de MySQL/MariaDB está detenido en el servidor.
Firewall bloqueando la conexión.
Archivo de configuración parameters.php o app/config/parameters.php de PrestaShop con datos erróneos.

Paso 1: Verifica las credenciales en Plesk

Lo primero es asegurarte de que los datos de acceso a la base de datos que usa PrestaShop sean correctos. Para ello, accede a tu panel Plesk.

### ¿Cómo encontrar los datos de la base de datos en Plesk?

Inicia sesión en tu panel Plesk (normalmente en https://tudominio.com:8443 o la URL que te haya proporcionado tu hosting).
Ve a Bases de datos en el menú de la izquierda. Si no lo ves, busca en Sitios web y dominios y luego en la sección de bases de datos.
Localiza la base de datos que usa tu PrestaShop. Normalmente tiene un nombre como tuusuario_prestashop.
Haz clic en el nombre de la base de datos para ver los detalles.
Anota el nombre de la base de datos, el usuario y la contraseña. Si no recuerdas la contraseña, puedes cambiarla desde aquí mismo (ver subpaso).

[TIP] Si cambias la contraseña en Plesk, recuerda actualizarla también en el archivo de configuración de PrestaShop.

Paso 2: Revisa el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php. Debes asegurarte de que coincidan exactamente con los que tienes en Plesk.

### ¿Dónde está el archivo?

El archivo se encuentra en la raíz de tu instalación de PrestaShop, dentro de la carpeta app/config/. Por ejemplo:
/var/www/vhosts/tudominio.com/httpdocs/app/config/parameters.php

Si usas una versión antigua de PrestaShop (1.6 o inferior), el archivo se llama settings.inc.php y está en config/settings.inc.php.

### ¿Qué debes revisar?

Abre el archivo con un editor de texto (puedes usar el Administrador de archivos de Plesk o FTP). Busca estas líneas:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'contraseña',

Comprueba que:

database_host sea localhost o la IP del servidor de base de datos (si está en otro servidor). En la mayoría de los casos en Plesk es localhost.
database_port sea 3306 (a menos que tu hosting use otro puerto, lo cual es raro).
database_name, database_user y database_password coincidan exactamente con los datos de Plesk (respeta mayúsculas y minúsculas).

[WARNING] Si editas el archivo manualmente, asegúrate de no borrar comillas ni puntos y coma. Un solo error de sintaxis puede romper la tienda.

Paso 3: Asegura que el usuario de base de datos esté asignado correctamente

En Plesk, cada base de datos puede tener varios usuarios, pero el usuario que usa PrestaShop debe estar vinculado a esa base de datos específica.

### Cómo verificar la asignación:

En Plesk, ve a Bases de datos y haz clic en el nombre de tu base de datos.
Busca la sección Usuarios o Usuarios de base de datos.
Deberías ver el nombre de usuario que tienes en tu archivo parameters.php.
Si no aparece, debes añadirlo: haz clic en Añadir usuario y selecciona el usuario existente (o crea uno nuevo) y asígnalo a la base de datos.
Si aparece pero no está seleccionado, márcalo y guarda los cambios.

[INFO] A veces el usuario se crea automáticamente al instalar PrestaShop, pero si lo borraste sin querer, este paso es clave.

Paso 4: Comprueba que el servicio de base de datos esté activo

A veces el problema no es de configuración, sino que el motor de base de datos (MySQL o MariaDB) se ha detenido en el servidor.

### ¿Cómo verificarlo desde Plesk?

En el panel de Plesk, ve a Herramientas y configuraciones (en la parte inferior).
Busca Servicios o Administrador de servicios.
Localiza el servicio MySQL o MariaDB.
Verifica que su estado sea Activo (Running). Si está detenido, haz clic en Iniciar.

[TIP] Si no tienes acceso a esta opción, contacta con tu proveedor de hosting para que lo reinicien. Es una operación sencilla.

Paso 5: Prueba la conexión manualmente

Si todo lo anterior parece correcto, podemos hacer una prueba directa desde el servidor para descartar problemas de red o de firewall.

### Conexión desde la línea de comandos (SSH):

Si tienes acceso SSH a tu servidor (y te sientes cómodo usándolo), ejecuta:

mysql -u usuario_base_datos -p -h localhost nombre_base_datos

Te pedirá la contraseña. Si la conexión es exitosa, verás el prompt de MySQL. Si no, recibirás un mensaje de error que te dará pistas (por ejemplo, "Access denied" indica credenciales incorrectas, "Can't connect" puede ser problema de red o puerto).

[WARNING] Si no tienes SSH, no te preocupes. Puedes usar herramientas como phpMyAdmin desde Plesk para probar la conexión.

### Conexión desde phpMyAdmin:

En Plesk, ve a Bases de datos y haz clic en el icono de phpMyAdmin junto a tu base de datos.
Si puedes acceder sin problemas, la base de datos funciona. Si no, es posible que el usuario o contraseña sean incorrectos.

Paso 6: Revisa el firewall y el puerto de conexión

En algunos entornos Plesk, el puerto de MySQL puede estar bloqueado por el firewall o configurado en un puerto no estándar.

### ¿Cómo saber el puerto correcto?

En Plesk, ve a Herramientas y configuraciones > Configuración del servidor > Configuración de base de datos.
Busca el campo Puerto. Por defecto es 3306, pero podría ser otro (por ejemplo, 3307).
Si es diferente, actualiza el database_port en tu archivo parameters.php.

[INFO] Si tu hosting usa un firewall, es posible que debas permitir el tráfico en el puerto 3306 desde tu IP. En la mayoría de los casos, como PrestaShop se conecta desde el mismo servidor (localhost), no debería haber bloqueo.

Paso 7: Restablece la conexión desde el instalador de PrestaShop

Si después de todos los pasos anteriores el error persiste, una solución drástica pero efectiva es restablecer la configuración de la base de datos desde el propio instalador de PrestaShop.

### Pasos para hacerlo:

Crea una copia de seguridad de tu base de datos y archivos (¡es crítico!).
Accede a tu tienda a través de la URL seguida de /install/ (por ejemplo, tudominio.com/install/).
El instalador detectará que ya hay una instalación y te preguntará si quieres restaurar o actualizar. Selecciona Restaurar la base de datos (o una opción similar).
Introduce los datos correctos de la base de datos (los que verificaste en Plesk).
El proceso reescribirá el archivo parameters.php con los datos correctos.

[WARNING] Este método puede sobrescribir configuraciones personalizadas. Asegúrate de tener un backup antes.

Preguntas frecuentes (FAQ)

### ¿Por qué aparece el error después de migrar mi tienda a otro servidor?

Al migrar, los datos de conexión (host, usuario, contraseña) suelen cambiar. Debes actualizar el archivo parameters.php con los nuevos datos de Plesk. Además, asegúrate de que el usuario de base de datos esté asignado en el nuevo servidor.

### ¿Qué hago si el error dice "Too many connections"?

Esto significa que tu base de datos ha alcanzado el límite de conexiones simultáneas. Puedes aumentar el límite desde Plesk (en Configuración del servidor > Configuración de base de datos) o contactar con tu hosting. También revisa si hay algún plugin o proceso que esté haciendo muchas consultas.

### ¿Puedo usar Syspanel como alternativa a Plesk?

Si tu hosting utiliza Syspanel (el antiguo HestiaCP), el proceso es similar, pero el acceso al panel es por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Allí también encontrarás la sección de bases de datos para gestionar usuarios y contraseñas. Los pasos de verificación de credenciales y asignación de usuarios son equivalentes.

### ¿El error puede deberse a una actualización de PrestaShop?

Sí. A veces, al actualizar PrestaShop, el archivo parameters.php se modifica o se corrompe. Si el error aparece justo después de una actualización, revisa que los datos de conexión sigan siendo los mismos. Puedes restaurar el archivo desde una copia de seguridad anterior.

### ¿Cómo evito este error en el futuro?

Mantén un registro de las contraseñas de base de datos en un lugar seguro.
Realiza copias de seguridad periódicas de tu tienda y base de datos.
No modifiques manualmente el archivo parameters.php a menos que sepas lo que haces.
Configura alertas en Plesk para que te notifiquen si el servicio de base de datos se detiene.

Conclusión

El error de conexión de base de datos en PrestaShop alojado en Plesk es frustrante, pero casi siempre tiene una solución sencilla. Siguiendo estos pasos, podrás identificar y corregir el problema en la mayoría de los casos. Recuerda: verifica las credenciales, revisa la asignación del usuario, comprueba que el servicio esté activo y, si es necesario, restablece la configuración desde el instalador.

Si después de todo esto el error continúa, no dudes en contactar con tu proveedor de hosting. Ellos podrán revisar el servidor a nivel más profundo. ¡Mucho éxito con tu tienda! 🚀

[TIP FINAL] Siempre ten a mano los datos de acceso a Plesk y una copia de seguridad actualizada. Eso te ahorrará muchos dolores de cabeza.