Solucionar error de base de datos en PrestaShop con Plesk

¿Tu tienda PrestaShop dejó de funcionar de repente y te muestra un mensaje de error de base de datos? No te preocupes, es una de las incidencias más comunes al gestionar un hosting con Plesk, y lo bueno es que en la mayoría de los casos tiene solución sin necesidad de ser un experto en programación.

En esta guía completa, paso a paso y súper fácil de seguir, vamos a resolver juntos el error base datos PrestaShop Plesk, asegurando que tu PrestaShop conexión base datos vuelva a la normalidad. Incluiremos desde las causas más simples hasta soluciones más técnicas, siempre explicadas en lenguaje claro.

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

Antes de lanzarnos a arreglarlo, es útil entender por qué pasa. PrestaShop guarda toda la información de tu tienda (productos, clientes, pedidos) en una base de datos MySQL o MariaDB. Cuando tu tienda no puede conectar con esa base de datos, se bloquea y muestra un error como: “Error de conexión a la base de datos”, “Link to database cannot be established” o simplemente una pantalla en blanco.

Las causas más frecuentes en un entorno Plesk son:

Cambio de contraseña de la base de datos (la más común).
Corrupción de archivos de configuración (especialmente settings.inc.php).
Problemas con el servidor MySQL/MariaDB (caído, sobrecargado, o bloqueado por IP).
Permisos incorrectos del usuario de la base de datos.
Actualización fallida de PrestaShop o de algún módulo.
Migración o cambio de hosting donde las credenciales no se actualizaron.

Vamos a solucionarlo paso a paso.

Paso 1: Lo primero, verifica que el servidor de bases de datos esté funcionando

A veces la solución es más sencilla de lo que parece. Antes de tocar archivos, asegúrate de que MySQL o MariaDB esté activo en tu servidor Plesk.

¿Cómo verificarlo desde Plesk?

Accede a tu panel de Plesk (normalmente https://tudominio.com:8443 o la URL que te haya dado tu proveedor).
Ve a Herramientas y Configuración (en el menú izquierdo).
Busca la sección Servidor y haz clic en Servicios.
Busca el servicio de base de datos (puede llamarse MySQL, MariaDB o Database server).
Asegúrate de que su estado sea “en ejecución” (verde). Si está detenido, haz clic en el botón de inicio.

[TIP] Si no ves la opción de Servicios, es posible que tu plan de hosting no te dé acceso a esta configuración. En ese caso, contacta con tu proveedor de hosting y pregúntales si el servidor de base de datos está caído.

Si el servicio está corriendo, pasamos al siguiente paso.

Paso 2: Revisa las credenciales de la base de datos en el archivo settings.inc.php

Este es el punto crítico. PrestaShop guarda la información de conexión en un archivo llamado settings.inc.php. Si la contraseña de tu base de datos cambió (por ejemplo, porque la reiniciaste desde Plesk), tu tienda se quedará sin conexión.

Localiza y edita el archivo

Accede a tu hosting mediante FTP o el Administrador de archivos de Plesk.
Navega hasta la carpeta de tu tienda PrestaShop (normalmente httpdocs o public_html).
Dentro, busca la carpeta app/config/. Allí encontrarás el archivo parameters.php (en PrestaShop 1.7 y 8.x) o config/settings.inc.php (en PrestaShop 1.6).
Descarga una copia de seguridad de ese archivo antes de editarlo (por si algo sale mal).
Ábrelo con un editor de texto plano (como Notepad++, Sublime Text o el editor de Plesk).

¿Qué debes buscar y corregir?

Dentro del archivo verás líneas como estas (en parameters.php):

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

O en settings.inc.php (versiones antiguas):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_basededatos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

Lo que debes hacer:

database_host: Normalmente es localhost. Si tu base de datos está en un servidor remoto, aquí irá la IP o el nombre del host.
database_name: Debe coincidir exactamente con el nombre de la base de datos que ves en Plesk (en la sección Bases de datos).
database_user: Debe coincidir con el usuario asignado a esa base de datos.
database_password: Aquí está el truco. Si recientemente cambiaste la contraseña de la base de datos desde Plesk, debes actualizar esta línea con la nueva contraseña.

[WARNING] Si no recuerdas la contraseña actual, ve a Plesk > Bases de datos, selecciona tu base de datos y haz clic en Cambiar contraseña. Anótala y pégala en el archivo.

Guarda los cambios y sube el archivo de nuevo al servidor (si lo editaste localmente). Luego recarga tu tienda. Si el error persiste, continúa.

Paso 3: Verifica que el usuario de la base de datos tenga los permisos correctos

A veces, aunque la contraseña sea correcta, el usuario no tiene acceso a la base de datos. Esto pasa después de migraciones o restauraciones.

Cómo comprobarlo en Plesk

En Plesk, ve a Bases de datos.
Busca la base de datos que usa tu PrestaShop.
Haz clic en el nombre de la base de datos.
Verás una lista de Usuarios de base de datos. Asegúrate de que el usuario que aparece en parameters.php esté en esa lista.
Si no está, añádelo: haz clic en Añadir usuario, selecciona el usuario existente (o crea uno nuevo) y asígnale todos los privilegios (especialmente SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).

[INFO] Si creaste un nuevo usuario, recuerda actualizar también el parameters.php con ese nuevo nombre de usuario y contraseña.

Paso 4: Prueba la conexión manualmente desde phpMyAdmin

Si los pasos anteriores no funcionan, podemos hacer una prueba directa para descartar que sea un problema de la base de datos en sí.

Accede a phpMyAdmin desde Plesk

En Plesk, ve a Bases de datos.
Haz clic en el nombre de tu base de datos.
Busca el botón phpMyAdmin (suele estar arriba a la derecha o en el menú de acciones). Si no lo ves, puede que tu plan no lo incluya; en ese caso, contacta con soporte.
Se abrirá una nueva pestaña con phpMyAdmin. Intenta iniciar sesión con el usuario y contraseña que tienes en parameters.php.
- Si puedes entrar: La base de datos y las credenciales son correctas. El problema está en otro lado (probablemente en el archivo de configuración o en algún módulo).
- Si NO puedes entrar: Te da un error como “#1045 - Access denied for user”. Esto confirma que las credenciales son incorrectas o que el usuario no tiene permisos. Vuelve al Paso 2 y 3.

Paso 5: Revisa el archivo .htaccess y la configuración de caché

A veces, un .htaccess corrupto o una caché de PrestaShop mal configurada pueden simular un error de base de datos.

Restaura el .htaccess por defecto

Desde FTP o el administrador de archivos, localiza el archivo .htaccess en la raíz de tu tienda (carpeta httpdocs).
Renómbralo a .htaccess_old (esto lo desactiva temporalmente).
Recarga tu tienda. Si ahora funciona, el .htaccess estaba dañado. Puedes regenerarlo desde el panel de administración de PrestaShop (si logras entrar) o pidiendo a tu hosting que lo restaure.

Limpia la caché de PrestaShop manualmente

Si no puedes acceder al back office, borra manualmente la caché:

Ve a la carpeta var/cache/ (en PrestaShop 1.7 y 8) o cache/ (en 1.6).
Elimina todo el contenido de las carpetas dev y prod (o cache/ en versiones antiguas). No borres las carpetas, solo los archivos de dentro.
Vuelve a intentar cargar tu tienda.

[TIP] Si después de borrar la caché el error sigue, puede que el problema sea un módulo que está forzando una conexión incorrecta. Prueba a renombrar la carpeta modules a modules_old temporalmente. Si la tienda carga, entonces algún módulo está causando el conflicto. Ve activándolos uno a uno para identificar al culpable.

Paso 6: Verifica la versión de PHP y la compatibilidad con PrestaShop

PrestaShop es exigente con la versión de PHP. Si tu hosting en Plesk actualizó PHP recientemente, tu tienda podría no ser compatible.

Cómo cambiar la versión de PHP en Plesk

En Plesk, ve a Dominios web y selecciona tu dominio.
Busca la sección PHP o Configuración de PHP.
Cambia la versión a una compatible con tu PrestaShop:
- PrestaShop 1.6: PHP 5.6 a 7.1 (recomendado 7.0).
- PrestaShop 1.7: PHP 7.1 a 7.4 (recomendado 7.4).
- PrestaShop 8.x: PHP 7.4 a 8.1 (recomendado 8.0).
Guarda los cambios y prueba de nuevo.

Paso 7: Revisa los logs de error para obtener pistas exactas

Si nada de lo anterior funciona, los logs de error son tus mejores aliados. Te dirán exactamente qué está fallando.

Dónde encontrar los logs

Logs de PrestaShop: En la carpeta var/logs/ (PrestaShop 1.7 y 8) o log/ (1.6). Busca archivos con extensión .log y ábrelos.
Logs del servidor (Plesk): Ve a Herramientas y Configuración > Registros > Registro de errores. Busca errores relacionados con MySQL o con tu dominio.
Logs de PHP: En Plesk, dentro de la configuración de PHP de tu dominio, a veces hay un enlace a los logs de errores de PHP.

Busca palabras como “database”, “MySQL”, “PDO”, “connection”, “access denied”. Esa línea te dará la pista definitiva.

Preguntas Frecuentes (FAQ)

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

Si has seguido todos los pasos y el error base datos PrestaShop Plesk sigue apareciendo, es probable que el problema sea a nivel de servidor (MySQL caído, firewall bloqueando conexiones, o un bug de Plesk). En ese caso, contacta con el soporte técnico de tu hosting y muéstrales los pasos que ya has seguido. Ellos podrán revisar los logs del servidor.

¿Puedo perder datos si edito el archivo settings.inc.php?

No, siempre que no borres líneas esenciales. Solo estás actualizando credenciales. Siempre haz una copia de seguridad antes de editar.

¿Por qué mi base de datos aparece vacía en phpMyAdmin?

Esto puede pasar si la base de datos se corrompió o si hiciste una restauración incorrecta. Necesitarás restaurar una copia de seguridad de tu base de datos desde Plesk (sección Bases de datos > Restaurar). Si no tienes copia, contacta con soporte urgente.

¿El error puede deberse a un plugin de caché?

Sí, especialmente si el plugin de caché guarda consultas a la base de datos. Si instalaste un plugin de caché justo antes del error, desactívalo renombrando su carpeta en modules.

¿Qué es exactamente “Syspanel” y cómo se relaciona con esto?

Si tu hosting usa Syspanel (el nombre que le damos a HestiaCP), el proceso es similar, pero el acceso al panel es por el puerto 2106 (ejemplo: https://tudominio.com:2106). Allí también podrás gestionar bases de datos, usuarios y contraseñas, y seguir los mismos pasos que en Plesk.

Conclusión: No te rindas, la solución está cerca

Resolver un error base datos PrestaShop Plesk puede parecer abrumador, pero como has visto, la mayoría de las veces se soluciona actualizando una contraseña o verificando un archivo de configuración. Sigue esta guía paso a paso, con calma, y tu PrestaShop conexión base datos volverá a funcionar.

Recuerda: siempre haz copias de seguridad antes de hacer cambios. Y si en algún momento te sientes perdido, el soporte de tu hosting está para ayudarte. ¡Tu tienda online volverá a la vida en poco tiempo!