Error de Conexión a BD en PrestaShop con Plesk: Solución

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

Cuando tu tienda PrestaShop muestra el temido mensaje de "error conexión base datos PrestaShop", la causa más común es que los datos de acceso a MySQL que están en el archivo de configuración no coinciden con los que realmente existen en tu servidor Plesk. Esto puede pasar después de migrar la tienda, cambiar la contraseña de la base de datos, o incluso al renovar el certificado SSL del panel de Plesk. Pero no te preocupes, en este artículo te guiaré paso a paso para resolverlo, incluso si no eres un experto en tecnología.

El error suele aparecer en la pantalla blanca de PrestaShop con un mensaje similar a: "Link to database cannot be established" o directamente un error 500. En muchos casos, el problema está en el archivo parameters.php o settings.inc.php, dependiendo de la versión de PrestaShop que uses (1.6 o 1.7/8). También puede ocurrir que el servicio de MySQL esté caído en Plesk, o que el usuario de la base de datos no tenga los privilegios correctos.

Vamos a desglosar todas las soluciones posibles, desde las más simples hasta las más avanzadas, para que puedas recuperar tu tienda online sin desesperarte.

Primeros pasos: verifica que MySQL esté activo en Plesk

Antes de tocar archivos de configuración, lo primero es comprobar que el servicio de bases de datos esté funcionando en tu servidor Plesk. A veces, tras una actualización o un reinicio del servidor, MySQL no se inicia correctamente.

Cómo comprobar el estado de MySQL en Plesk

Accede a tu panel de Plesk (normalmente en https://tu-dominio.com:8443 o https://tu-ip:8443).
En el menú lateral izquierdo, busca la sección "Herramientas y ajustes" (o Tools & Settings).
Dentro de esa sección, localiza "Servicios del servidor" (o Server Services). Verás una lista con todos los servicios: Apache, Nginx, MySQL, etc.
Busca el servicio MySQL y verifica que su estado sea "Activo" (verde). Si aparece en rojo o como "detenido", haz clic en el botón de inicio para arrancarlo.

[TIP] Si no encuentras la opción de servicios, también puedes usar el comando systemctl status mysql si tienes acceso SSH, pero para usuarios sin experiencia, es más fácil usar la interfaz de Plesk.

Si el servicio está activo y aún así tienes el error de conexión base datos PrestaShop, continúa con el siguiente paso.

Revisa el archivo de configuración de PrestaShop

El archivo que contiene las credenciales de acceso a la base de datos es el corazón de este problema. PrestaShop guarda esta información en un archivo llamado parameters.php (para versiones 1.7 y superiores) o settings.inc.php (para la 1.6). La ruta típica es:

/var/www/vhosts/tu-dominio.com/httpdocs/app/config/parameters.php

O si usas la versión 1.6:

/var/www/vhosts/tu-dominio.com/httpdocs/config/settings.inc.php

Cómo acceder al archivo desde Plesk

En Plesk, ve a "Sitios web y dominios".
Haz clic en "Administrar" (o Manage) en el dominio de tu tienda.
Busca la sección "Archivos" (o File Manager). Ábrela.
Navega hasta la carpeta httpdocs, luego app y después config (o solo config si es PrestaShop 1.6).
Localiza el archivo parameters.php y haz clic derecho sobre él → "Editar".

Qué datos revisar dentro del archivo

Dentro del archivo verás una estructura similar a esta (en PrestaShop 1.7):

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Debes verificar que estos cuatro valores coincidan exactamente con los datos reales de tu base de datos en Plesk. Es muy común que aquí esté el fallo: por ejemplo, si cambiaste la contraseña de MySQL en Plesk pero no actualizaste este archivo.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una comilla mal puesta) puede dejar tu tienda totalmente inaccesible. Si no estás seguro, haz una copia de seguridad del archivo antes de modificarlo (botón derecho → "Copiar").

Dónde encontrar los datos correctos en Plesk

En Plesk, ve a "Sitios web y dominios" → tu dominio.
Busca la sección "Bases de datos" (o Databases). Verás una lista con las bases de datos asociadas a tu tienda.
Haz clic en el nombre de la base de datos que usa PrestaShop. Ahí verás el nombre de la base, el usuario asociado y un botón para "Cambiar contraseña".

Si no recuerdas la contraseña, puedes cambiarla desde ahí y luego actualizarla en el archivo parameters.php. Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) marcados. Plesk normalmente los asigna todos por defecto, pero por si acaso, verifica que la casilla "Todos los privilegios" esté marcada.

El problema de "localhost" vs la IP del servidor

Otro error típico es que el database_host esté configurado como localhost, pero en algunos entornos Plesk (especialmente si usas servidores remotos de MySQL o contenedores), la conexión debe hacerse a través de una IP específica o un socket diferente.

Qué probar si "localhost" no funciona

Cambia database_host a 127.0.0.1 en lugar de localhost. A veces el sistema de nombres no resuelve correctamente.
Si tu base de datos está en otro servidor (por ejemplo, si usas MySQL separado), tendrás que poner la IP pública de ese servidor.
En Plesk, también puedes revisar si el host de la base de datos es accesible desde la web. Ve a "Bases de datos" → tu base → "Configuración de acceso remoto" y asegúrate de que no esté bloqueada para conexiones locales.

[INFO] En la mayoría de los casos con Plesk, localhost funciona perfectamente. Pero si has migrado la tienda desde otro hosting, es posible que el archivo de configuración tenga la IP del antiguo servidor. Actualízala a localhost o a la IP correcta.

Comprueba los permisos y propietarios de los archivos

A veces el error no es de conexión, sino de lectura de archivos. Si los permisos de parameters.php son demasiado restrictivos, PHP no puede leerlo y lanza un error que parece de base de datos.

Permisos recomendados para PrestaShop en Plesk

Los archivos de configuración deben tener permisos 644 (lectura y escritura para el propietario, lectura para el grupo y otros).
Las carpetas deben tener 755.

Para cambiarlos desde Plesk:

En el Administrador de archivos, selecciona el archivo parameters.php.
Haz clic en "Permisos" (o Permissions) en la barra superior.
Introduce 644 y guarda.

[WARNING] Nunca pongas permisos 777 en archivos de configuración. Aunque "funcione", es un grave riesgo de seguridad que permite a cualquier usuario modificar tu configuración.

Solución avanzada: usar la consola de Plesk para diagnosticar

Si después de revisar todo lo anterior el error de conexión base datos PrestaShop persiste, necesitamos ir un paso más allá. Plesk incluye una herramienta de terminal integrada que te permite ejecutar comandos sin necesidad de SSH externo.

Cómo acceder a la terminal de Plesk

En Plesk, ve a "Herramientas y ajustes".
Busca "Acceso SSH" o "Terminal" (dependiendo de la versión). Si no tienes acceso SSH, actívalo desde "Usuarios de hosting" → tu usuario → "Acceso SSH" → "Shell bash".

Comandos para probar la conexión a MySQL

Una vez en la terminal, ejecuta:

mysql -u tu_usuario -p tu_base_de_datos

Te pedirá la contraseña. Si la conexión es exitosa, verás el prompt de MySQL. Si falla, el error te dirá exactamente qué pasa (credenciales incorrectas, host no permitido, etc.).

También puedes probar la conexión desde PHP directamente:

php -r "new PDO('mysql:host=localhost;dbname=tu_base', 'tu_usuario', 'tu_contraseña'); echo 'OK';"

Si esto devuelve OK, el problema está en el archivo de configuración de PrestaShop. Si devuelve un error, el problema es de MySQL o de permisos de red.

Cómo limpiar la caché de PrestaShop tras corregir la conexión

Una vez que hayas corregido los datos en parameters.php, es posible que PrestaShop siga mostrando el error debido a la caché. Necesitas limpiarla para que la tienda vuelva a funcionar.

Métodos para limpiar la caché

Desde el administrador: Si puedes acceder al panel de administración (aunque sea a veces), ve a Parámetros avanzados → Rendimiento → Vaciar la caché.
Eliminando archivos manualmente: Si no puedes acceder al panel, borra el contenido de la carpeta /var/www/vhosts/tu-dominio.com/httpdocs/var/cache (en PrestaShop 1.7) o /cache (en 1.6). Usa el administrador de archivos de Plesk para eliminar todos los archivos dentro, pero no la carpeta en sí.

[TIP] También puedes desactivar la caché temporalmente editando parameters.php y añadiendo 'cache_enabled' => false en la sección de parámetros. Pero esto es solo para diagnosticar; recuerda volver a activarla después.

Errores comunes relacionados con el puerto de MySQL

En Plesk, MySQL normalmente escucha en el puerto 3306. Pero si tienes configuraciones personalizadas o usas MariaDB, el puerto podría ser diferente. Revisa en el archivo parameters.php si hay una línea 'database_port'. Si no la hay, PrestaShop usará el 3306 por defecto.

Cómo verificar el puerto en Plesk

Ve a "Herramientas y ajustes" → "Configuración de MySQL".
Ahí verás el puerto y el host de escucha. Si es diferente a 3306, añade la línea 'database_port' => 'tu_puerto', en el archivo de configuración.

[WARNING] Cambiar el puerto de MySQL sin necesidad puede romper otras aplicaciones. Solo hazlo si estás seguro de que el puerto ha cambiado.

Solución definitiva: restaurar desde una copia de seguridad

Si has probado todo lo anterior y sigues con Plesk PrestaShop error, puede que el problema sea más profundo: una corrupción en la base de datos o en los archivos de PrestaShop. En ese caso, la solución más segura es restaurar desde una copia de seguridad reciente.

Cómo restaurar desde Plesk

Ve a "Sitios web y dominios" → tu dominio.
Haz clic en "Copias de seguridad" (o Backup).
Selecciona una copia de seguridad anterior al error y haz clic en "Restaurar".
Elige la opción de restaurar "Archivos y bases de datos" completos.

Esto revertirá tanto el código como la base de datos al estado anterior. Es la opción más drástica, pero también la más efectiva si no sabes exactamente qué ha cambiado.

[INFO] Antes de restaurar, descarga una copia de seguridad actual de tu base de datos y archivos a tu ordenador. Si la restauración falla, al menos tendrás el estado actual guardado.

Preguntas frecuentes (FAQ) sobre el error de conexión a BD en PrestaShop

¿Por qué aparece el error después de cambiar la contraseña de MySQL en Plesk?

Porque PrestaShop guarda la contraseña en parameters.php y no se actualiza automáticamente. Debes editarlo manualmente con la nueva contraseña.

¿Puedo usar el mismo usuario de base de datos para varias tiendas PrestaShop?

Técnicamente sí, pero no es recomendable. Cada tienda debería tener su propia base de datos y usuario con privilegios limitados. Compartir usuarios puede causar conflictos y problemas de seguridad.

¿Qué hago si el error aparece solo en algunas páginas?

Si el error es intermitente, puede ser un problema de timeout de MySQL o de conexiones simultáneas. Aumenta el max_connections en la configuración de MySQL desde Plesk.

¿El error puede estar causado por un plugin recién instalado?

Sí, algunos módulos de terceros pueden modificar el archivo de configuración o crear tablas que fallan. Desactiva los módulos recientes desde la base de datos (cambiando active = 0 en la tabla ps_module) para probar.

¿Es necesario contactar con soporte técnico?

Si has seguido todos los pasos y nada funciona, sí. El problema puede ser a nivel de servidor (firewall, SELinux, etc.) que no puedes resolver desde Plesk. Contacta con tu proveedor de hosting y diles que tienes un error de conexión base datos PrestaShop en Plesk, y que ya has verificado credenciales y permisos.

Resumen rápido: checklist para resolver el error

Aquí tienes una lista rápida de verificación para no perderte:

Comprobar que MySQL está activo en Plesk.
Verificar el nombre de la base, usuario y contraseña en parameters.php.
Probar con 127.0.0.1 en lugar de localhost.
Revisar permisos del archivo (644).
Probar conexión desde la terminal de Plesk.
Limpiar caché de PrestaShop.
Revisar puerto de MySQL (3306).
Si todo falla, restaurar copia de seguridad.

[TIP] Si tienes acceso a Syspanel (el panel alternativo que a veces viene con Plesk, accesible en el puerto 2106), revisa también que el servicio de MySQL aparezca como activo ahí. A veces los dos paneles pueden mostrar estados diferentes.

Conclusión

El error de conexión base datos PrestaShop en Plesk es uno de los problemas más comunes y, afortunadamente, uno de los más fáciles de resolver si sigues un orden lógico. La mayoría de las veces se soluciona corrigiendo las credenciales en parameters.php o reiniciando el servicio MySQL. No tengas miedo de editar archivos de configuración, pero siempre con una copia de seguridad previa.

Recuerda que la paciencia es clave. Ve paso a paso, y si un método no funciona, prueba el siguiente. Con esta guía, tu tienda PrestaShop debería estar funcionando en menos de 30 minutos. Y si todo lo demás falla, no dudes en contactar con tu proveedor de hosting: para eso están. ¡Mucho ánimo y a vender!