Cómo solucionar 'Error al conectar a la base de datos' en PrestaShop

¿Qué significa "Error al conectar a la base de datos" en PrestaShop?

Cuando visitas tu tienda PrestaShop y te aparece un mensaje como "Error al conectar a la base de datos", "cannot connect to db" o un texto similar en inglés, significa que tu tienda no puede comunicarse con el servidor donde se almacenan todos tus productos, pedidos, clientes y configuración.

Es uno de los errores más comunes en el mundo del hosting y, aunque parece grave, en la mayoría de los casos tiene una solución sencilla. Este error puede aparecer tanto en la tienda (front-office) como en el panel de administración (back-office), y suele ir acompañado de mensajes como:

• Error de conexión con la base de datos
• Cannot connect to DB
• Link to database cannot be established
• Error establishing a database connection

A lo largo de esta guía completa, te explicaré paso a paso cómo diagnosticar y solucionar el error base de datos prestashop, incluso si no tienes experiencia técnica avanzada.

¿Por qué PrestaShop no conecta con la base de datos?

Antes de lanzarnos a solucionar el problema, es importante entender por qué ocurre. PrestaShop necesita tres datos fundamentales para conectarse a su base de datos MySQL:

1. El nombre de la base de datos
2. El usuario de la base de datos
3. La contraseña de ese usuario

Además, necesita saber dónde está alojada esa base de datos (normalmente localhost o una dirección IP como 127.0.0.1).

Cuando cualquiera de estos datos es incorrecto, o el servidor de base de datos está caído o saturado, PrestaShop no puede conectar y muestra el temido mensaje.

Primeros pasos: verifica si es un problema general

Lo primero que debes hacer es comprobar si el error afecta a toda tu web o solo a una parte. Prueba a entrar en tu panel de administración (por ejemplo, tudominio.com/admin).

• Si el error aparece también en el panel de administración: el problema es general y afecta a toda la tienda.
• Si solo aparece en la tienda (front-office): puede ser un problema de caché o de archivos corruptos.

En cualquiera de los dos casos, sigue los pasos que te doy a continuación.

Solución 1: Revisa el archivo de configuración parameters.php

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php, que se encuentra en la carpeta app/config/ de tu instalación.

Este es el primer lugar donde debes mirar cuando PrestaShop no conecta.

Cómo acceder al archivo

1. Entra en tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).
2. Busca el Administrador de Archivos o usa un cliente FTP como FileZilla.
3. Navega hasta la carpeta app/config/ de tu instalación de PrestaShop.
4. Busca el archivo parameters.php.

Qué debes comprobar

Abre el archivo con un editor de texto (como el Bloc de notas o Visual Studio Code) y busca las líneas que contienen los datos de la base de datos. Deberías ver algo parecido a esto:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Comprueba que estos cuatro datos son exactamente los mismos que tienes en tu panel de hosting.

[TIP] Si no sabes cuáles son tus datos de base de datos, puedes encontrarlos en el panel de control de tu hosting, normalmente en la sección "Bases de datos MySQL" o similar. Si usas Syspanel, recuerda que accedes por el puerto 2106 y ahí encontrarás la sección de bases de datos.

Cómo corregirlo

Si algún dato es incorrecto, corrígelo y guarda el archivo. Después, intenta acceder de nuevo a tu tienda.

[WARNING] Ten mucho cuidado al editar este archivo. Un solo carácter mal puesto puede empeorar el problema. Haz una copia de seguridad antes de modificarlo.

Solución 2: Verifica que el servidor MySQL esté activo

A veces el problema no está en tu configuración, sino en el servidor de base de datos. Si el servicio MySQL está caído o en mantenimiento, PrestaShop no podrá conectar.

Cómo comprobarlo

1. Accede a tu panel de control de hosting.
2. Busca la sección de "Servicios" o "Procesos".
3. Localiza el servicio MySQL o MariaDB.
4. Comprueba que está activo y funcionando.

Si está apagado, actívalo. En algunos paneles, como Syspanel (puerto 2106), esta opción está en "Servicios" o "Bases de datos".

[INFO] Si tu hosting es compartido, no siempre podrás reiniciar MySQL. En ese caso, contacta con el soporte de tu proveedor y pregunta si hay algún problema con el servidor de bases de datos.

Solución 3: Comprueba los permisos del usuario de la base de datos

En ocasiones, el usuario de la base de datos no tiene los permisos suficientes para acceder a ella. Esto puede ocurrir después de una migración, una restauración o un cambio en el panel de control.

Qué permisos necesita PrestaShop

El usuario debe tener al menos los siguientes permisos sobre la base de datos:

• SELECT (consultar datos)
• INSERT (insertar datos)
• UPDATE (actualizar datos)
• DELETE (eliminar datos)
• CREATE (crear tablas)
• ALTER (modificar tablas)
• DROP (eliminar tablas)
• INDEX (gestionar índices)

Cómo solucionarlo

1. Entra en la sección de Bases de datos de tu panel de hosting.
2. Busca el usuario que usa PrestaShop.
3. Edita sus permisos y asegúrate de que tenga todos los privilegios marcados.
4. Guarda los cambios y prueba de nuevo.

[WARNING] Si no estás seguro de qué usuario usa tu PrestaShop, revisa el archivo parameters.php como te expliqué en la Solución 1.

Solución 4: El host de la base de datos no es correcto

A veces, el problema está en el campo database_host. Muchos alojamientos usan localhost, pero otros usan una dirección específica como mysql.tudominio.com o una IP.

Cómo saber cuál es el host correcto

1. Revisa la documentación de tu proveedor de hosting.
2. En Syspanel (puerto 2106), la información de conexión suele aparecer junto a la base de datos.
3. Si tu hosting usa cPanel, el host suele ser localhost.

Si estás usando un hosting que no es local (por ejemplo, una base de datos externa), asegúrate de que el host es el correcto.

[TIP] Si cambiaste el host recientemente (por ejemplo, al mover tu web a otro servidor), este es probablemente el origen del error.

Solución 5: Restablece la contraseña de la base de datos

Otra causa muy común es que la contraseña de la base de datos haya cambiado sin que PrestaShop lo sepa. Esto puede pasar si:

• Cambiaste la contraseña desde el panel de hosting.
• Alguien la modificó por seguridad.
• El hosting la renovó automáticamente.

Cómo solucionarlo

1. Ve a la sección de Bases de datos en tu panel de hosting.
2. Cambia la contraseña del usuario que usa PrestaShop.
3. Actualiza el archivo parameters.php con la nueva contraseña.

[WARNING] No confundas la contraseña de tu panel de control con la de la base de datos. Son cosas diferentes.

Solución 6: Limpia la caché de PrestaShop

A veces, PrestaShop guarda en caché configuraciones antiguas que impiden la conexión. Esto es más común de lo que parece y tiene una solución muy sencilla.

Cómo limpiar la caché manualmente

1. Accede a tu hosting mediante FTP o el Administrador de Archivos.
2. Navega hasta la carpeta var/cache/ (en versiones modernas) o cache/ (en versiones antiguas).
3. Elimina todos los archivos que haya dentro de esa carpeta, pero no borres la carpeta en sí.
4. También puedes borrar el contenido de var/cache/dev/ y var/cache/prod/.

Después de esto, recarga tu tienda. PrestaShop regenerará la caché automáticamente.

[TIP] Si no encuentras la carpeta var/cache, activa la opción de "mostrar archivos ocultos" en tu cliente FTP.

Solución 7: Verifica que los archivos de PrestaShop no estén corruptos

Si ninguna de las soluciones anteriores funciona, es posible que algunos archivos de PrestaShop estén dañados o incompletos. Esto puede pasar después de una actualización fallida o un ataque.

Cómo solucionarlo

1. Descarga una copia limpia de la misma versión de PrestaShop que tienes instalada.
2. Descomprime el archivo en tu ordenador.
3. Sube por FTP solo los archivos de la carpeta app/ y src/, sobrescribiendo los existentes.
4. No sobrescribas la carpeta config/ si no quieres perder tu configuración.

[WARNING] Este proceso es más avanzado. Si no te sientes seguro, contacta con un profesional o con el soporte de tu hosting.

Solución 8: Comprueba si hay problemas con el puerto de MySQL

Algunos servidores usan un puerto diferente al estándar (3306) para MySQL. Si tu hosting usa otro puerto, PrestaShop no podrá conectar.

Cómo comprobarlo

En el archivo parameters.php, busca la línea:

'database_port' => '3306',

Si tu hosting usa otro puerto, deberás cambiarlo aquí. Esta información suele estar en la documentación de tu proveedor o en el panel de control.

[INFO] En la mayoría de los alojamientos compartidos, el puerto es el 3306 y no es necesario cambiarlo.

Solución 9: Revisa los logs de error

PrestaShop guarda registros de errores que pueden darte pistas muy valiosas sobre el problema.

Dónde encontrar los logs

1. En la carpeta var/logs/ de tu instalación.
2. Busca archivos con nombres como prod.log o dev.log.
3. Ábrelos con un editor de texto y busca líneas que contengan "database" o "SQL".

Estos registros te indicarán exactamente qué está fallando.

[TIP] Si no entiendes los logs, copia el texto del error y búscalo en Google. Seguramente no serás el primero en tener ese problema.

Preguntas frecuentes (FAQ)

¿Por qué me sale "cannot connect to db" después de cambiar de hosting?

Es muy común. Al cambiar de hosting, los datos de conexión (host, usuario, contraseña) cambian. Debes actualizar el archivo parameters.php con los nuevos datos.

¿Cuánto tiempo se tarda en solucionar este error?

Depende de la causa. Si es un problema de contraseña, en 5 minutos está resuelto. Si es un problema del servidor, puede tardar más.

¿Puedo perder mis datos si borro la caché?

No. La caché solo contiene archivos temporales. Tus productos, pedidos y clientes están en la base de datos, no en la caché.

¿Debo contactar con mi proveedor de hosting?

Si has probado todas las soluciones anteriores y el error persiste, sí. Puede ser un problema del servidor que solo ellos pueden solucionar.

¿El error puede deberse a un ataque informático?

En algunos casos, sí. Si sospechas que tu web ha sido atacada, cambia todas las contraseñas y revisa los archivos de tu instalación.

Resumen y recomendaciones finales

El error base de datos prestashop es uno de los problemas más frecuentes en tiendas online, pero también uno de los más fáciles de solucionar si se sigue un orden lógico:

1. Revisa el archivo parameters.php (la causa más común).
2. Comprueba que MySQL esté activo.
3. Verifica los permisos del usuario.
4. Limpia la caché.
5. Revisa los logs de error.

Si después de todo esto PrestaShop no conecta, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso a herramientas que tú no tienes y podrán diagnosticar el problema en minutos.

[TIP] Para evitar este problema en el futuro, te recomiendo:

• Cambiar las contraseñas de la base de datos periódicamente.
• Hacer copias de seguridad frecuentes.
• Mantener PrestaShop actualizado.
• Anotar los datos de conexión en un lugar seguro.

Espero que esta guía te haya sido de ayuda. Recuerda que la mayoría de los problemas de conexión a la base de datos tienen solución y no implican perder tu tienda. Con paciencia y siguiendo estos pasos, tu PrestaShop volverá a funcionar en poco tiempo.