Solución error de conexión a base de datos en PrestaShop (Plesk)

¿Qué significa exactamente el error "Cannot connect to the database"?

Cuando tu tienda PrestaShop muestra el mensaje "Cannot connect to the database", significa que tu aplicación no puede establecer una conexión con el servidor MySQL donde se almacenan todos tus productos, pedidos, clientes y configuraciones. Es uno de los errores más comunes en PrestaShop y, aunque parece grave, en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto.

Este error puede aparecer de varias formas: al intentar acceder a tu tienda, al entrar al panel de administración, o incluso de repente cuando tu tienda ya estaba funcionando. La buena noticia es que las causas suelen ser pocas y muy concretas.

Causas más frecuentes del error base de datos PrestaShop

Antes de lanzarnos a solucionar el problema, es importante que entiendas qué puede estar fallando. Estas son las causas más habituales:

Credenciales incorrectas en el archivo de configuración parameters.php.
El servicio MySQL está detenido o no responde en el servidor.
La base de datos ha sido eliminada o el nombre no coincide.
El usuario de MySQL no tiene permisos suficientes para acceder a la base de datos.
Problemas con la contraseña (caracteres especiales que se interpretan mal).
El servidor MySQL está saturado o alcanzó su límite de conexiones.
Cambios recientes en Plesk (migraciones, actualizaciones, cambios de contraseña).

Primeros pasos: identifica el alcance del problema

Cuando PrestaShop no conecta Plesk, lo primero que debes hacer es determinar si el problema afecta solo a tu tienda o si es un fallo general del servidor.

Comprueba si otras webs funcionan

Si tienes otras páginas web en el mismo servidor Plesk, intenta acceder a ellas. Si también fallan, el problema probablemente sea del servidor MySQL en general. Si solo tu PrestaShop falla, el problema está en la configuración de tu tienda.

Accede a phpMyAdmin

Desde Plesk, entra en tu dominio y busca el icono de phpMyAdmin. Si puedes acceder y ver tus bases de datos, significa que MySQL está funcionando. Si no puedes, el servicio MySQL está caído.

[WARNING] Si no puedes acceder a phpMyAdmin, contacta con tu proveedor de hosting de inmediato. Es un problema de servidor que no podrás resolver desde el panel.

Solución paso a paso: cómo resolver el error base de datos PrestaShop

Paso 1: Verifica el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en el archivo app/config/parameters.php. Este es el primer lugar donde debes mirar.

Accede al Administrador de archivos de Plesk.
Navega hasta la carpeta httpdocs (o public_html según tu configuración).
Entra en la carpeta app, luego en config.
Busca el archivo parameters.php y haz clic derecho para editarlo.

Dentro del archivo, busca estas líneas:

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

Verifica que los valores coincidan exactamente con los que tienes en Plesk. Puedes comprobarlos en la sección Bases de datos de tu dominio en Plesk.

[TIP] Si has cambiado recientemente la contraseña de tu base de datos en Plesk, asegúrate de actualizarla también aquí. Es una de las causas más comunes del error base de datos PrestaShop.

Paso 2: Comprueba que el servicio MySQL está activo

Si los datos son correctos, el siguiente paso es verificar que el servicio MySQL esté funcionando.

En Plesk, ve a Herramientas y configuración.
Busca la sección Servicios o Administración de servicios.
Localiza MySQL y comprueba que está en estado "activo" o "ejecutándose".

Si está detenido, intenta iniciarlo desde el mismo panel. Si no puedes iniciarlo o se detiene de nuevo, contacta con tu proveedor de hosting.

Paso 3: Verifica los permisos del usuario de MySQL

Otra causa frecuente cuando PrestaShop no conecta Plesk es que el usuario de la base de datos no tenga los permisos adecuados.

Ve a Bases de datos en tu dominio de Plesk.
Localiza la base de datos que usa tu PrestaShop.
Haz clic en Agregar usuario o Administrar usuarios.
Asegúrate de que el usuario tiene marcada la opción "Todos los privilegios".

Si el usuario ya existe pero no tiene permisos, edítalo y selecciona todos los privilegios disponibles.

[INFO] El usuario de MySQL y la base de datos pueden tener nombres diferentes. Asegúrate de usar exactamente el nombre que aparece en Plesk, incluyendo el prefijo que suele ser el nombre de usuario del plan de hosting (ejemplo: usuario123_bd_prestashop).

Paso 4: Soluciona problemas con la contraseña

A veces la contraseña contiene caracteres especiales como $, #, %, & que pueden interpretarse mal en el archivo de configuración.

Solución recomendada:

Cambia la contraseña de la base de datos directamente en Plesk.
Usa solo letras y números para evitar problemas.
Actualiza el archivo parameters.php con la nueva contraseña.
Guarda los cambios y prueba de nuevo.

[WARNING] Al cambiar la contraseña en Plesk, asegúrate de actualizarla también en el archivo parameters.php de PrestaShop. Si no lo haces, seguirás viendo el mismo error.

Paso 5: Revisa el archivo settings.inc.php (versiones antiguas)

Si tu PrestaShop es anterior a la versión 1.7, el archivo de configuración es diferente. Busca config/settings.inc.php en la raíz de tu instalación.

Contiene las mismas variables pero con nombre distinto:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_bd');
define('_DB_USER_', 'usuario_bd');
define('_DB_PASSWD_', 'contraseña');

Aplica las mismas comprobaciones que en el paso anterior.

Paso 6: Limpia la caché de PrestaShop

A veces, aunque la configuración sea correcta, PrestaShop guarda datos antiguos en su caché que provocan el error. Para limpiarla:

Accede al Administrador de archivos de Plesk.
Entra en la carpeta var/cache dentro de tu instalación de PrestaShop.
Elimina todo el contenido de esta carpeta (no la carpeta en sí).
También puedes eliminar el contenido de app/cache si existe.

[TIP] Si no puedes acceder a tu tienda ni al panel de administración, elimina los archivos de caché manualmente desde FTP o el administrador de archivos de Plesk. Esto no elimina datos de tu tienda, solo archivos temporales.

Paso 7: Verifica la conexión desde la línea de comandos (opcional avanzado)

Si tienes acceso SSH, puedes probar la conexión directamente:

mysql -u tu_usuario -p tu_basededatos

Te pedirá la contraseña. Si puedes entrar, el problema está en PrestaShop. Si no puedes, el problema está en MySQL o en las credenciales.

Solución error PrestaShop: casos especiales

Si has movido tu tienda de servidor

Si acabas de migrar tu PrestaShop a un nuevo servidor Plesk, es muy probable que el error se deba a que el archivo parameters.php aún contiene los datos del servidor anterior.

Solución: Actualiza todos los datos de conexión con los del nuevo servidor. Asegúrate también de que la base de datos fue importada correctamente.

Si has cambiado la contraseña de MySQL en Plesk

Plesk te permite cambiar la contraseña de acceso a MySQL. Si lo has hecho, PrestaShop seguirá intentando conectarse con la contraseña anterior.

Solución: Actualiza el archivo parameters.php con la nueva contraseña inmediatamente después de cambiarla en Plesk.

Si el error aparece después de una actualización de PrestaShop

Las actualizaciones pueden modificar la estructura de la base de datos. Si algo falla durante la actualización, puedes encontrarte con este error.

Solución: Revisa si tienes una copia de seguridad de tu base de datos anterior. Restaura esa copia y vuelve a intentar la actualización.

MySQL PrestaShop Plesk: preguntas frecuentes

¿Por qué mi PrestaShop muestra el error después de un reinicio del servidor?

Es normal que después de un reinicio, algunos servicios tarden en arrancar. Espera unos minutos y recarga la página. Si persiste, verifica que MySQL esté activo en Plesk.

¿Puedo evitar este error en el futuro?

Sí, sigue estas buenas prácticas:

Realiza copias de seguridad periódicas de tu base de datos.
Anota las contraseñas de MySQL en un lugar seguro.
Actualiza PrestaShop y sus módulos regularmente.
No cambies las contraseñas sin actualizar el archivo de configuración.

¿Qué hago si nada de esto funciona?

Si has seguido todos los pasos y el error persiste, puede haber un problema más profundo en el servidor. Contacta con tu proveedor de hosting y proporciona esta información:

El mensaje de error exacto.
Los pasos que ya has intentado.
Si puedes acceder a phpMyAdmin o no.
La fecha en que empezó el problema.

[TIP] Guarda siempre una copia de seguridad reciente de tu base de datos MySQL PrestaShop Plesk. Esto te permitirá restaurar tu tienda rápidamente ante cualquier problema.

Prevención: buenas prácticas para evitar futuros errores

Para minimizar las posibilidades de volver a encontrarte con este error, te recomendamos:

Documenta tus credenciales: Guarda en un lugar seguro los nombres de usuario y contraseñas de todas tus bases de datos.
Realiza copias de seguridad automáticas: Plesk permite configurar copias de seguridad programadas. Actívalas semanalmente.
Mantén PrestaShop actualizado: Las versiones antiguas pueden tener problemas de compatibilidad con versiones nuevas de MySQL.
No modifiques archivos de configuración sin hacer copia: Antes de editar parameters.php, guarda una copia del original.
Monitoriza el espacio en disco: Si el disco se llena, MySQL puede dejar de funcionar correctamente.

Resumen final: checklist rápido de solución

Si el error aparece de repente, sigue este orden:

Revisa si otras webs funcionan → Determina si es un problema general.
Accede a phpMyAdmin → Comprueba si MySQL está activo.
Verifica parameters.php → Asegúrate de que los datos son correctos.
Comprueba los permisos del usuario → Debe tener todos los privilegios.
Limpia la caché de PrestaShop → Elimina archivos temporales.
Actualiza la contraseña → Si dudas, cambia la contraseña en Plesk y actualízala en el archivo.

Con estos pasos, resolverás el error base de datos PrestaShop en la gran mayoría de los casos. Recuerda que la paciencia y la revisión metódica son tus mejores aliadas. No tengas miedo de explorar los paneles de Plesk: la información que necesitas siempre está ahí, solo hay que saber dónde mirar.

Si después de todo esto el problema continúa, no dudes en buscar ayuda profesional. Un buen proveedor de hosting siempre está dispuesto a ayudarte con este tipo de incidencias.