Solucionar errores de conexión de base de datos en PrestaShop

Cuando instalas o migras una tienda online con PrestaShop, uno de los pasos más críticos es la conexión con tu base de datos. Si esta conexión falla, tu tienda no cargará, mostrará pantallas en blanco o mensajes de error difíciles de interpretar.

En este artículo, te explicamos los errores comunes al conectar PrestaShop con la base de datos y, lo más importante, cómo solucionarlos paso a paso. Está escrito pensando en personas sin experiencia técnica, con un lenguaje claro y ejemplos prácticos.

¿Por qué es importante una conexión correcta con la base de datos?

PrestaShop almacena toda la información de tu tienda (productos, clientes, pedidos, configuraciones) en una base de datos. Sin una conexión estable y correcta, el sistema no puede leer ni escribir datos. Esto provoca errores como:

Pantalla blanca al abrir la tienda.
Mensajes como “No se puede conectar a la base de datos”.
Errores al instalar o actualizar módulos.
Problemas al migrar tu tienda a un nuevo hosting.

Entender los errores más frecuentes te ahorrará horas de frustración.

Error 1: “No se puede conectar al servidor de base de datos”

Este es uno de los errores más comunes. Aparece cuando PrestaShop intenta comunicarse con el servidor MySQL/MariaDB y no lo logra.

Causas principales

El servidor de base de datos está caído o no responde.
El nombre del servidor (host) es incorrecto.
El puerto de conexión no es el estándar (3306) o está bloqueado.

Cómo solucionarlo

Verifica que el servidor MySQL esté activo
Si usas un panel de control como cPanel, DirectAdmin o Syspanel (accesible por el puerto 2106), busca la sección de “Servicios” o “MySQL” y asegúrate de que esté en ejecución.
Comprueba el nombre del host
En la mayoría de los casos, el host es localhost. Pero si tu base de datos está en un servidor diferente, usa la IP o el nombre de dominio del servidor de bases de datos. Por ejemplo: db.mitienda.com o 192.168.1.10.
Revisa el puerto de conexión
El puerto por defecto es el 3306. Si tu hosting usa un puerto diferente, debes especificarlo en el archivo de configuración de PrestaShop. Por ejemplo: localhost:3307.

[TIP] Si estás en un entorno compartido, el puerto suele ser el 3306. En servidores dedicados o VPS, puede variar. Consulta con tu proveedor de hosting.

Error 2: “Acceso denegado para el usuario ‘usuario’@’localhost’”

Este error indica que las credenciales (usuario y contraseña) que usas para conectarte a la base de datos son incorrectas o no tienen permisos suficientes.

Causas principales

El nombre de usuario o la contraseña están mal escritos.
El usuario no tiene permisos para acceder desde la IP o el host desde donde se conecta PrestaShop.
La contraseña contiene caracteres especiales que no se escapan correctamente.

Cómo solucionarlo

Verifica las credenciales en el archivo de configuración
Busca el archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones anteriores). Allí encontrarás algo como:
```
'database_host' => 'localhost',
'database_name' => 'nombre_bd',
'database_user' => 'usuario_bd',
'database_password' => 'contraseña_bd',
```
Prueba las credenciales directamente
Desde Syspanel (puerto 2106) o phpMyAdmin, intenta acceder con ese usuario y contraseña. Si no puedes, cámbialos.
Otorga permisos al usuario
En phpMyAdmin, selecciona la base de datos y ve a la pestaña “Privilegios”. Asegúrate de que el usuario tenga todos los privilegios sobre esa base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
Escapa caracteres especiales en la contraseña
Si tu contraseña contiene símbolos como $, %, &, #, cámbiala por una más simple (solo letras y números) para evitar problemas de interpretación.

[WARNING] Nunca uses contraseñas vacías o muy débiles. Aunque soluciones el error, pones en riesgo la seguridad de tu tienda.

Error 3: “Base de datos ‘nombre_bd’ no existe”

Este error es muy claro: PrestaShop no encuentra la base de datos que intentas usar. O no la has creado, o el nombre está mal escrito.

Causas principales

No has creado la base de datos antes de la instalación.
El nombre de la base de datos en el archivo de configuración no coincide con el nombre real.
La base de datos fue eliminada accidentalmente.

Cómo solucionarlo

Crea la base de datos desde tu panel de control
En Syspanel (puerto 2106), ve a “Base de datos” y crea una nueva. Anota el nombre exacto (suele ser algo como usuario_nombrebd).
Verifica el nombre en el archivo de configuración
Busca la línea 'database_name' en parameters.php o settings.inc.php y asegúrate de que coincida con el nombre real.
Si la base de datos fue eliminada, restáurala
Si tienes un respaldo (backup), súbelo desde phpMyAdmin o desde la línea de comandos. Si no, tendrás que reinstalar PrestaShop desde cero.

[INFO] Algunos hosting asignan un prefijo al nombre de la base de datos (por ejemplo, tuusuario_mibd). Asegúrate de incluir ese prefijo en la configuración.

Error 4: “El servidor MySQL ha abandonado la conexión”

Este error ocurre cuando la conexión con la base de datos se interrumpe durante la ejecución de una tarea (como importar productos o generar informes). Es común en sitios con mucho tráfico o consultas pesadas.

Causas principales

Tiempo de espera (timeout) demasiado bajo en el servidor MySQL.
Consultas SQL muy lentas o mal optimizadas.
Límite de conexiones simultáneas alcanzado.

Cómo solucionarlo

Aumenta el tiempo de espera en MySQL
Si tienes acceso a la configuración del servidor (por ejemplo, desde Syspanel), edita el archivo my.cnf y aumenta los valores de wait_timeout e interactive_timeout (por ejemplo, a 300 segundos).
Optimiza las consultas de PrestaShop
Activa la caché de PrestaShop (Ajustes > Rendimiento) y usa un plugin de caché para reducir la carga en la base de datos.
Aumenta el límite de conexiones
En my.cnf, cambia max_connections a un valor mayor (por ejemplo, 200). Luego reinicia MySQL.

[TIP] Si no tienes acceso a la configuración del servidor, contacta a tu proveedor de hosting y pídele que ajuste estos parámetros.

Error 5: “La versión de MySQL no es compatible con PrestaShop”

PrestaShop requiere una versión específica de MySQL o MariaDB. Si tu servidor usa una versión muy antigua o muy nueva, pueden aparecer errores.

Versiones recomendadas

PrestaShop 1.7.x: MySQL 5.6 o superior, MariaDB 10.1 o superior.
PrestaShop 8.x: MySQL 5.7 o superior, MariaDB 10.2 o superior.

Cómo solucionarlo

Verifica la versión de MySQL desde phpMyAdmin
En la página principal de phpMyAdmin, verás la versión del servidor. Compárala con los requisitos de tu versión de PrestaShop.
Actualiza MySQL/MariaDB
Si estás en un VPS o servidor dedicado, actualiza el motor de base de datos desde la línea de comandos. En hosting compartido, solicita la actualización a tu proveedor.
Si no puedes actualizar, cambia de versión de PrestaShop
Como último recurso, instala una versión de PrestaShop compatible con tu versión actual de MySQL.

FAQ: Preguntas frecuentes sobre errores de conexión en PrestaShop

¿Cómo sé si el error es de base de datos o de otra cosa?

Si ves mensajes como “No se puede conectar a la base de datos” o “Error en la conexión MySQL”, el problema es de base de datos. Si ves pantalla blanca sin mensajes, revisa los logs de error de PHP y de PrestaShop (en la carpeta var/logs/ o log/).

¿Puedo cambiar la contraseña de la base de datos sin perder datos?

Sí. Cambia la contraseña desde phpMyAdmin o Syspanel, y luego actualiza el archivo parameters.php o settings.inc.php con la nueva contraseña. No perderás ningún dato.

¿Qué hago si no tengo acceso a phpMyAdmin?

Puedes usar la línea de comandos (SSH) para conectarte a MySQL. También algunos paneles como Syspanel (puerto 2106) ofrecen acceso directo a la base de datos.

¿Por qué mi base de datos sigue dando error después de migrar?

Los errores de migración suelen deberse a:

Archivos de configuración con datos antiguos.
Permisos incorrectos en las tablas.
Versiones de MySQL incompatibles.
Rutas de archivos mal configuradas.

Revisa cada punto y, si es necesario, reinstala PrestaShop desde cero y restaura solo los datos (productos, clientes, pedidos) mediante un módulo de migración.

Conclusión

Los errores de conexión con la base de datos en PrestaShop pueden ser frustrantes, pero la mayoría tienen solución siguiendo pasos lógicos y verificando cada componente: servidor, credenciales, nombre de la base de datos y permisos.

Recuerda siempre:

Usar credenciales correctas y sin caracteres especiales.
Verificar que el servidor MySQL esté activo.
Tener un backup actualizado antes de hacer cambios.
Consultar con tu proveedor de hosting si no tienes acceso a configuraciones avanzadas.

Con esta guía, podrás diagnosticar y resolver los problemas más comunes sin necesidad de ser un experto en sistemas. ¡Tu tienda PrestaShop volverá a funcionar en poco tiempo!