Solucionar error de conexión a base de datos en PrestaShop con Plesk

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque seguramente has visto un mensaje de error como “Error de conexión a la base de datos” o “Unable to connect to the database” al intentar abrir tu tienda PrestaShop alojada en un servidor Plesk. No te preocupes, es uno de los problemas más comunes y, por suerte, suele tener solución.

En este artículo, te guiaré paso a paso para que puedas solucionar el error de conexión a la base de datos en PrestaShop cuando está instalado en Plesk. Vamos a convertir ese dolor de cabeza en una lección rápida de SysAdmin básico. Recuerda, siempre con un tono didáctico y sin complicaciones.

¿Por qué aparece el error “PrestaShop error base de datos”?

Cuando ves el mensaje PrestaShop error base de datos, significa que tu tienda no puede comunicarse con el servidor de bases de datos MySQL/MariaDB. Las causas más habituales son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos en el archivo de configuración no coinciden con los reales.
Servidor de base de datos caído: El servicio MySQL no está funcionando en el servidor Plesk.
Permisos de usuario revocados: El usuario de la base de datos perdió los permisos para acceder a ella.
Archivo de configuración corrupto: El archivo app/config/parameters.php de PrestaShop está dañado o tiene información incorrecta.
Problemas de conexión remota (poco común en Plesk): Si la base de datos está en otro servidor, puede haber un bloqueo de firewall.

Vamos a solucionarlo paso a paso.

Requisitos previos: Acceso al panel Plesk y SSH

Antes de empezar, necesitas tener dos cosas a mano:

Acceso al panel de control Plesk (normalmente https://tudominio.com:8443).
Acceso SSH a tu servidor (necesitarás las credenciales de root o de un usuario con permisos sudo). Si no sabes qué es SSH, no te preocupes, te guiaré.

[WARNING] Si no tienes acceso SSH, la mayoría de las soluciones se pueden hacer desde el panel de Plesk. Solo necesitarás SSH para reiniciar servicios o editar archivos directamente.

Paso 1: Verificar el estado del servicio MySQL/MariaDB en Plesk

Lo primero es asegurarnos de que el motor de base de datos esté funcionando. Desde Plesk:

### Desde el panel de Plesk (más fácil)

Inicia sesión en Plesk.
Ve a Herramientas y configuraciones (en el menú de la izquierda).
Busca la sección Servicios y haz clic en Administrador de servicios.
Localiza el servicio MySQL o MariaDB. Debe aparecer como “En ejecución”.
Si está detenido, haz clic en el botón de inicio (el triángulo verde).

### Desde SSH (si prefieres línea de comandos)

Conéctate por SSH y ejecuta:

systemctl status mariadb
# o
systemctl status mysql

Si ves “active (running)” perfecto. Si no, reinícialo:

systemctl restart mariadb
# o
systemctl restart mysql

[TIP] Si el servicio no arranca, puede haber un error en los logs. Revisa /var/log/mysql/error.log o ejecuta journalctl -xe para más detalles.

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

El archivo clave es app/config/parameters.php. Aquí es donde PrestaShop guarda los datos de conexión.

### Localiza el archivo

Desde el panel de Plesk:

Ve a Sitios web y dominios.
Haz clic en Administrador de archivos (icono de carpeta).
Navega hasta la carpeta de tu tienda, normalmente httpdocs o prestashop.
Entra en app/config/ y busca parameters.php.

### Edita el archivo

Haz clic derecho sobre parameters.php y selecciona Editar en el editor de texto. Busca estas líneas:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_la_bd',
'database_password' => 'contraseña_de_la_bd',

Ahora, ve al panel de Plesk y verifica los datos reales:

Ve a Sitios web y dominios > Bases de datos.
Allí verás el nombre de la base de datos y el usuario asociado.
Si no recuerdas la contraseña, puedes cambiarla desde Usuarios de bases de datos en la misma sección.

Compara y corrige en parameters.php:

database_host: casi siempre es localhost.
database_name: debe coincidir exactamente (sensible a mayúsculas).
database_user: igual.
database_password: la que hayas configurado.

[WARNING] A veces el nombre de la base de datos en Plesk incluye el prefijo del usuario (ej: miusuario_mibd). Asegúrate de copiarlo completo.

Guarda los cambios y vuelve a cargar tu tienda.

Paso 3: Verificar y reparar permisos del usuario de la base de datos

A veces, el usuario tiene la contraseña correcta pero perdió los permisos sobre la base de datos. Desde Plesk:

Ve a Sitios web y dominios > Bases de datos.
Haz clic en el nombre de tu base de datos.
En la pestaña Usuarios, verás el usuario asociado.
Marca la casilla “Conceder todos los privilegios” (si no está marcada).
También puedes hacer clic en “Administrar” y luego “Agregar usuario” para asegurarte de que el usuario correcto está vinculado.

Si tienes acceso SSH, puedes hacerlo con comandos:

GRANT ALL PRIVILEGES ON nombre_de_la_bd.* TO 'usuario'@'localhost';
FLUSH PRIVILEGES;

[INFO] Si el usuario no existe, puedes crearlo desde Plesk o con CREATE USER 'nuevo_usuario'@'localhost' IDENTIFIED BY 'contraseña'; y luego asignarle permisos.

Paso 4: Comprobar la configuración de conexión remota (si aplica)

En la mayoría de los casos en Plesk, la base de datos está en el mismo servidor (localhost). Pero si tu configuración usa una IP remota (por ejemplo, un servidor de bases de datos separado), asegúrate de que:

El firewall del servidor de bases de datos permita conexiones desde la IP de tu servidor web (puerto 3306).
El usuario tenga permisos para conectarse desde '%' o desde la IP específica.

Para verificar desde SSH:

mysql -u usuario -p -h localhost

Si funciona con localhost pero no con la IP remota, el problema está en la conectividad de red o en los permisos del usuario.

Paso 5: Revisar el archivo .htaccess y la configuración de PHP

A veces, un .htaccess mal configurado puede interferir con las conexiones a la base de datos. No es lo más común, pero vale la pena revisarlo.

Desde el Administrador de archivos de Plesk, busca el archivo .htaccess en la raíz de tu tienda.
Si no estás seguro, renómbralo a .htaccess_backup temporalmente.
Prueba tu tienda. Si funciona, el problema estaba ahí. Luego puedes restaurar un .htaccess limpio generado desde el panel de administración de PrestaShop (si accedes).

También verifica que la versión de PHP sea compatible con tu versión de PrestaShop. En Plesk:

Ve a Sitios web y dominios > Configuración de PHP.
Asegúrate de que la versión de PHP sea la recomendada (por ejemplo, 7.4 u 8.0 para PrestaShop 1.7 o 8.x).

Paso 6: Reconstruir el archivo parameters.php (solución avanzada)

Si después de todo lo anterior el PrestaShop error base de datos persiste, podemos regenerar el archivo de configuración desde cero.

### Desde SSH

Conéctate por SSH.
Navega a la carpeta de tu tienda: cd /var/www/vhosts/tudominio.com/httpdocs/ (ajusta la ruta según tu caso).
Renombra el archivo actual por si acaso: mv app/config/parameters.php app/config/parameters.php.bak
Crea un nuevo archivo vacío: touch app/config/parameters.php
Dale permisos de escritura al servidor web: chown -R www-data:www-data app/config/parameters.php (o psacln si usas Plesk, verifica el usuario del grupo).
Ahora, desde el panel de administración de PrestaShop (si puedes acceder), ve a Parámetros de la tienda > Configuración general > Base de datos y vuelve a introducir los datos. O bien, edita manualmente el archivo con los datos correctos.

Si no puedes acceder al panel de administración, puedes usar la herramienta de instalación de PrestaShop para reparar la conexión:

Descarga una copia limpia de PrestaShop de la misma versión.
Sube la carpeta install a la raíz de tu tienda (cuidado con sobrescribir).
Accede a tudominio.com/install y elige la opción “Reparar” o “Actualizar”. Esto reconstruirá el archivo de configuración.

[WARNING] Esta opción puede ser destructiva si no se hace con cuidado. Siempre haz una copia de seguridad de tu base de datos y archivos antes.

Paso 7: Verificar logs del servidor

Si nada funciona, los logs son tus mejores amigos.

### Logs de MySQL

Desde SSH:

tail -100 /var/log/mysql/error.log

Busca errores como Access denied for user, Can't connect to MySQL server o Table 'xxxx' doesn't exist.

### Logs de error de PHP

En Plesk, puedes ver los logs de error de tu sitio desde Sitios web y dominios > Registros. Busca errores relacionados con PDO o mysqli.

Preguntas frecuentes (FAQ) sobre PrestaShop y Plesk

1. ¿Por qué después de cambiar la contraseña en Plesk mi tienda sigue dando error?
Porque el archivo parameters.php guarda la contraseña anterior. Debes actualizarlo manualmente. Sigue el Paso 2.

2. ¿Puedo usar una base de datos remota con Plesk y PrestaShop?
Sí, pero necesitas configurar el database_host con la IP del servidor remoto y asegurar que el firewall permita la conexión. Además, el usuario de la base de datos debe tener permisos desde '%' o desde la IP de tu servidor web.

3. ¿Qué hago si el error aparece después de migrar mi tienda a otro servidor?
Lo más probable es que las credenciales hayan cambiado. Revisa el archivo parameters.php y actualiza los datos. También verifica que la base de datos se haya importado correctamente.

4. Mi tienda usa “Syspanel” (HestiaCP) y ahora la migro a Plesk, ¿cómo afecta esto?
Si migras desde Syspanel (recuerda que el puerto de acceso es el 2106), el proceso es similar. La principal diferencia es que en Syspanel la gestión de bases de datos se hace desde su propio panel. Al migrar a Plesk, asegúrate de exportar la base de datos desde Syspanel e importarla en Plesk. Luego ajusta el parameters.php con los nuevos datos de conexión (usuario, contraseña, host). El resto de pasos son idénticos.

5. ¿Es seguro editar el archivo parameters.php manualmente?
Sí, siempre que respetes la sintaxis PHP. Haz una copia de seguridad antes de editarlo.

Conclusión: Has solucionado el error de conexión

Como ves, el PrestaShop error base de datos en Plesk PrestaShop suele deberse a problemas de credenciales, permisos o servicios caídos. Siguiendo estos pasos, desde lo más simple (revisar el servicio) hasta lo más avanzado (regenerar el archivo de configuración), podrás solucionar error conexión y tener tu tienda funcionando de nuevo.

Recuerda que como SysAdmin PrestaShop, la paciencia y la metodología son clave. Siempre empieza por lo básico y ve avanzando. Y si te quedas atascado, los logs y el panel de Plesk son tus mejores aliados.

[TIP] Para evitar futuros sustos, programa copias de seguridad periódicas de tu base de datos y archivos. En Plesk puedes hacerlo desde Herramientas y configuraciones > Administrador de copias de seguridad.

Espero que este artículo te haya sido de gran ayuda. Si tienes más dudas, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting. ¡Buena suerte con tu tienda!