Error Conexión Base de Datos PrestaShop en Plesk | Solución 2024

¿Por qué aparece el error "Cannot connect to the database" en PrestaShop y Plesk?

Si estás leyendo esto, es muy probable que hayas intentado abrir tu tienda online y te hayas encontrado con un mensaje tan frustrante como críptico: "Cannot connect to the database" o, en español, "No se puede conectar a la base de datos". No te preocupes, es uno de los errores más comunes en el mundo del hosting y, en la gran mayoría de los casos, tiene una solución clara y paso a paso.

Este error en tu instalación de PrestaShop sobre Plesk significa, literalmente, que tu tienda no puede establecer una comunicación con el servidor de bases de datos MySQL o MariaDB donde se guardan tus productos, pedidos y clientes. Es como si intentaras abrir tu almacén, pero la llave no encaja en la cerradura. Las causas pueden ser varias, desde un cambio de contraseña hasta un archivo de configuración con datos incorrectos.

En este artículo, vamos a desglosar, como si estuvieras hablando con un técnico de soporte amigable, todas las soluciones posibles para este quebradero de cabeza. Vamos a ir desde lo más simple (y que a veces se nos pasa por alto) hasta la revisión profunda de archivos de configuración como parameters.php. Al final, tendrás un plan de acción claro para solucionar error base datos prestashop sin necesidad de ser un experto en desarrollo.

Primeros pasos: Diagnóstico inicial y comprobaciones rápidas

Antes de lanzarnos a modificar archivos, vamos a hacer un pequeño ejercicio de detective. El error cannot connect to database prestashop puede deberse a un simple despiste o a un problema temporal del servidor.

1. Verifica que el servicio de base de datos esté activo en Plesk

Plesk gestiona los servicios del servidor. A veces, por mantenimiento o un fallo puntual, el servicio de MySQL/MariaDB se detiene. Para comprobarlo:

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 esta sección, busca el apartado "Servidor" y haz clic en "Servicios" o "Gestión de servicios" (el nombre puede variar ligeramente según la versión).
Busca en la lista el servicio de MySQL o MariaDB. Asegúrate de que el estado sea "Activo" o "Corriendo".
Si está detenido, selecciónalo y haz clic en el botón "Iniciar" (el icono de "play").

[TIP] Si el servicio se detiene solo con frecuencia, puede ser un problema de falta de memoria en el servidor. Te recomendaría contactar con tu proveedor de hosting para que revisen el consumo de recursos.

2. Comprueba las credenciales de acceso (usuario y contraseña)

El error también puede aparecer si las credenciales de acceso a la base de datos han sido cambiadas recientemente, ya sea por ti, por otro usuario o por un proceso automático de seguridad.

Ve a tu panel de Plesk.
En la sección "Sitios web y dominios", localiza tu tienda PrestaShop.
Busca el apartado "Bases de datos" (normalmente en la parte inferior o en un icono de engranaje). Haz clic en "Gestionar bases de datos" o en el nombre de la base de datos.
Ahora verás el nombre de la base de datos y el nombre del usuario asociado.
Si no estás seguro de la contraseña, puedes cambiarla desde aquí. Plesk te permite "Cambiar contraseña" fácilmente. Anota la nueva contraseña, la necesitarás para el siguiente paso.

[WARNING] Si cambias la contraseña aquí, tendrás que actualizarla en el archivo de configuración de PrestaShop. Si no lo haces, el error persistirá. Ve al siguiente punto para saber cómo hacerlo.

La solución clave: Revisar y corregir el archivo `parameters.php`

Este es el corazón del problema. PrestaShop guarda la configuración de conexión a la base de datos en un archivo llamado parameters.php. Si este archivo tiene datos incorrectos (usuario, contraseña, nombre de la BD o servidor), la tienda no podrá conectarse. Este archivo se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. En Plesk, puedes acceder a él de dos maneras: a través del Administrador de archivos de Plesk o por FTP.

Acceso a través del Administrador de Archivos de Plesk (Recomendado)

En Plesk, ve a "Sitios web y dominios".
Busca tu dominio y haz clic en "Administrador de archivos" (el icono de carpeta).
Navega a la carpeta httpdocs (o public_html, dependiendo de la configuración). Dentro, busca la carpeta app y luego config.
Verás el archivo parameters.php. Haz clic derecho sobre él y selecciona "Editar" o "Editar en el editor de texto".

Entendiendo el contenido del archivo

El archivo parameters.php contiene un array de PHP con los datos de conexión. Busca las líneas que empiezan con 'database_host', 'database_name', 'database_user' y 'database_password'. Se verá algo así (los valores son ejemplos):

'database_host' => 'localhost',
'database_name' => 'tu_usuario_bd',
'database_user' => 'tu_usuario_bd',
'database_password' => 'tu_contraseña_bd',

Qué debes verificar y corregir

database_host: Lo más común es que sea localhost, pero algunos proveedores usan un host remoto como mysql.tudominio.com. Verifica con tu proveedor si no estás seguro. Si usas Plesk, lo normal es localhost.
database_name: Debe coincidir EXACTAMENTE con el nombre que ves en la sección de "Bases de datos" de Plesk. Cualquier error tipográfico, incluso un guion bajo mal puesto, causará el error.
database_user: Igual que el anterior, debe ser idéntico al usuario que aparece en Plesk.
database_password: Este es el punto más crítico. Si cambiaste la contraseña en Plesk, debes poner la nueva aquí. Asegúrate de que no haya espacios antes o después de la contraseña, dentro de las comillas.

Una vez que hayas corregido los valores, guarda el archivo (Ctrl+S o el botón de guardar) y vuelve a intentar cargar tu tienda.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (una coma que falta, una comilla sin cerrar) puede romper toda la tienda. Si no te sientes seguro, copia el contenido del archivo a un bloc de notas antes de editarlo, por si acaso.

Soluciones avanzadas: Más allá de `parameters.php`

Si has verificado el archivo parameters.php y las credenciales son correctas, pero el error error prestashop plesk persiste, el problema puede ser más profundo. Vamos a explorar otras causas.

1. Problemas con el prefijo de las tablas

PrestaShop permite usar un prefijo para las tablas de la base de datos (por ejemplo, ps_). Este prefijo se guarda en el archivo parameters.php (en la línea 'database_prefix') y también en la propia base de datos.

Accede a Plesk y entra en la sección de "Bases de datos".
Haz clic en el nombre de tu base de datos para entrar en phpMyAdmin (la herramienta de gestión de BD).
En el panel izquierdo, verás la lista de tablas. Todas deberían tener el mismo prefijo (ej. ps_orders, ps_products).
Vuelve al archivo parameters.php y verifica que el valor de 'database_prefix' coincide exactamente con el de las tablas. Si no coincide, cámbialo y guarda.

2. El usuario de la base de datos no tiene privilegios suficientes

En Plesk, cada base de datos tiene un usuario asociado con permisos específicos. Si el usuario solo tiene permisos de "SELECT" (lectura) pero no de "INSERT" o "UPDATE", PrestaShop no podrá funcionar correctamente y puede mostrar un error de conexión o de escritura.

Ve a Plesk > "Bases de datos".
Haz clic en el nombre de tu base de datos.
Verás una sección que dice "Usuarios de la base de datos". Haz clic en el icono de "lápiz" (editar) junto al usuario correspondiente.
Asegúrate de que la casilla "Todos los privilegios" esté marcada. Si no es así, selecciónala y guarda los cambios.

3. El servidor de base de datos no es `localhost`

Aunque es poco común en entornos Plesk compartidos, algunos planes de hosting utilizan un servidor de base de datos separado. Si has configurado tu tienda recientemente y has movido los archivos, es posible que el database_host no sea localhost.

Revisa la información de bienvenida de tu proveedor de hosting o el panel de Plesk. A veces, el host de la base de datos aparece en la propia sección de "Bases de datos".
Si ves algo como mysql.tudominio.com, ese es tu host. Pruébalo en el archivo parameters.php.

4. Limpiar la caché de PrestaShop

A veces, PrestaShop guarda en caché la configuración antigua. Aunque hayas corregido parameters.php, la tienda puede seguir intentando usar los datos antiguos.

Accede a la carpeta var/cache de tu instalación de PrestaShop (en la raíz de httpdocs).
Dentro, verás subcarpetas con nombres de entornos como dev o prod.
Borra TODO el contenido de estas carpetas (no las carpetas en sí, sino los archivos que hay dentro). También puedes borrar los archivos llamados class_index.php si existen.
Vuelve a cargar tu tienda. PrestaShop regenerará la caché automáticamente.

[TIP] Si no puedes borrar los archivos desde el Administrador de archivos de Plesk, prueba a hacerlo por FTP con un cliente como FileZilla. A veces, los permisos de los archivos impiden la eliminación desde el panel.

El error persiste: Pasos finales y prevención

Si después de todos estos pasos el error cannot connect to database prestashop sigue apareciendo, es hora de considerar opciones más drásticas.

1. Verificar los permisos de los archivos y carpetas

Plesk gestiona los permisos, pero a veces una restauración o una actualización puede alterarlos. Los archivos de PrestaShop deben tener permisos de lectura y escritura para el usuario del sistema.

En el Administrador de archivos de Plesk, selecciona todos los archivos y carpetas de tu instalación de PrestaShop.
Haz clic en el botón de "Permisos" o "Cambiar permisos".
Asegúrate de que el propietario tenga permisos de lectura y escritura. No es necesario dar permisos de ejecución a los archivos .php, pero sí a las carpetas.
Una configuración segura es 755 para carpetas y 644 para archivos. Plesk tiene una opción para "establecer permisos de archivos y carpetas" que hace esto automáticamente.

2. Revisar los logs de error del servidor

Los logs son la bitácora del servidor y nos dirán exactamente qué está fallando. Es la mejor herramienta de diagnóstico.

En Plesk, ve a "Sitios web y dominios".
Haz clic en tu dominio y busca la sección "Logs" o "Registros de acceso".
Busca el archivo de error de PHP (normalmente llamado error.log o php_error.log).
Abre el archivo y busca las últimas entradas relacionadas con tu tienda. El mensaje de error aquí será mucho más técnico y te dará pistas exactas (por ejemplo, "Access denied for user 'x'@'localhost'").

[INFO] Si no te sientes cómodo interpretando los logs, puedes copiar las últimas 20-30 líneas del error y enviarlas a tu soporte técnico. Te ayudarán a descifrarlo.

3. Restaurar una copia de seguridad reciente

Si todo lo demás falla y tienes una copia de seguridad de tu base de datos y de los archivos de cuando la tienda funcionaba correctamente, esta es la solución definitiva.

En Plesk, ve a "Sitios web y dominios".
Haz clic en tu dominio y busca la sección "Copias de seguridad".
Selecciona la copia más reciente que sea anterior al error y restaura tanto los archivos como la base de datos.
Esto revertirá cualquier cambio incorrecto que haya causado el problema.

Preguntas Frecuentes (FAQ) sobre el error de conexión a BD

¿Qué es exactamente `parameters.php`?

Es el archivo de configuración principal de PrestaShop. Contiene la información sensible para conectar con la base de datos (nombre, usuario, contraseña, host). Sin él, la tienda no puede funcionar.

¿Por qué he cambiado la contraseña de la BD en Plesk y ahora da error?

Porque PrestaShop sigue usando la contraseña antigua que está escrita en parameters.php. Debes actualizar manualmente ese archivo con la nueva contraseña, tal como hemos explicado en el artículo.

¿Puedo usar el mismo usuario de BD para dos bases de datos diferentes?

En Plesk, un usuario puede tener acceso a varias bases de datos. Sin embargo, te recomiendo tener un usuario dedicado para cada base de datos de PrestaShop para evitar confusiones y problemas de seguridad.

¿El error puede deberse a un ataque o a un hackeo?

Es poco probable que un ataque cause directamente este error, pero un hackeo podría haber modificado el archivo parameters.php o truncado la base de datos. Si sospechas de un ataque, cambia todas las contraseñas (panel de control, FTP, base de datos) y revisa los logs de acceso.

¿Qué significa el error "Access denied for user"?

Este mensaje en los logs de Plesk significa que el usuario de la base de datos no tiene permiso para conectarse desde el host desde el que se intenta. Esto refuerza la necesidad de verificar el database_host en parameters.php y los privilegios del usuario en Plesk.

Conclusión y consejos finales

El error error prestashop plesk puede ser desalentador, pero como has visto, es un problema muy manejable con un enfoque metódico. Hemos recorrido el camino desde lo más simple (reiniciar el servicio) hasta lo más técnico (editar parameters.php y revisar logs). La clave está en la paciencia y en verificar cada paso con cuidado.

Recuerda los puntos clave:

Siempre verifica las credenciales antes de tocar nada más.
parameters.php es tu mejor amigo y tu peor enemigo; edítalo con sumo cuidado.
Los logs del servidor son la fuente definitiva de la verdad.
Las copias de seguridad son tu red de seguridad. Asegúrate de tenerlas activadas.

Espero que este artículo te haya sido de gran ayuda. Si has llegado hasta aquí y has probado todas las soluciones sin éxito, puede que el problema sea más específico de tu entorno de servidor. En ese caso, no dudes en contactar con el soporte técnico de tu proveedor de hosting, proporcionándoles la información de los logs y los pasos que ya has seguido. ¡Buena suerte y a vender!