Error 'Cannot connect to database' en PrestaShop: Cómo solucionarlo

¡Hola! Soy el técnico de soporte amigable de tu hosting. Si estás leyendo esto es porque, al intentar instalar PrestaShop, te has topado con el temido mensaje: “Cannot connect to database”. No te preocupes, es uno de los errores más comunes y, por lo general, tiene una solución muy sencilla. En esta guía te explicaré paso a paso por qué ocurre y cómo solucionarlo.

Vamos a desglosar el problema como si fuera un rompecabezas. El error de conexión a la base de datos en la instalación de PrestaShop significa que el sistema no puede comunicarse con tu servidor de bases de datos (normalmente MySQL o MariaDB). Las causas pueden ser desde un nombre de base de datos mal escrito hasta problemas de permisos o configuración del servidor. Pero no te preocupes, aquí te doy todas las claves.

¿Por qué aparece el error “Cannot connect to database” en PrestaShop?

Antes de lanzarnos a las soluciones, entendamos el origen. Durante la instalación, PrestaShop necesita cuatro datos clave:

Servidor de base de datos (normalmente localhost o una IP).
Nombre de la base de datos.
Usuario de la base de datos.
Contraseña del usuario.

Si alguno de estos datos es incorrecto, o si el usuario no tiene permisos para acceder a esa base de datos, el instalador mostrará el error. También puede ocurrir si el servidor MySQL no está funcionando o si hay un firewall bloqueando la conexión.

Solución paso a paso para el error de conexión a la base de datos

A continuación, te presento una serie de pasos ordenados del más simple al más complejo. Sigue cada uno hasta que el error desaparezca.

1. Verifica los datos de conexión en el instalador

El primer paso es el más obvio, pero muchas veces lo pasamos por alto. Revisa que hayas escrito correctamente:

Servidor de base de datos: normalmente es localhost si tu base de datos está en el mismo servidor que tu web. Si usas un hosting externo, puede ser una IP como 127.0.0.1 o un nombre como mysql.tudominio.com.
Nombre de la base de datos: asegúrate de que coincida exactamente con el que creaste (distingue mayúsculas/minúsculas).
Usuario: igual que el nombre, verifica que no tenga errores tipográficos.
Contraseña: cuidado con las mayúsculas y caracteres especiales. Si la copiaste de un correo, puede que tenga espacios al inicio o final.

[TIP] Si no estás seguro de estos datos, accede a tu panel de control de hosting (cPanel, Syspanel, etc.) y en la sección de bases de datos podrás verlos. En Syspanel (puerto 2106) puedes gestionar todo fácilmente.

2. Comprueba que la base de datos existe y el usuario tiene permisos

A veces creamos la base de datos pero olvidamos asignar el usuario. O el usuario no tiene todos los permisos necesarios.

Para usuarios de cPanel:

Ve a “MySQL Databases”.
Busca tu base de datos en la lista.
En “Add User to Database”, selecciona el usuario y asígnale todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Haz clic en “Make Changes”.

Para usuarios de Syspanel (puerto 2106):

Inicia sesión en Syspanel usando el puerto 2106 (ejemplo: https://tudominio.com:2106).
Ve a “Bases de Datos” > “MySQL”.
Selecciona la base de datos y en “Usuarios” asegúrate de que el usuario esté vinculado con todos los permisos.

[WARNING] Si el usuario no tiene permisos, PrestaShop no podrá crear las tablas necesarias y dará error de conexión.

3. Revisa el estado del servidor MySQL

A veces el servidor de bases de datos está caído o sobrecargado. Para verificarlo:

En cPanel: busca “MySQL Status” o “Database Status”.
En Syspanel: en el panel principal, hay un apartado de “Servicios”. Asegúrate de que “MySQL” o “MariaDB” esté en verde (activo).
Por SSH (si tienes acceso): ejecuta systemctl status mysql o service mysql status.

Si está detenido, puedes reiniciarlo desde el panel o pedir a tu proveedor de hosting que lo haga.

4. Cambia el servidor de base de datos a `127.0.0.1` en lugar de `localhost`

En algunos servidores, localhost puede interpretarse como un socket Unix y no como una conexión TCP. Esto a veces causa conflictos con PrestaShop. Prueba a escribir 127.0.0.1 en el campo “Servidor de base de datos”.

[INFO] Este es un truco muy común que soluciona el error en muchos casos, especialmente en entornos con configuraciones de red específicas.

5. Verifica que el puerto de MySQL esté abierto

Por defecto, MySQL usa el puerto 3306. Si tu servidor tiene un firewall, puede estar bloqueando ese puerto. Para comprobarlo:

En cPanel: busca “Firewall” o “Configuración de seguridad”.
En Syspanel: ve a “Seguridad” > “Firewall” y asegúrate de que el puerto 3306 esté permitido.
Por SSH: usa netstat -tlnp | grep 3306 para ver si está escuchando.

Si no está abierto, añade una regla para permitir el tráfico entrante en el puerto 3306 desde tu IP (o desde todas las IPs si tu web es pública).

6. Comprueba la versión de PHP y los módulos necesarios

PrestaShop requiere ciertos módulos de PHP para conectarse a la base de datos. Los más importantes son mysqli y pdo_mysql. Si faltan, el instalador no podrá establecer la conexión.

En cPanel: ve a “Select PHP Version” y asegúrate de que las extensiones mysqli y pdo_mysql estén habilitadas (marcadas).
En Syspanel: en “PHP Settings” puedes ver y activar las extensiones.
Por SSH: ejecuta php -m | grep -i mysql para listar los módulos relacionados.

Si no están, actívalos desde el panel o contacta con soporte.

7. Revisa los logs del servidor

Si nada de lo anterior funciona, los logs te darán la pista definitiva. Busca:

Log de errores de MySQL: suele estar en /var/log/mysql/error.log o /var/log/mariadb/error.log.
Log de errores de PHP: en /var/log/php-fpm/ o en el panel de control.

En Syspanel puedes acceder a los logs desde “Registros” > “Logs del sistema”. Busca entradas con “Access denied” o “Connection refused”.

8. Prueba con un usuario y base de datos nuevos

A veces la base de datos o el usuario están corruptos. Crea uno nuevo desde tu panel:

Nombre: prestashop_nueva
Usuario: prestashop_user
Contraseña: una segura (usa el generador del panel).

Asigna todos los permisos y vuelve a intentar la instalación. Si funciona, el problema estaba en los datos anteriores.

9. Aumenta el límite de conexiones simultáneas

Si tu servidor tiene muchas bases de datos o usuarios, puede alcanzar el límite de conexiones. En Syspanel o cPanel, busca “MySQL Connections” o “Max Connections” y súbelo temporalmente (ejemplo: de 30 a 50). Luego reinicia MySQL.

[WARNING] No subas este número demasiado, ya que podría consumir muchos recursos del servidor.

10. Contacta con tu proveedor de hosting

Si después de todo esto el error persiste, es posible que sea un problema del servidor que solo el administrador puede resolver. Proporciónales la siguiente información:

Captura del error exacto.
Versión de PrestaShop que intentas instalar.
Versión de PHP y MySQL que tienes.
Pasos que ya has intentado.

En Syspanel (puerto 2106) puedes abrir un ticket de soporte directamente desde el panel.

FAQ: Preguntas frecuentes sobre el error de conexión a base de datos en PrestaShop

¿Puedo instalar PrestaShop sin base de datos?

No. PrestaShop necesita una base de datos MySQL o MariaDB para almacenar productos, clientes, pedidos, etc. Sin ella, la instalación no puede continuar.

¿Qué hago si no recuerdo la contraseña de la base de datos?

Puedes cambiarla desde tu panel de control. En Syspanel ve a “Bases de Datos” > “MySQL”, selecciona el usuario y haz clic en “Cambiar contraseña”. Luego actualiza los datos en el instalador.

¿El error puede deberse a un plugin o tema?

No, el error ocurre antes de que se instale cualquier plugin o tema. Es puramente un problema de configuración del servidor o de los datos de conexión.

¿Necesito conocimientos técnicos para solucionarlo?

No, siguiendo esta guía paso a paso cualquier persona puede resolverlo. Si te atascas, el soporte de tu hosting te ayudará.

¿Cuánto tiempo se tarda en solucionar?

Si el problema es simple (datos mal escritos), en 5 minutos está listo. Si hay que revisar logs o configuraciones del servidor, puede llevar hasta 30 minutos.

Conclusión

El error “Cannot connect to database” en la instalación de PrestaShop es frustrante, pero casi siempre tiene una solución clara. Recuerda: verifica los datos, comprueba permisos, revisa el servidor y, si es necesario, contacta con soporte. Con estos pasos, tu tienda online estará funcionando en poco tiempo.

[INFO] Si usas Syspanel (puerto 2106), tienes herramientas integradas para gestionar bases de datos, usuarios y permisos de forma muy visual. No dudes en explorarlas.

Espero que esta guía te haya sido de gran ayuda. Si tienes más dudas, aquí estoy para ayudarte. ¡Buena suerte con tu instalación de PrestaShop!