Error de conexión a base de datos en PrestaShop en Plesk | Solución

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los problemas más comunes y frustrantes al administrar una tienda online con PrestaShop alojada en un servidor Plesk: los errores de conexión a la base de datos.

Si ves un mensaje como "Error de conexión a la base de datos", "Link to database cannot be established" o "PrestaShop no puede conectar con MySQL", no te preocupes. En esta guía paso a paso, te explicaré las causas más frecuentes y, lo más importante, cómo solucionarlo de forma clara y sin necesidad de ser un experto técnico.

Vamos a ello. Recuerda que trabajaremos dentro de Plesk, el panel de control de tu hosting, y que todos los pasos están pensados para que los sigas con tranquilidad.

¿Por qué ocurre el error de conexión a la base de datos en PrestaShop?

El error conexión base datos PrestaShop suele aparecer cuando tu tienda no puede comunicarse con el servidor MySQL (o MariaDB) donde están almacenados tus productos, clientes y pedidos. Las causas más habituales son:

Credenciales incorrectas en el archivo de configuración de PrestaShop (app/config/parameters.php).
La base de datos no existe o ha sido eliminada accidentalmente.
El usuario de la base de datos no tiene permisos suficientes.
El servidor de base de datos está caído o sobrecargado (poco común en Plesk, pero posible).
Cambios recientes en tu hosting (migración, cambio de contraseña, actualización de PHP, etc.).

Diagnóstico inicial: ¿Qué información necesito?

Antes de tocar nada, vamos a recopilar datos clave. Esto te ahorrará tiempo y evitará errores.

Accede a Plesk (normalmente en https://tudominio.com:8443 o la URL que te haya dado tu proveedor).
Ve a Bases de datos en el panel izquierdo (o en la sección de tu dominio).
Anota el nombre exacto de la base de datos que usa tu PrestaShop (suele ser algo como tudominio_prestashop).
Anota el nombre del usuario asociado a esa base de datos.
Si no recuerdas la contraseña, puedes cambiarla (te explicaré cómo más adelante).

[TIP] Si tienes acceso por FTP o administrador de archivos, también puedes revisar el archivo app/config/parameters.php de tu PrestaShop. Ahí están las credenciales actuales. No lo modifiques aún, solo anótalo.

Soluciones paso a paso para el error BD PrestaShop Plesk

1. Verificar y corregir las credenciales en el archivo de configuración

Este es el primer lugar donde debes mirar. El archivo parameters.php contiene los datos de conexión que PrestaShop utiliza.

Cómo acceder al archivo:

Desde Plesk: Ve a Archivos en tu dominio, luego navega a httpdocs/app/config/ (o htdocs/app/config/ dependiendo de tu estructura).
Busca el archivo parameters.php y haz clic en Editar (o descárgalo, edítalo con un bloc de notas y súbelo de nuevo).

Qué buscar:
Dentro del archivo verás líneas como:

'database_host' => 'localhost',
'database_name' => 'tudominio_prestashop',
'database_user' => 'tudominio_usuario',
'database_password' => 'contraseña_segura',

Qué hacer:

Asegúrate de que database_host sea localhost (salvo que tu hosting te indique otra cosa, pero en Plesk casi siempre es localhost).
Compara database_name, database_user y database_password con los datos que anotaste en el paso anterior.
Si la contraseña no coincide, cámbiala en el archivo por la correcta.

[WARNING] Ten cuidado al editar este archivo. No borres comillas ni puntos y coma. Si no estás seguro, haz una copia de seguridad antes.

Guardar y probar:
Guarda los cambios y carga tu tienda. Si el error persiste, continúa con el siguiente paso.

2. Comprobar que la base de datos existe y está accesible

A veces la base de datos se elimina por error o durante una migración. Vamos a verificarlo.

En Plesk:

Ve a Bases de datos.
Busca la base de datos que debería usar tu PrestaShop. Si no aparece, deberás crearla de nuevo (más adelante te explico cómo).
Si aparece, haz clic en su nombre para ver los detalles. Asegúrate de que el usuario asociado esté listado.

Probar la conexión manualmente:
Puedes usar la herramienta phpMyAdmin que viene integrada en Plesk:

En la sección de bases de datos, haz clic en phpMyAdmin (o en el icono de la base de datos).
Te pedirá usuario y contraseña. Introduce los datos que tienes anotados.
Si accedes sin problemas, la base de datos existe y las credenciales son correctas. Si no, el error está en los permisos o en la contraseña.

[INFO] Si no puedes acceder a phpMyAdmin, es posible que el usuario no tenga permisos. Lo solucionaremos en el paso 3.

3. Revisar y reasignar permisos del usuario de la base de datos

Un usuario sin permisos suficientes puede causar el error BD PrestaShop Plesk.

Cómo hacerlo en Plesk:

Ve a Bases de datos y haz clic en el nombre de tu base de datos.
Busca la sección Usuarios o Permisos.
Marca todas las casillas de permisos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Lo más seguro es dar todos los privilegios a este usuario para PrestaShop.
Guarda los cambios.

Si el usuario no aparece, puedes añadirlo de nuevo:

En la misma pantalla, haz clic en Añadir usuario.
Crea un nuevo usuario (o usa el existente) y asígnale una contraseña segura. Luego, asígnale todos los permisos.

[TIP] Anota la nueva contraseña en un lugar seguro. Luego deberás actualizarla también en el archivo parameters.php de PrestaShop.

4. Verificar el estado del servidor MySQL en Plesk

Aunque es raro, el servicio de base de datos puede estar detenido. Plesk permite reiniciarlo fácilmente.

Pasos:

En el panel principal de Plesk, ve a Herramientas y configuraciones (a veces en el menú de la izquierda).
Busca Servicios o Administración de servicios.
Localiza MySQL o MariaDB.
Si su estado es Detenido, haz clic en Iniciar.
Si está Ejecutándose, puedes intentar Reiniciar para refrescar la conexión.

[WARNING] Reiniciar MySQL puede causar una breve interrupción en tu tienda (unos segundos). Hazlo en un momento de bajo tráfico.

5. Recrear la base de datos desde cero (solución avanzada)

Si todo lo anterior falla, podemos crear una nueva base de datos y restaurar tus datos. Esto es útil si la base original se corrompió.

En Plesk:

Ve a Bases de datos y haz clic en Añadir base de datos.
Dale un nombre (ej. tudominio_prestashop_nueva).
Crea un usuario y contraseña para ella.
Luego, restaura un backup de tu tienda (si tienes uno) o reinstala PrestaShop (solo si no tienes datos importantes).

Actualizar PrestaShop:

Edita parameters.php y cambia database_name, database_user y database_password por los nuevos datos.
Si tienes un backup de la base antigua, impórtalo desde phpMyAdmin.

[INFO] Si no tienes backup, esta opción implica perder datos. Siempre es mejor prevenir con copias de seguridad periódicas.

6. Comprobar la versión de PHP y módulos necesarios

PrestaShop requiere ciertos módulos de PHP para conectar con MySQL. Una versión incorrecta puede causar el error.

En Plesk:

Ve a Hosting y DNS > Configuración de PHP (o similar).
Asegúrate de que la versión de PHP sea compatible con tu PrestaShop (PrestaShop 1.7 funciona con PHP 7.1 a 8.0, PrestaShop 8 requiere PHP 8.0+).
Verifica que los módulos mysqli y pdo_mysql estén habilitados. Si no lo están, actívalos desde la misma pantalla.

[WARNING] Cambiar la versión de PHP puede afectar otros aspectos de tu tienda. Consulta primero la documentación de PrestaShop.

Preguntas frecuentes (FAQ)

¿Qué hago si no recuerdo la contraseña de la base de datos?

En Plesk, puedes cambiarla fácilmente:

Ve a Bases de datos.
Haz clic en el nombre de la base.
En la sección Usuarios, haz clic en el icono de Cambiar contraseña (un candado o lápiz).
Introduce una nueva contraseña segura y guárdala.
Luego, actualiza el archivo parameters.php de PrestaShop con esa nueva contraseña.

¿Puedo usar un nombre de host diferente a "localhost"?

En Plesk, el servidor de base de datos suele estar en el mismo equipo, por lo que localhost es lo correcto. Si tu hosting te proporciona un host remoto (como mysql.tudominio.com), úsalo, pero es poco común en planes compartidos.

¿El error puede deberse a un plugin o tema de PrestaShop?

Sí, aunque es menos frecuente. Si el error aparece después de instalar un módulo, prueba a desactivarlo desde el archivo config/defines.inc.php de PrestaShop (cambiando _PS_MODE_DEV_ a true para ver errores más detallados). Si no sabes cómo, contacta con el desarrollador del módulo.

¿Qué significa "Tabla no encontrada" o "Table doesn't exist"?

Eso indica que la base de datos está accesible, pero faltan tablas. Puede ocurrir tras una migración incompleta. La solución es restaurar un backup de la base de datos o ejecutar el script de instalación de PrestaShop de nuevo (cuidado, esto borrará datos).

¿Syspanel (HestiaCP) tiene algo que ver?

Si tu hosting usa Syspanel (HestiaCP) en lugar de Plesk, el proceso es similar pero la interfaz cambia. En Syspanel, accedes por el puerto 2106 (ej. https://tudominio.com:2106). Allí encontrarás una sección de bases de datos con opciones muy parecidas. Los pasos de esta guía son igualmente aplicables.

Consejos finales para evitar futuros problemas

Haz backups periódicos de tu base de datos desde Plesk (puedes programarlos automáticos).
Anota las credenciales en un gestor de contraseñas.
Actualiza PrestaShop y sus módulos regularmente para evitar incompatibilidades con PHP o MySQL.
No edites el archivo parameters.php a menos que sepas lo que haces; un error de sintaxis puede dejar tu tienda inaccesible.

Resumen rápido: checklist de solución

✅ Verifica credenciales en parameters.php.
✅ Comprueba que la base de datos existe en Plesk.
✅ Reasigna permisos al usuario.
✅ Reinicia el servicio MySQL en Plesk.
✅ Ajusta la versión de PHP y módulos.
✅ Si todo falla, recrea la base desde un backup.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave: muchos errores de conexión base datos PrestaShop se solucionan con un simple ajuste de credenciales o permisos. Si después de seguir todos los pasos el problema persiste, no dudes en contactar al soporte técnico de tu hosting, ellos pueden revisar los logs del servidor.

¡Buena suerte con tu tienda online! 🚀