Solucionar error de conexión a BD en PrestaShop con Plesk | Guía rápida

¿Por qué aparece el error "PrestaShop no puede conectarse a la base de datos" en Plesk?

Si estás leyendo esto, es muy probable que hayas intentado abrir tu tienda online y te hayas encontrado con un mensaje similar a: "PrestaShop no puede conectarse a la base de datos" o un error de conexión con la base de datos MySQL. No te preocupes, es uno de los errores más comunes al gestionar una tienda PrestaShop en un servidor con Plesk, y en la gran mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Este error error PrestaShop Plesk suele aparecer de repente, incluso si tu tienda funcionaba correctamente el día anterior. Las causas pueden variar desde un cambio de contraseña hasta un problema temporal con el servidor de bases de datos. En esta guía extensa, vamos a desglosar paso a paso todas las soluciones posibles, explicadas de forma clara y didáctica, para que puedas solucionar PrestaShop y volver a vender online lo antes posible.

Antes de empezar, es importante que entiendas una cosa básica: PrestaShop necesita dos elementos para funcionar: los archivos (el código de la tienda) y una base de datos (donde se guardan tus productos, clientes y pedidos). Cuando el error aparece, significa que PrestaShop no está encontrando o no puede acceder a esa base de datos. Vamos a ver por qué y cómo arreglarlo.

Primero: Verifica si el problema es general o solo de PrestaShop

Antes de tocar nada, necesitas saber si el problema es exclusivo de PrestaShop o si afecta a todas las bases de datos de tu servidor Plesk. Esto te ahorrará mucho tiempo.

Comprueba el estado del servicio MySQL/MariaDB en Plesk

Plesk gestiona las bases de datos a través de un servicio llamado MySQL (o MariaDB, que es una versión mejorada). Si este servicio se ha detenido o está fallando, ninguna aplicación podrá conectarse a sus bases de datos.

Inicia sesión en tu panel de control de Plesk.
En el menú lateral izquierdo, busca la sección "Herramientas y configuración".
Dentro de esa sección, busca el apartado "Servidor" y haz clic en "Servicios" (o "Gestión de servicios").
Busca en la lista el servicio llamado "MySQL" o "MariaDB".
Verifica que el estado sea "Activo" o "Corriendo" (suele aparecer un círculo verde).

[WARNING] Si el servicio aparece detenido o en rojo, haz clic en el botón de iniciar o reiniciar. Espera unos segundos y vuelve a intentar abrir tu tienda. Este es un problema muy común tras reinicios del servidor o actualizaciones del sistema.

Si el servicio estaba parado y lo has arrancado, es muy probable que el error haya desaparecido. Si no es así, continúa con el siguiente paso.

Solución 1: Revisa los datos de conexión en el archivo de configuración de PrestaShop

Si el servicio de base de datos está activo, el siguiente paso es comprobar que PrestaShop tiene los datos correctos para conectarse. Estos datos están guardados en un archivo llamado parameters.php que se encuentra en la carpeta app/config de tu instalación de PrestaShop.

Cómo acceder y editar el archivo parameters.php

Accede a tu servidor mediante FTP (por ejemplo, con FileZilla) o a través del Administrador de archivos que incluye Plesk (en la sección "Archivos" de tu dominio).
Navega hasta la carpeta de tu tienda. Normalmente es httpdocs o public_html, pero puede variar según tu configuración.
Entra en la carpeta app, luego en config y busca el archivo parameters.php.

Este archivo contiene las credenciales de conexión. Deberías ver algo similar a esto:

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_base',
'database_user' => 'usuario_de_tu_base',
'database_password' => 'tu_contraseña',

Qué debes comprobar aquí

database_host: Normalmente es localhost. Si tu base de datos está en un servidor externo, aquí aparecerá otra dirección IP o nombre de servidor. Si no has cambiado nada, déjalo como está.
database_name: Debe coincidir exactamente con el nombre de la base de datos que tienes creada en Plesk. Los nombres suelen tener el prefijo del usuario (ej: usuario_prestashop).
database_user: Debe coincidir con el usuario de la base de datos en Plesk.
database_password: Este es el punto más crítico. Si has cambiado la contraseña de la base de datos recientemente desde Plesk, es muy probable que este archivo todavía tenga la contraseña antigua.

[TIP] Si no recuerdas tu contraseña actual, ve a Plesk, entra en "Bases de datos", selecciona tu base de datos y haz clic en "Cambiar contraseña". Establece una nueva y, a continuación, actualiza este archivo con la nueva contraseña. Guarda los cambios y sube el archivo de nuevo si lo has editado localmente.

Solución 2: Asegúrate de que el usuario de la base de datos tiene permisos correctos

A veces, los datos son correctos, pero el usuario de la base de datos no tiene permisos suficientes para acceder a ella. Esto puede ocurrir tras una restauración o una migración.

Cómo verificar los permisos desde Plesk

Ve a Plesk y entra en la sección "Bases de datos" (dentro de tu dominio).
Busca la base de datos que usa tu PrestaShop y haz clic en ella.
Verás una lista de "Usuarios de base de datos" asociados.
Asegúrate de que el usuario que aparece en tu archivo parameters.php está en esa lista.
Si no está, añádelo con el botón "Añadir usuario". Si ya está, haz clic en el icono de edición (lápiz) y verifica que tiene todos los privilegios marcados (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Lo más sencillo es marcar la casilla de "Todos los privilegios".

[INFO] Si después de esto el error persiste, puedes intentar crear un nuevo usuario de base de datos desde Plesk, asignarle todos los privilegios sobre la base de datos de PrestaShop y actualizar el archivo parameters.php con estos nuevos datos. Esto suele resolver conflictos de permisos heredados.

Solución 3: Comprueba si el problema es de caché o de sesión

PrestaShop guarda información temporal en archivos de caché. A veces, estos archivos se corrompen y provocan errores extraños, incluido el de conexión a la base de datos, aunque la conexión en sí sea correcta.

Limpiar la caché de PrestaShop manualmente

Accede por FTP o por el administrador de archivos de Plesk.
Dentro de la carpeta de tu tienda, busca la carpeta var/cache.
Borra todo el contenido de esta carpeta, pero no borres la carpeta en sí. Si ves subcarpetas como dev o prod, bórralas también.
También puedes borrar el contenido de la carpeta app/cache si existe (en versiones antiguas de PrestaShop).

[WARNING] No borres los archivos .htaccess ni los archivos de configuración principal. Solo elimina el contenido de las carpetas de caché.

Después de limpiar la caché, intenta acceder a tu tienda. Si el error era por caché corrupta, se habrá solucionado.

Solución 4: Revisa los logs de error de Plesk y de PrestaShop

Si ninguna de las soluciones anteriores funciona, necesitas más información. Los logs son la mejor fuente de verdad para diagnosticar el error PrestaShop Plesk.

Dónde encontrar los logs

En Plesk, ve a tu dominio y haz clic en "Registros" (o "Logs").
Busca el archivo de log de errores de tu sitio web. Suele llamarse error_log o error.log.
También puedes revisar los logs de MySQL en Plesk: ve a "Herramientas y configuración" -> "Logs" y filtra por servicio MySQL.

Errores comunes que puedes encontrar

"Access denied for user 'usuario'@'localhost'": Indica que la contraseña o el usuario son incorrectos. Revisa el paso 1.
"Unknown database 'nombre_base'": Indica que la base de datos no existe. Verifica el nombre en Plesk.
"Too many connections": El servidor tiene demasiadas conexiones abiertas. Esto es un problema de recursos del servidor. Puedes intentar reiniciar MySQL desde Plesk y, si es recurrente, contactar con tu proveedor de hosting.

[TIP] Si los logs de PrestaShop están en una carpeta llamada var/logs, también puedes revisarlos. Busca el archivo prod.log o dev.log y mira las últimas líneas.

Solución 5: Verifica la configuración de red y el host de la base de datos

Aunque menos común, a veces el problema es que PrestaShop intenta conectarse a un servidor de base de datos que no es accesible.

Caso especial: Base de datos en un servidor externo

Si tu base de datos no está en el mismo servidor que tu tienda (es decir, el database_host no es localhost), necesitas asegurarte de que el servidor de base de datos permite conexiones remotas desde la IP de tu servidor web.

En Plesk, esto se gestiona en la sección de "Bases de datos" -> "Configuración de acceso remoto". Si tienes este tipo de configuración, revisa que la IP de tu servidor web esté en la lista blanca de hosts permitidos.

Caso estándar: Base de datos en el mismo servidor

Si todo está en el mismo servidor, simplemente verifica que el campo database_host sea localhost y no 127.0.0.1 o una IP específica. A veces, por configuración de Plesk, localhost puede fallar y necesitas usar 127.0.0.1. Prueba a cambiar este valor en el archivo parameters.php y guarda los cambios.

Solución 6: Repara las tablas de la base de datos

Si la conexión se establece pero PrestaShop sigue fallando, puede que algunas tablas de la base de datos estén corruptas. Esto es más habitual de lo que parece, sobre todo si ha habido cortes de luz o caídas del servidor.

Cómo reparar tablas desde Plesk

En Plesk, ve a "Bases de datos" y haz clic en tu base de datos.
Haz clic en el botón "phpMyAdmin" para abrir la herramienta de gestión de bases de datos.
En el panel izquierdo, haz clic en el nombre de tu base de datos para ver todas las tablas.
Marca la casilla de "Seleccionar todo" en la parte inferior de la lista de tablas.
En el menú desplegable de acciones, selecciona "Reparar tabla".
Ejecuta la acción.

[INFO] Esta operación es segura y no borra datos. Simplemente intenta arreglar la estructura de las tablas. Si alguna tabla no se puede reparar, puede que necesites restaurar una copia de seguridad.

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

Si has probado todo y sigues sin poder solucionar PrestaShop, existe un último recurso muy efectivo: usar el instalador de PrestaShop en modo de reparación.

Cómo hacerlo paso a paso

Descarga la última versión de PrestaShop desde tu área de cliente de PrestaShop o desde tu proveedor.
Sube el contenido del archivo ZIP a una carpeta temporal en tu servidor (por ejemplo, httpdocs/instalador).
Accede a tu navegador y visita tudominio.com/instalador.
Sigue los pasos del instalador. Cuando llegues a la pantalla de conexión a la base de datos, introduce los datos correctos que has verificado anteriormente.
El instalador detectará que ya hay una instalación existente y te ofrecerá la opción de "Reparar" o "Actualizar". Elige la opción de reparación.
Sigue los pasos hasta el final. Esto no borrará tus datos, solo restaurará los archivos de configuración y la conexión.

[WARNING] Este proceso puede tardar varios minutos. No interrumpas la ejecución. Asegúrate de haber hecho una copia de seguridad de tu base de datos antes de empezar, por precaución.

Preguntas frecuentes (FAQ) sobre el error de conexión a la base de datos en PrestaShop

¿Qué significa exactamente "PrestaShop no puede conectarse a la base de datos"?

Significa que el código de PrestaShop no puede establecer una comunicación con el servidor MySQL/MariaDB donde se almacenan los datos de tu tienda. Puede ser por credenciales incorrectas, servidor caído, permisos insuficientes o problemas de red.

¿Puedo perder mis datos si sigo estos pasos?

No, todos los pasos descritos son seguros y no implican la eliminación de datos. La única acción que podría ser sensible es la reparación de tablas, pero es una operación estándar y no destructiva.

¿Cada cuánto debo cambiar la contraseña de mi base de datos?

No hay una regla fija, pero es buena práctica cambiarla cada 3-6 meses y siempre después de un incidente de seguridad. Si la cambias, recuerda actualizar el archivo parameters.php inmediatamente.

El error aparece solo en el panel de administración, ¿qué hago?

Si el error es solo en el back-office (admin) pero la tienda funciona, puede ser un problema de caché del panel. Limpia la caché de PrestaShop y también la caché de tu navegador. Si persiste, revisa los permisos de la carpeta var/cache.

¿Puede ser un problema de mi proveedor de hosting?

Sí, es posible. Si el servicio MySQL se cae repetidamente o si los logs muestran errores de "Too many connections", puede ser un problema de recursos del servidor. En ese caso, contacta con tu proveedor de hosting y explícales el error.

¿Qué hago si después de todo esto el error continúa?

Si has seguido todos los pasos y el error PrestaShop Plesk persiste, te recomendamos contactar con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso directo a los logs del servidor y podrán diagnosticar el problema a un nivel más profundo. También puedes acudir a los foros oficiales de PrestaShop, donde la comunidad es muy activa y suele ofrecer soluciones para casos muy específicos.

Conclusión: La paciencia y el método son la clave

El error de conexión a la base de datos en PrestaShop puede ser frustrante, pero como has visto, la mayoría de las causas tienen solución y no requieren conocimientos avanzados. La clave es seguir un orden lógico: primero verificar que el servicio de base de datos está activo, luego revisar las credenciales, después los permisos y finalmente la integridad de los datos.

Recuerda que este tipo de problemas también es una oportunidad para aprender más sobre cómo funciona tu tienda y tu servidor. Con esta guía, ya tienes un mapa claro para abordar el problema. No te desesperes, ve paso a paso y, sobre todo, haz siempre copias de seguridad antes de realizar cambios importantes. Tu tienda volverá a estar operativa en poco tiempo.