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

¡Hola! Soy tu técnico de soporte amigable. Entiendo lo frustrante que es ver el temido mensaje de "Error de conexión a la base de datos" en tu tienda PrestaShop. No te preocupes, esto es un problema muy común y, en la mayoría de los casos, tiene una solución sencilla. Vamos a arreglarlo paso a paso, como si lo hiciéramos juntos.

Este artículo está diseñado especialmente para ti, que tienes tu tienda alojada en un servidor con Plesk. Aquí te explicaré las causas más frecuentes y cómo solucionar el error base datos PrestaShop, para que tu tienda vuelva a funcionar en pocos minutos.

¿Por qué aparece el error "PrestaShop no conecta DB"?

Cuando ves este mensaje, significa que tu tienda PrestaShop no puede comunicarse con la base de datos donde guarda toda la información (productos, clientes, pedidos, etc.). Las causas más comunes son:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos que tiene configurado PrestaShop ya no son válidos.
Permisos de usuario: El usuario de la base de datos no tiene los permisos necesarios para acceder a ella.
Servidor de base de datos caído: El servicio MySQL o MariaDB del servidor se ha detenido o está sobrecargado.
Archivo de configuración dañado: El archivo app/config/parameters.php de PrestaShop está corrupto o tiene información incorrecta.
Problemas de conexión remota: (Menos común en Plesk) La base de datos no permite conexiones desde el servidor web.

No te asustes. Vamos a revisar cada una de estas causas y a solucionarlas. Tener un poco de paciencia es clave.

Paso 1: Accede a tu panel de control Plesk

Lo primero que necesitas es entrar a tu panel de control de alojamiento. Plesk es la herramienta que te permite gestionar tu sitio web y sus bases de datos.

Abre tu navegador web favorito (Chrome, Firefox, Edge, etc.).
Escribe la dirección de tu panel Plesk. Normalmente es algo como https://tudominio.com:8443 o https://tu-ip-del-servidor:8443. Si no la recuerdas, pídele a tu proveedor de hosting que te la facilite.
Introduce tu nombre de usuario y contraseña de Plesk.

[TIP] Guarda esta dirección en tus favoritos. La usarás a menudo para gestionar tu hosting.

Paso 2: Verifica que el servicio de base de datos esté funcionando

Antes de modificar nada, asegurémonos de que el motor de base de datos (MySQL o MariaDB) esté activo. Plesk tiene una herramienta para esto.

Dentro de Plesk, busca en el menú de la izquierda la opción "Herramientas y configuraciones".
En la sección "Servicios", busca y haz clic en "Administrador de servicios" o "Servicios del sistema".
Localiza el servicio mysql o mariadb. Verás su estado (por ejemplo, "ejecutándose" o "detenido").
Si está detenido, haz clic en el botón de iniciar (suele ser un icono de "play" o un botón verde).
Si ya está ejecutándose, genial. Pasemos al siguiente paso.

[WARNING] Si el servicio se detiene constantemente, puede ser un problema de recursos del servidor (memoria RAM insuficiente). En ese caso, contacta a tu proveedor de hosting para que lo revise.

Paso 3: Revisa las credenciales de la base de datos en PrestaShop

Este es el paso más común para solucionar el error. PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php. Vamos a revisarlo.

¿Cómo acceder al archivo parameters.php?

Tienes dos opciones: usar el administrador de archivos de Plesk o un cliente FTP (como FileZilla). Te recomiendo usar el administrador de archivos de Plesk porque es más sencillo.

En Plesk, ve a tu dominio (el de tu tienda PrestaShop).
Busca la sección "Archivos" y haz clic en "Administrador de archivos".
Navega hasta la carpeta de tu tienda. Normalmente es la raíz del dominio (por ejemplo, httpdocs o public_html).
Dentro, busca la carpeta app, luego la carpeta config y finalmente el archivo parameters.php.
Haz clic derecho sobre el archivo parameters.php y selecciona "Editar en el editor de texto".

¿Qué debes buscar en el archivo?

Dentro del archivo, verás un montón de líneas de código. Busca las líneas que contienen database_host, database_name, database_user y database_password. Se verán algo así:

  'database_host' => 'localhost',
  'database_port' => '',
  'database_name' => 'tu_nombre_de_bd',
  'database_user' => 'tu_usuario_de_bd',
  'database_password' => 'tu_contraseña_de_bd',

Ahora, abre otra pestaña en tu navegador y regresa a Plesk.

Verifica las credenciales en Plesk

En el panel principal de Plesk, busca la sección "Bases de datos" (suele estar en el menú de la izquierda o en la página de tu dominio).
Verás una lista de las bases de datos que tienes. Busca la que usa tu PrestaShop (por el nombre que viste en el archivo parameters.php).
Haz clic en el nombre de la base de datos.
Allí verás el nombre de la base de datos y el nombre de usuario asociado. ¡Compáralos con los del archivo! Si no coinciden, ese es el problema.
Para verificar la contraseña, puedes hacer clic en "Cambiar contraseña" (o "Usuario de base de datos"). Establece una contraseña nueva y segura, y anótala exactamente como la escribes.

[INFO] Una buena práctica es usar contraseñas largas con letras mayúsculas, minúsculas, números y símbolos. Por ejemplo: MiTiend@2024!

Corrige el archivo parameters.php

Vuelve a la pestaña donde tienes abierto el archivo parameters.php en el editor.
Corrige las líneas database_name, database_user y database_password con los valores correctos que viste en Plesk. Asegúrate de que las comillas simples (') estén bien puestas.
Importante: La línea 'database_host' casi siempre debe ser 'localhost'. No la cambies a menos que tu proveedor te indique lo contrario.
Guarda los cambios (normalmente con el botón "Guardar" o "OK") y cierra el editor.

Paso 4: Verifica los permisos del usuario de la base de datos

A veces, aunque el usuario y la contraseña sean correctos, el usuario no tiene permisos para acceder a la base de datos desde el servidor web.

En Plesk, ve a la sección "Bases de datos".
Haz clic en el nombre de la base de datos de tu PrestaShop.
Busca la opción "Usuarios de base de datos" o "Administrar usuarios".
Verás el usuario que tienes asignado. Haz clic en su nombre.
Asegúrate de que tenga marcada la opción "Todos los privilegios" o, al menos, los privilegios básicos como SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP. Si no, selecciona "Todos" y guarda los cambios.

[TIP] Si no estás seguro, selecciona "Todos los privilegios". Es la opción más segura para el funcionamiento de PrestaShop.

Paso 5: Limpia la caché de PrestaShop (opcional pero recomendado)

Después de hacer cambios en la configuración, a veces PrestaShop guarda datos antiguos en su caché. Forzar su limpieza puede ayudar.

Vuelve al Administrador de archivos de Plesk.
Navega a la carpeta raíz de tu tienda (donde está index.php).
Busca la carpeta var/cache.
Dentro de var/cache, verás subcarpetas como dev, prod o carpetas con nombres alfanuméricos.
Borra todo el contenido de la carpeta var/cache (selecciona todo y elimínalo). No te preocupes, PrestaShop la volverá a crear automáticamente.

[WARNING] No borres la carpeta var/cache en sí, solo su contenido interno. Si la borras, PrestaShop puede dar error al crearla de nuevo.

Paso 6: Prueba tu tienda

Ahora viene la parte emocionante. Abre una nueva pestaña en tu navegador y escribe la URL de tu tienda PrestaShop.

Si ves tu tienda funcionando: ¡Felicidades! Has solucionado el error. Tu tienda ya está en línea.
Si aún ves el error: No te desanimes. A veces el problema es más profundo. Prueba estos pasos adicionales.

Preguntas Frecuentes (FAQ) sobre el error de base de datos

Aquí respondo a las dudas más comunes que me llegan.

¿Qué hago si después de todo el error persiste?

Si has seguido todos los pasos y el PrestaShop no conecta DB, puede ser un problema del servidor. Contacta a tu proveedor de hosting y diles: "Tengo un error de conexión a la base de datos en PrestaShop alojado en Plesk. Ya verifiqué credenciales y permisos, pero el servicio de base de datos parece tener un problema". Ellos podrán revisar los logs del servidor.

¿Puedo usar otro gestor de bases de datos como phpMyAdmin en Plesk?

Sí, claro. En Plesk, dentro de la sección "Bases de datos", suele haber un enlace directo a phpMyAdmin. Puedes usarlo para verificar que la base de datos existe y que el usuario puede conectarse. Es una herramienta muy útil.

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

Sí, es posible. Después de actualizar PrestaShop, el archivo parameters.php puede dañarse o cambiar de formato. Siempre es buena práctica hacer una copia de seguridad de este archivo antes de actualizar.

¿Qué pasa si mi hosting usa Syspanel (HestiaCP)?

Si tu proveedor usa Syspanel (HestiaCP), el proceso es similar pero el acceso es diferente. Recuerda que el puerto de acceso a Syspanel es el 2106 (por ejemplo, https://tudominio.com:2106). Dentro de Syspanel, busca la sección "Base de datos" y sigue los mismos pasos para verificar credenciales y permisos. El archivo parameters.php se encuentra en la misma ruta dentro de tu sitio.

¿Es seguro editar el archivo parameters.php?

Sí, siempre que no borres nada más de lo necesario. Solo modifica las líneas de database_* que te indiqué. Si no te sientes seguro, haz una copia de seguridad del archivo antes de editarlo (puedes descargarlo a tu PC).

Conclusión

El error base datos PrestaShop es un problema común pero, como has visto, tiene solución. La clave está en verificar metódicamente las credenciales, los permisos y el estado del servicio. Con un poco de paciencia y siguiendo estos pasos, tu tienda volverá a estar operativa.

Recuerda que la prevención es la mejor herramienta. Te recomiendo:

Hacer copias de seguridad periódicas de tu base de datos y archivos de configuración.
Anotar las credenciales en un lugar seguro (como un gestor de contraseñas).
Mantener tu PrestaShop y sus módulos actualizados para evitar conflictos.

Si en algún momento te sientes abrumado, no dudes en contactar a tu proveedor de hosting. Para eso estamos. ¡Mucho éxito con tu tienda online!