Error de conexión a base de datos en PrestaShop: Solución | SysAdmin

¡Hola! Si estás leyendo esto, probablemente te has encontrado con el temido mensaje "Cannot connect to database" en tu tienda PrestaShop. No te preocupes, es un error común y, por lo general, tiene solución. En esta guía extensa, te explicaré paso a paso cómo diagnosticar y resolver este problema, usando herramientas como cPanel o Syspanel (antes conocido como HestiaCP). Vamos a ello.

[INFO] Este error suele aparecer cuando PrestaShop no puede comunicarse con la base de datos MySQL. Las causas pueden ser varias: desde un cambio de contraseña hasta un problema de permisos o configuración.

¿Qué significa "Cannot connect to database"?

Cuando ves este mensaje en tu tienda PrestaShop, significa que el archivo de configuración app/config/parameters.php (o config/settings.inc.php en versiones muy antiguas) contiene datos incorrectos o que el servidor de base de datos no está respondiendo. Básicamente, PrestaShop no encuentra la base de datos que necesita para funcionar.

Síntomas comunes:

La tienda muestra una pantalla en blanco.
Aparece el mensaje de error directamente.
El panel de administración también falla.
No puedes acceder a ninguna página.

Paso 1: Identificar la causa del error

Antes de lanzarte a hacer cambios, es importante saber qué está fallando. Las causas más frecuentes son:

1.1. Cambio de contraseña de la base de datos

Si recientemente cambiaste la contraseña de tu base de datos MySQL (por ejemplo, desde cPanel o Syspanel), PrestaShop sigue usando la contraseña antigua.

1.2. Cambio de nombre de usuario o base de datos

Al migrar tu tienda a otro hosting o al crear una nueva base de datos, los nombres pueden cambiar.

1.3. Servidor de base de datos caído

A veces el problema no es tuyo, sino del servidor. Puede estar en mantenimiento o tener un fallo temporal.

1.4. Permisos incorrectos

El usuario de la base de datos puede no tener permisos suficientes para acceder a ella.

1.5. Archivo de configuración dañado o con errores

El archivo parameters.php puede haberse corrompido o tener caracteres extraños.

Paso 2: Accede a tu panel de control (cPanel o Syspanel)

Para solucionar el error, necesitas acceder a la herramienta de gestión de tu hosting. Aquí te explico cómo hacerlo en los dos paneles más comunes.

2.1. Si usas cPanel

Abre tu navegador y escribe: tudominio.com/cpanel.
Inicia sesión con tus credenciales de hosting.
Busca la sección Bases de Datos y haz clic en MySQL Databases.

2.2. Si usas Syspanel (HestiaCP)

[TIP] Syspanel es el nombre que le damos a HestiaCP. El acceso se hace por el puerto 2106.

Abre tu navegador y escribe: tudominio.com:2106.
Inicia sesión con tu usuario y contraseña de Syspanel.
En el menú lateral, busca Bases de Datos o MySQL.

Paso 3: Verifica los datos de conexión

Ahora que estás en el panel, revisa la información de tu base de datos. Necesitarás tres datos clave: nombre de la base de datos, nombre de usuario y contraseña.

3.1. En cPanel

En la sección MySQL Databases, verás una lista de bases de datos y sus usuarios asociados.
Anota el nombre exacto de la base de datos y el usuario. La contraseña no la verás directamente, pero puedes cambiarla desde allí.

3.2. En Syspanel

Ve a Bases de Datos y verás una tabla con los nombres.
Haz clic en el icono de edición (lápiz) para ver el usuario. La contraseña suele mostrarse en texto plano o puedes regenerarla.

[WARNING] Si cambias la contraseña desde el panel, recuerda actualizarla también en PrestaShop. De lo contrario, el error persistirá.

Paso 4: Edita el archivo de configuración de PrestaShop

Este es el paso más importante. Debes modificar el archivo app/config/parameters.php para que tenga los datos correctos.

4.1. Localiza el archivo

Usa un cliente FTP (como FileZilla) o el administrador de archivos de tu panel:

En cPanel: Ve a File Manager y navega hasta la carpeta public_html (o la carpeta donde esté instalado PrestaShop).
En Syspanel: Usa Administrador de Archivos en el menú lateral.

Dentro de la carpeta de PrestaShop, busca app/config/parameters.php.

4.2. Haz una copia de seguridad

[INFO] Siempre es buena idea hacer una copia de seguridad antes de editar archivos críticos. Descarga el archivo original a tu PC.

4.3. Edita el archivo

Abre parameters.php con un editor de texto (como el Bloc de notas o el editor integrado del panel). Busca estas líneas:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_tu_bd',
'database_password' => 'contraseña_de_tu_bd',

Corrige cada valor:

database_host: Normalmente es localhost, pero si tu hosting usa un servidor remoto, puede ser una IP o un nombre como mysql.tudominio.com.
database_port: Casi siempre es 3306. Déjalo así.
database_name: El nombre exacto que viste en cPanel o Syspanel.
database_user: El usuario exacto (puede incluir un prefijo, como usuario_nombre).
database_password: La contraseña actual (si la cambiaste, pon la nueva).

Guarda los cambios y sube el archivo si lo editaste localmente.

[TIP] Si no encuentras el archivo parameters.php, busca config/settings.inc.php en la raíz de PrestaShop (versiones 1.6 o anteriores).

Paso 5: Prueba la conexión desde el panel de control

Antes de volver a tu tienda, verifica que la conexión funciona.

5.1. En cPanel

Ve a phpMyAdmin (dentro de Bases de Datos).
Intenta iniciar sesión con el usuario y contraseña que pusiste en parameters.php. Si puedes acceder, la conexión es correcta.

5.2. En Syspanel

Ve a Bases de Datos y haz clic en phpMyAdmin.
Prueba a acceder con las credenciales. Si funciona, el problema está en PrestaShop.

Paso 6: Verifica los permisos del usuario

A veces el usuario tiene acceso a la base de datos, pero no todos los permisos necesarios.

6.1. En cPanel

En MySQL Databases, baja hasta Usuarios en bases de datos.
Asegúrate de que el usuario esté vinculado a la base de datos y tenga marcados TODOS LOS PRIVILEGIOS (o al menos SELECT, INSERT, UPDATE, DELETE, CREATE, DROP).

6.2. En Syspanel

En la edición de la base de datos, revisa que el usuario tenga permisos completos. Si no, asígnaselos.

Paso 7: Soluciona problemas de servidor

Si todo lo anterior está bien, el problema puede ser del servidor.

7.1. Comprueba el estado del servidor MySQL

Pregunta a tu proveedor de hosting si hay incidencias.
En cPanel, a veces hay un indicador de estado en la página principal.

7.2. Reinicia el servicio MySQL (si tienes acceso)

[WARNING] Solo haz esto si tienes permisos de administrador en el servidor. En hosting compartido, no suele ser posible.

Paso 8: Reconstruye el archivo de configuración

Si después de todo el error persiste, puedes regenerar el archivo parameters.php desde el instalador de PrestaShop.

8.1. Descarga el instalador

Ve a la web oficial de PrestaShop y descarga la misma versión que tienes instalada.

8.2. Sube el instalador a tu servidor

Usa FTP para subir la carpeta install a la raíz de tu tienda.

8.3. Ejecuta el instalador

Accede a tudominio.com/install.
El instalador detectará que ya hay una base de datos y te preguntará si quieres sobrescribir la configuración.
Introduce los datos correctos y continúa. Al final, se generará un nuevo parameters.php.

[INFO] Después de esto, elimina la carpeta install por seguridad.

Preguntas Frecuentes (FAQ)

¿Por qué aparece "Cannot connect to database" después de un cambio de hosting?

Al migrar, los datos de conexión (nombre de la base de datos, usuario, contraseña) suelen cambiar. Debes actualizar parameters.php con los nuevos valores.

¿Puedo usar la misma base de datos para dos instalaciones de PrestaShop?

No es recomendable. Cada tienda debe tener su propia base de datos para evitar conflictos.

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

En versiones antiguas de PrestaShop (1.6 y anteriores), el archivo se llama config/settings.inc.php y está en la raíz. En versiones modernas (1.7+), está en app/config/parameters.php.

¿El error puede deberse a un plugin o tema?

Raramente. Los plugins no modifican directamente la conexión a la base de datos, pero un tema mal codificado podría causar errores. Si el error aparece solo en ciertas páginas, puede ser un problema de tema.

¿Cómo sé si mi servidor MySQL está funcionando?

Puedes probar conectarte desde phpMyAdmin. Si no puedes, contacta a tu hosting.

Resumen final

Para solucionar el error "Cannot connect to database" en PrestaShop, sigue estos pasos:

Accede a tu panel (cPanel o Syspanel por puerto 2106).
Verifica los datos de tu base de datos (nombre, usuario, contraseña).
Edita el archivo app/config/parameters.php con los datos correctos.
Prueba la conexión desde phpMyAdmin.
Ajusta los permisos del usuario si es necesario.
Reconstruye el archivo con el instalador si falla.

[TIP] Si después de todo el error sigue, contacta a tu proveedor de hosting. Puede ser un problema de configuración del servidor que ellos deben resolver.

Espero que esta guía te haya sido de ayuda. ¡No te rindas! Con paciencia y siguiendo estos pasos, tu tienda PrestaShop volverá a funcionar en poco tiempo.