Error de conexión de base de datos en PrestaShop: cómo solucionarlo

¿Tu tienda PrestaShop ha dejado de funcionar de repente mostrando un mensaje de error de conexión a la base de datos? No te preocupes, es uno de los problemas más comunes y, en la mayoría de los casos, tiene una solución sencilla. En esta guía extensa y paso a paso, te explicaré las causas más frecuentes y cómo resolver el error de conexión de base de datos en PrestaShop, tanto si usas Plesk, cPanel o cualquier otro panel de control.

¿Qué significa este error?

Cuando PrestaShop no puede conectar con su base de datos, tu tienda se vuelve inaccesible. Verás mensajes como "Error de conexión a la base de datos" o "Cannot connect to database". Esto ocurre porque los datos de acceso (servidor, usuario, contraseña y nombre de base de datos) no son correctos o porque el servidor de bases de datos no está funcionando.

Causas más comunes del error de conexión en PrestaShop

Antes de ponernos a modificar archivos, identifiquemos el origen del problema. Las causas más habituales son:

Cambio de contraseña de la base de datos sin actualizar la configuración de PrestaShop.
Movimiento del sitio a otro servidor (migración) sin ajustar los datos de conexión.
Servidor de bases de datos caído o sobrecargado.
Archivo de configuración dañado o con permisos incorrectos.
Problemas con el usuario de la base de datos (privilegios revocados o eliminado).
Firewall o IP bloqueada que impide la conexión remota.

Solución paso a paso para el error de conexión

Vamos a resolverlo. Sigue estos pasos en orden, del más simple al más complejo.

1. Verifica que el servidor de bases de datos esté funcionando

Lo primero es asegurarte de que el problema no es del servidor. Si tu hosting usa Plesk, cPanel o Syspanel (anteriormente HestiaCP), accede al panel y busca el estado de los servicios.

En Plesk: Ve a "Herramientas y ajustes" > "Administrador de servicios". Busca "MySQL" o "MariaDB" y comprueba que está en ejecución.
En cPanel: Ve a "Estado del servidor" y revisa que "MySQL" aparezca como activo.
En Syspanel (HestiaCP): Accede por el puerto 2106 (ejemplo: https://tudominio.com:2106). Ve a "Servicios" y verifica que "mysql" esté verde.

[TIP] Si el servicio está detenido, reinícialo desde el panel. En Plesk, haz clic en el círculo rojo para iniciarlo. En cPanel, usa el botón "Restart". En Syspanel, marca la casilla y haz clic en "Restart".

2. Revisa el archivo de configuración de PrestaShop

El archivo app/config/parameters.php contiene los datos de conexión. Si se ha modificado accidentalmente o está corrupto, tendrás que editarlo.

¿Cómo acceder al archivo?

Usa el administrador de archivos de tu panel de control (Plesk, cPanel, Syspanel) o un cliente FTP como FileZilla.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o httpdocs).
Abre la carpeta app/config/ y busca el archivo parameters.php.

¿Qué buscar?

Dentro del archivo verás algo parecido a esto:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'nombre_base',
'database_user' => 'usuario_base',
'database_password' => 'contraseña_base',

Comprueba que estos valores sean correctos. Si has cambiado la contraseña de la base de datos recientemente, aquí debes actualizarla.

[WARNING] Nunca compartas este archivo públicamente. Contiene las credenciales de tu base de datos.

3. Verifica las credenciales desde el panel de control

Si no estás seguro de que los datos sean correctos, accede a tu panel de hosting y compruébalos directamente.

En Plesk: Ve a "Bases de datos", selecciona tu base de datos y haz clic en "Usuarios". Ahí verás el usuario y podrás cambiar la contraseña.
En cPanel: Ve a "Bases de datos MySQL". Busca tu base de datos y su usuario asignado. Si no recuerdas la contraseña, puedes cambiarla desde "Modificar usuario".
En Syspanel (HestiaCP): Ve a "Base de datos" y selecciona tu base de datos. Haz clic en "Editar" para ver usuario y contraseña.

[INFO] Si cambias la contraseña, recuerda actualizarla también en el archivo parameters.php.

4. Comprueba los privilegios del usuario de la base de datos

A veces el usuario existe, pero no tiene permisos para conectarse desde el servidor donde está PrestaShop. Esto es común después de migraciones.

En Plesk: Edita el usuario de la base de datos y asegúrate de que tenga marcado "TODOS LOS PRIVILEGIOS" o al menos los básicos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP).
En cPanel: Ve a "Bases de datos MySQL", busca "Usuarios" y haz clic en "Administrar privilegios". Marca "TODOS LOS PRIVILEGIOS".
En Syspanel: Al crear o editar un usuario, asegúrate de que el campo "Host" sea localhost o % (cualquier host). Si usas localhost, el usuario solo se conectará desde el mismo servidor.

[WARNING] Si pones % como host, el usuario podrá conectarse desde cualquier IP, lo cual es menos seguro. Úsalo solo temporalmente para pruebas.

5. Prueba la conexión manualmente

Para descartar que el problema sea de PrestaShop, prueba a conectar a la base de datos con un cliente MySQL desde el mismo servidor.

Desde Plesk: Ve a "Bases de datos", selecciona tu base y haz clic en "phpMyAdmin". Si accedes sin problemas, la conexión funciona.
Desde cPanel: Ve a "phpMyAdmin" y selecciona tu base de datos.
Desde Syspanel: Ve a "Base de datos" y haz clic en "phpMyAdmin".

Si phpMyAdmin te pide usuario y contraseña y no accede, entonces el problema está en las credenciales. Si accede pero PrestaShop no, el problema está en el archivo parameters.php.

6. Revisa el firewall y la IP de conexión

Algunos servidores bloquean conexiones remotas a la base de datos. Si tu PrestaShop está en un servidor diferente al de la base de datos (lo cual es raro, pero posible), asegúrate de que el puerto 3306 esté abierto.

En Plesk: Ve a "Herramientas y ajustes" > "Firewall" y permite el puerto 3306 para la IP de tu servidor web.
En cPanel: La configuración de firewall suele estar en "Configuración de seguridad" > "Firewall de CSF". Añade una regla para permitir el puerto 3306.
En Syspanel: Ve a "Configuración" > "Firewall" y añade una regla para el puerto 3306.

[TIP] Si tu base de datos está en un servidor externo (como Amazon RDS), asegúrate de que la IP de tu servidor web esté en la lista blanca.

7. Reconstruye el archivo parameters.php

Si todo lo anterior falla, puedes generar un nuevo archivo parameters.php con los datos correctos. Sigue estos pasos:

Haz una copia de seguridad del archivo actual (por si acaso).
Crea un nuevo archivo con el siguiente contenido, reemplazando los valores con los tuyos:

<?php
return array(
    'database_host' => 'localhost',
    'database_port' => '3306',
    'database_name' => 'tu_base_de_datos',
    'database_user' => 'tu_usuario',
    'database_password' => 'tu_contraseña',
    'database_prefix' => 'ps_',
    // ... otros parámetros que no toques
);

Sube el archivo a app/config/parameters.php mediante FTP o el administrador de archivos.
Guarda los cambios y recarga tu tienda.

[WARNING] No modifiques otros parámetros del archivo si no sabes lo que haces. Solo cambia los de la base de datos.

8. Contacta con tu proveedor de hosting

Si después de todos estos pasos el error persiste, el problema puede ser del servidor. Contacta con el soporte técnico de tu hosting y diles que PrestaShop muestra "Error de conexión a la base de datos". Ellos podrán verificar los logs del servidor y solucionar problemas como:

Servicio MySQL caído.
Límite de conexiones alcanzado.
Problemas de disco o memoria.

Preguntas frecuentes (FAQ)

¿Por qué aparece este error después de cambiar la contraseña de la base de datos?

Porque PrestaShop guarda la contraseña en el archivo parameters.php. Si cambias la contraseña desde el panel de control, debes actualizarla también en ese archivo.

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

Puede que tu PrestaShop sea muy antiguo o que uses una versión personalizada. Busca en la raíz el archivo config/settings.inc.php. En versiones modernas, ese archivo ya no se usa, pero en algunas migraciones puede persistir.

¿Puedo usar una base de datos remota con PrestaShop?

Sí, pero es menos común y más lento. En ese caso, en database_host debes poner la IP del servidor remoto y asegurarte de que el puerto 3306 esté abierto y el usuario tenga permisos desde la IP de tu servidor web.

¿Cómo sé si mi hosting usa Plesk, cPanel o Syspanel?

Revisa el enlace de acceso a tu panel de control. Si es algo como https://tudominio.com:8443, es Plesk. Si es https://tudominio.com:2083, es cPanel. Si es https://tudominio.com:2106, es Syspanel (HestiaCP).

¿El error puede deberse a un plugin o tema?

Sí, aunque es raro. Algunos módulos mal programados pueden saturar la conexión. Si el error aparece solo en algunas páginas, desactiva módulos recién instalados desde el administrador de archivos renombrando la carpeta modules/nombre_del_modulo.

Conclusión

El error de conexión de base de datos en PrestaShop es frustrante, pero casi siempre tiene solución. Siguiendo esta guía paso a paso, podrás identificar si el problema está en las credenciales, en el servidor o en la configuración del archivo parameters.php. Recuerda siempre hacer copias de seguridad antes de modificar archivos críticos.

Si después de todo el error persiste, no dudes en contactar a tu proveedor de hosting. Ellos tienen acceso a herramientas de diagnóstico que pueden detectar problemas más profundos. ¡Buena suerte y que tu tienda vuelva a funcionar pronto!