Error de base de datos en PrestaShop con Plesk: cómo solucionarlo

¡Hola! Soy tu técnico de soporte amigable. ¿Estás viendo un mensaje de error en tu tienda PrestaShop que dice algo como “Error de conexión a la base de datos” o “No se puede conectar con el servidor MySQL”? No te preocupes, es uno de los problemas más comunes cuando gestionas tu tienda online en un servidor con Plesk. En esta guía completa y muy fácil de seguir, te voy a explicar paso a paso cómo solucionar el error base datos PrestaShop Plesk y volver a tener tu tienda funcionando en minutos. Vamos a ello.

¿Por qué aparece este error?

Cuando tu tienda PrestaShop no puede conectar con la base de datos MySQL, el mensaje típico que ves es: “Error de conexión a la base de datos” o “PrestaShop no conecta MySQL Plesk”. Esto puede deberse a varias causas, pero las más frecuentes son:

Credenciales incorrectas en el archivo de configuración (settings.inc.php).
El servidor MySQL está caído o no responde.
La base de datos ha sido eliminada o no existe.
El usuario de la base de datos no tiene permisos o la contraseña ha cambiado.
Problemas de firewall o conexión remota al servidor de bases de datos.
El archivo settings.inc.php está dañado o mal formateado.

No te asustes, la mayoría de estos problemas se solucionan en pocos minutos. Lo importante es seguir el orden correcto para identificar la causa.

Paso 1: Verificar que el servidor MySQL está funcionando

Antes de tocar nada en PrestaShop, asegurémonos de que el motor de bases de datos está activo en tu servidor Plesk.

Cómo comprobarlo en Plesk

Accede a tu panel de control Plesk (normalmente en https://tudominio.com:8443 o la URL que te haya proporcionado tu proveedor).
Ve a Herramientas y configuraciones (en el menú de la izquierda).
Busca la sección Servicios y haz clic en Gestión de servicios.
Localiza MySQL o MariaDB en la lista. Asegúrate de que esté marcado como “En ejecución” (normalmente con un icono verde).

[TIP]: Si ves que está detenido, simplemente haz clic en el botón “Iniciar”. Si no se inicia, puede haber un problema más profundo del servidor; en ese caso, contacta con tu proveedor de hosting.

Paso 2: Localizar y revisar el archivo settings.inc.php

Este es el archivo más importante para la conexión. PrestaShop guarda aquí los datos de acceso a la base de datos. Si algo está mal aquí, tu tienda no conectará.

¿Dónde está este archivo?

Está en la raíz de tu instalación de PrestaShop, dentro de la carpeta app/config/. La ruta completa suele ser:

/var/www/vhosts/tudominio.com/httpdocs/app/config/settings.inc.php

O si usas una estructura de carpetas diferente dentro de Plesk, puede estar en:

/httpdocs/app/config/settings.inc.php

Cómo editarlo desde Plesk (método recomendado)

En Plesk, ve a Sitios web y dominios.
Haz clic en Administrador de archivos (icono de carpeta) para tu dominio.
Navega hasta app/config/.
Busca el archivo settings.inc.php y haz clic derecho sobre él → Editar en el editor de texto.

¿Qué debes revisar exactamente?

Dentro del archivo, busca una sección que empieza con define('_DB_SERVER_', y verifica estos valores:

_DB_SERVER_: Debe ser algo como localhost o 127.0.0.1. En la mayoría de los servidores Plesk compartidos, es localhost. Si tu base de datos está en otro servidor, aquí iría la IP o el nombre del host.
_DB_NAME_: Es el nombre exacto de tu base de datos (ejemplo: miusuario_mitienda).
_DB_USER_: El nombre del usuario que tiene acceso a esa base de datos (ejemplo: miusuario_admin).
_DB_PASSWD_: La contraseña de ese usuario. Ojo: a veces Plesk cambia la contraseña automáticamente si has restaurado una copia de seguridad o has modificado el usuario desde el panel.

[WARNING]: Si cambias estos valores, asegúrate de no dejar espacios extra ni comillas mal cerradas. Un error de sintaxis puede romper toda la tienda. Si no estás seguro, copia el contenido antes de modificarlo.

Paso 3: Verificar la base de datos y el usuario en Plesk

A veces el problema es que la base de datos o el usuario han sido eliminados accidentalmente, o los permisos no son correctos.

Cómo comprobarlo

En Plesk, ve a Sitios web y dominios → haz clic en Bases de datos (icono de base de datos).
Verás una lista de bases de datos. Busca la que corresponde a tu tienda (debe coincidir con el nombre en settings.inc.php).
Si la base de datos no aparece, tendrás que crearla de nuevo (con el mismo nombre) y luego importar una copia de seguridad.
Haz clic en el nombre de la base de datos. Verás los usuarios asociados.
Asegúrate de que el usuario que aparece en settings.inc.php está en la lista y tiene todos los permisos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Normalmente, si está añadido, los permisos vienen por defecto.

Si el usuario no existe o la contraseña no funciona

En la misma pantalla, haz clic en Añadir nuevo usuario.
Crea un usuario con el mismo nombre que usas en settings.inc.php y ponle una contraseña segura.
Importante: Después de crearlo, actualiza la contraseña en el archivo settings.inc.php con la nueva contraseña.
Asigna ese usuario a la base de datos correspondiente.

[INFO]: Si cambias la contraseña desde Plesk, el sistema la actualiza automáticamente, pero tú debes reflejar ese cambio en el archivo de PrestaShop.

Paso 4: Probar la conexión manualmente (desde phpMyAdmin)

Una forma muy visual de saber si el error es de configuración o del servidor es intentar conectar manualmente.

En Plesk, dentro de la base de datos, haz clic en phpMyAdmin (icono de la base de datos con un rayo).
Se abrirá phpMyAdmin. Si ves la interfaz, significa que el servidor MySQL funciona y puedes acceder con las credenciales de administrador de Plesk.
Ahora, en phpMyAdmin, prueba a iniciar sesión con el usuario y contraseña que tienes en settings.inc.php. Para ello, cierra la sesión actual (si la hay) y en la pantalla de login, introduce esos datos.
Si puedes entrar, el problema está en otra parte (quizás en el archivo de PrestaShop o en algún plugin). Si no puedes entrar, la contraseña o el usuario son incorrectos, o el usuario no tiene acceso a esa base de datos.

Paso 5: Revisar el archivo .htaccess y los permisos de carpetas

A veces un error de conexión puede ser un falso positivo causado por un .htaccess corrupto o por permisos incorrectos que impiden que PrestaShop lea el archivo de configuración.

Pasos a seguir

En el Administrador de archivos de Plesk, ve a la raíz de tu tienda (httpdocs).
Busca el archivo .htaccess (puede estar oculto; en Plesk, activa “Mostrar archivos ocultos” en la esquina superior derecha).
Renómbralo temporalmente a .htaccess_old (esto desactivará las reglas de reescritura).
Prueba a acceder a tu tienda. Si funciona, el problema está en ese archivo. Puedes regenerarlo desde el panel de administración de PrestaShop (si logras entrar) o restaurar uno de seguridad.
También verifica que la carpeta app/config/ tenga permisos 755 y el archivo settings.inc.php tenga permisos 644 (o 640). Si no, cámbialos desde el Administrador de archivos → Propiedades del archivo.

Paso 6: Solucionar problemas de firewall o conexión remota

Si tu base de datos no está en localhost sino en un servidor externo (por ejemplo, un servicio de bases de datos administrado), puede que el firewall de Plesk esté bloqueando la conexión.

Cómo verificarlo

En Plesk, ve a Herramientas y configuraciones → Firewall (si está disponible en tu plan).
Asegúrate de que el puerto 3306 (MySQL) está abierto para la IP de tu servidor web.
Si no tienes acceso al firewall, contacta con tu proveedor de hosting.

[WARNING]: No abras el puerto 3306 a todo el mundo (0.0.0.0/0) por seguridad. Solo a las IPs necesarias.

Paso 7: Restaurar una copia de seguridad (si todo falla)

Si después de todos estos pasos sigues viendo el error, puede que la base de datos esté corrupta o que hayas modificado algo sin querer. La solución más rápida es restaurar una copia de seguridad reciente.

Cómo restaurar desde Plesk

Ve a Sitios web y dominios → Bases de datos.
Haz clic en el nombre de tu base de datos.
Busca la opción “Restaurar copia de seguridad” (o “Importar dump”).
Sube un archivo .sql de una copia de seguridad que sepas que funciona.
Después de restaurar, vuelve a verificar el archivo settings.inc.php porque la copia de seguridad puede tener credenciales antiguas.

[TIP]: Siempre ten una copia de seguridad de tu base de datos y de los archivos de tu tienda. Es tu salvavidas.

Preguntas Frecuentes (FAQ)

¿Qué hago si no encuentro el archivo settings.inc.php?

Puede que tu PrestaShop esté usando una versión más reciente (1.7 o superior) donde la configuración está en la base de datos o en variables de entorno. En ese caso, revisa el archivo app/config/parameters.php (para versiones 1.7+) o config/settings.inc.php (para versiones 1.6). Si no existe, tu instalación puede estar dañada; reinstala PrestaShop pero conservando los archivos de temas y módulos.

¿Puedo cambiar la contraseña de la base de datos desde Plesk sin romper la tienda?

Sí, pero debes actualizar la contraseña en el archivo settings.inc.php inmediatamente después. Si no lo haces, la tienda dejará de funcionar.

¿Por qué aparece el error después de migrar mi tienda a otro servidor?

Es muy común. Al migrar, las credenciales suelen cambiar. Revisa el archivo settings.inc.php y asegúrate de que los datos (servidor, nombre de BD, usuario y contraseña) son los del nuevo servidor. También verifica que el servidor MySQL permita conexiones remotas si la base de datos está en otro lugar.

Mi tienda usa Syspanel (HestiaCP) y no Plesk, ¿me sirve esta guía?

Si tu panel es Syspanel (accesible por el puerto 2106), el proceso es similar, pero la interfaz cambia. En Syspanel, busca la sección “Bases de datos” y luego “phpMyAdmin” para gestionar las credenciales. El archivo settings.inc.php sigue siendo el mismo. Los pasos de verificación de servicios y firewall son equivalentes.

¿Un plugin puede causar este error?

Sí, algunos módulos de PrestaShop (como los de caché o seguridad) pueden modificar la configuración de conexión. Si el error apareció después de instalar un módulo, desactívalo temporalmente renombrando su carpeta en /modules/ (por ejemplo, de micodigo a micodigo_off). Si la tienda vuelve a funcionar, ese módulo es el culpable.

Resumen final

Para solucionar base datos tienda online con PrestaShop en Plesk, sigue esta checklist:

✅ Verifica que MySQL esté activo en los servicios de Plesk.
✅ Revisa el archivo settings.inc.php y asegúrate de que las credenciales sean correctas.
✅ Comprueba la base de datos y el usuario en Plesk (que existan y tengan permisos).
✅ Prueba la conexión manualmente con phpMyAdmin.
✅ Revisa el .htaccess y los permisos de archivos y carpetas.
✅ Si nada funciona, restaura una copia de seguridad.

Recuerda que la paciencia es clave. Si después de todo sigues atascado, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo al servidor y pueden ayudarte a identificar problemas más profundos.

¡Espero que esta guía te haya sido de gran ayuda! Ahora ya sabes cómo enfrentarte al error base datos PrestaShop Plesk y dejar tu tienda online funcionando de nuevo. ¡Mucho éxito con tu negocio!