Cómo arreglar error de base de datos en PrestaShop en Plesk

¿Tu tienda PrestaShop muestra un mensaje de error de conexión a la base de datos? No te preocupes, es uno de los problemas más comunes cuando gestionas un hosting con Plesk. Este error puede aparecer de repente después de una migración, una actualización o simplemente al intentar acceder al back office. En esta guía extensa y paso a paso, te explicaré todo lo que necesitas saber para solucionar el error base de datos PrestaShop Plesk, desde lo más básico hasta soluciones avanzadas. Vamos a desglosar las causas y las soluciones para que tu tienda vuelva a funcionar en pocos minutos.

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

Cuando ves un mensaje como "No se puede conectar a la base de datos" o "Error de conexión MySQL", significa que PrestaShop no puede comunicarse con el servidor de bases de datos MySQL o MariaDB que está gestionado por Plesk. Las causas más frecuentes son:

Credenciales incorrectas en el archivo app/config/parameters.php.
Problemas con el servidor MySQL (caído, sobrecargado o mal configurado).
Permisos de usuario de base de datos mal asignados en Plesk.
Firewall o restricciones de conexión que bloquean el puerto 3306.
Espacio en disco insuficiente en el servidor.
Actualización de PHP o PrestaShop que rompe la configuración.

Vamos a solucionarlo paso a paso.

Paso 1: Verifica el estado del servidor MySQL en Plesk

Antes de tocar archivos, asegúrate de que el motor de base de datos esté funcionando correctamente. Plesk suele gestionar MySQL/MariaDB de forma automática, pero a veces se detiene.

Accede a Plesk (normalmente https://tudominio.com:8443).
Ve a Herramientas y Configuración > Servicios o Administrador de Servicios.
Busca el servicio MySQL o MariaDB. Debe aparecer como “En ejecución”.
Si está detenido, haz clic en Iniciar.

[INFO] Si no ves la opción de servicios, es posible que tu plan de hosting no te permita gestionarlos. En ese caso, contacta con tu proveedor de hosting y pídeles que reinicien MySQL.

Si el servicio se inicia pero vuelve a pararse, puede haber un problema de recursos (RAM, disco). Revisa el uso de disco en Herramientas y Configuración > Uso de Disco.

Paso 2: Revisa las credenciales en el archivo de configuración de PrestaShop

El archivo app/config/parameters.php contiene los datos de conexión a la conexión MySQL PrestaShop Plesk. Un error típico es que después de una migración o cambio de contraseña, los datos no se actualicen.

Conéctate a tu hosting vía FTP o Administrador de archivos de Plesk (dentro de Plesk, ve a Archivos).
Navega a la carpeta raíz de tu tienda (normalmente httpdocs o public_html).
Abre la carpeta app/config/ y busca el archivo parameters.php.
Ábrelo con un editor de texto (Block de notas, Sublime Text, etc.). Verás algo como:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'contraseña_segura',

Verifica que los datos coincidan exactamente con los que tienes en Plesk:
- database_host: Normalmente es localhost. Si tu base de datos está en otro servidor, pon la IP.
- database_port: Casi siempre 3306.
- database_name: El nombre exacto que ves en Plesk > Bases de Datos.
- database_user: El usuario asignado a esa base de datos.
- database_password: La contraseña de ese usuario.

[WARNING] Nunca uses comillas dobles ni caracteres especiales no escapados en la contraseña. Si tu contraseña tiene símbolos como $ o \, puede dar error. Si es posible, cámbiala por una segura pero simple (solo letras y números) desde Plesk.

Si algún dato es incorrecto, corrígelo y guarda el archivo. Luego, prueba a cargar tu tienda.

Paso 3: Verifica los permisos del usuario de la base de datos en Plesk

A veces el usuario tiene acceso a la base de datos pero no todos los privilegios necesarios. PrestaShop necesita permisos completos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).

En Plesk, ve a Bases de Datos.
Haz clic en el nombre de la base de datos de tu tienda.
En la sección Usuarios, verás los usuarios asociados.
Haz clic en el icono de editar (lápiz) junto al usuario que usa PrestaShop.
Asegúrate de que tenga marcados todos los privilegios (o al menos: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, TRIGGER).
Guarda los cambios.

[TIP] Si no estás seguro, puedes eliminar el usuario y volver a añadirlo marcando “Conceder todos los privilegios”. Luego actualiza la contraseña en parameters.php.

Paso 4: Comprueba el firewall y la conexión remota (si aplica)

Si tu base de datos no está en localhost (por ejemplo, en un servidor externo), el firewall de Plesk o del servidor puede bloquear el puerto 3306.

En Plesk, ve a Herramientas y Configuración > Firewall (si está disponible).
Busca una regla que permita el tráfico entrante en el puerto 3306 (MySQL). Si no existe, créala.
Si tu base de datos es remota, asegúrate de que el servidor MySQL permita conexiones desde la IP de tu hosting. Esto se configura en el archivo my.cnf (normalmente no accesible para usuarios compartidos).

[INFO] En la mayoría de los hostings compartidos con Plesk, la base de datos está en el mismo servidor, así que este paso no suele ser necesario. Si tienes un VPS o dedicado, revisa la configuración de red.

Paso 5: Restablece la contraseña del usuario de la base de datos

A veces la contraseña se corrompe o se cambió sin que lo sepas. Lo más seguro es generar una nueva.

En Plesk, ve a Bases de Datos > selecciona tu base de datos.
En la sección Usuarios, haz clic en Cambiar contraseña.
Escribe una nueva contraseña (por ejemplo: M1Ti3nd4Segur@2024). Anótala.
Ahora, actualiza el archivo parameters.php con la nueva contraseña.

[WARNING] Después de cambiar la contraseña, PrestaShop dejará de funcionar hasta que actualices el archivo. Hazlo inmediatamente.

Paso 6: Verifica el espacio en disco y los logs de errores

Un disco lleno puede impedir que MySQL escriba datos, causando errores de conexión.

En Plesk, ve a Herramientas y Configuración > Uso de Disco.
Si el disco está al 100%, libera espacio (elimina copias de seguridad antiguas, logs, cachés, etc.).
También puedes revisar los logs de MySQL para más pistas:
- Ve a Herramientas y Configuración > Logs > Log de MySQL.
- Busca errores recientes como "Can't connect to MySQL server", "Too many connections" o "Disk full".

Paso 7: Soluciones avanzadas para "PrestaShop no conecta BD Plesk"

Si nada de lo anterior funciona, prueba estas opciones más técnicas:

7.1. Repara la base de datos desde Plesk

Ve a Bases de Datos > selecciona tu base de datos.
Haz clic en Reparar Base de Datos (o Check & Repair).
Esto ejecutará mysqlcheck -r que repara tablas dañadas.

7.2. Cambia el host de la base de datos de "localhost" a "127.0.0.1"

A veces el DNS local falla. En parameters.php, cambia:

'database_host' => '127.0.0.1',

Guarda y prueba.

7.3. Desactiva temporalmente el modo estricto de MySQL

Si tu versión de MySQL es muy nueva y PrestaShop es antiguo, puede haber incompatibilidad. Desde Plesk no siempre se puede, pero puedes pedir a tu hosting que desactiven STRICT_TRANS_TABLES en el archivo my.cnf.

7.4. Restablece el archivo parameters.php desde la instalación

Si todo falla, puedes generar un nuevo parameters.php usando la herramienta de instalación de PrestaShop (pero perderás la configuración actual). Haz una copia de seguridad antes.

Renombra el archivo parameters.php a parameters_old.php.
Sube el archivo install/index.php de PrestaShop (si no lo tienes, descarga la misma versión de PrestaShop).
Ejecuta tudominio.com/install/index.php y sigue el asistente. Cuando pida la base de datos, introduce los datos correctos.
Al finalizar, el instalador generará un nuevo parameters.php. Luego borra la carpeta install.

Preguntas frecuentes (FAQ) sobre error base de datos PrestaShop Plesk

¿Por qué aparece "Error de conexión a la base de datos" después de una migración?

Es muy común. Las causas principales son: el nombre de la base de datos no coincide, la contraseña no se actualizó en parameters.php, o el usuario no tiene permisos. Revisa los pasos 2 y 3.

¿Cómo sé si mi base de datos está en localhost o en un servidor remoto?

En Plesk, ve a Bases de Datos y mira la columna Servidor. Si dice "localhost" o está vacío, es local. Si aparece una IP, es remota.

¿Puedo usar herramientas como phpMyAdmin para verificar la conexión?

Sí, desde Plesk puedes acceder a phpMyAdmin (dentro de la base de datos). Si phpMyAdmin funciona, el problema está en la configuración de PrestaShop, no en MySQL.

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

Contacta con tu soporte de hosting. Diles que has revisado credenciales, permisos y espacio en disco. Pídeles que revisen los logs de MySQL y el estado del servicio. Si usas un VPS, puedes reiniciar MySQL desde SSH con systemctl restart mariadb o systemctl restart mysql.

Consejos finales para evitar futuros problemas

Haz copias de seguridad periódicas de tu base de datos y archivos.
Actualiza PrestaShop y sus módulos a la última versión compatible con tu PHP.
No compartas contraseñas de bases de datos y cámbialas cada cierto tiempo.
Monitorea el espacio en disco de tu servidor Plesk.
Si usas Syspanel (HestiaCP), recuerda que el acceso es por el puerto 2106 y la gestión de bases de datos es similar, pero los pasos pueden variar ligeramente.

Espero que esta guía te haya ayudado a solucionar el error base de datos PrestaShop Plesk. Recuerda que la paciencia y el método son clave. Si sigues estos pasos en orden, lo más probable es que tu tienda vuelva a la vida en pocos minutos. ¡Buena suerte!