Error conexión base de datos PrestaShop: Solución

¿Qué significa exactamente el error de conexión a la base de datos en PrestaShop?

Cuando visitas tu tienda online y en lugar de ver tu catálogo de productos aparece un mensaje en inglés como "Link to database cannot be established" o un texto en español que dice "Error de conexión con la base de datos", significa que tu PrestaShop no logra comunicarse con el servidor donde se almacenan todos tus datos (productos, clientes, pedidos, configuraciones).

Este es uno de los errores más comunes y también uno de los que más susto causan, porque parece que has perdido toda tu tienda. Pero tranquilo: en el 95% de los casos, la solución es sencilla y no has perdido nada de información.

En este artículo te voy a explicar, paso a paso y sin tecnicismos innecesarios, cómo diagnosticar y arreglar el error base datos prestashop, tanto si tienes conocimientos técnicos como si eres principiante total.

¿Por qué ocurre este error?

Antes de lanzarnos a arreglar nada, es importante entender por qué ocurre. El error base datos prestashop puede aparecer por varias razones:

El servidor de base de datos (MySQL o MariaDB) está caído o no responde.
Las credenciales de acceso a la base de datos han cambiado o son incorrectas.
El archivo de configuración parameters.php tiene datos erróneos.
La base de datos ha superado el límite de espacio o conexiones.
Hay un problema con el puerto de conexión MySQL.
El hosting ha realizado cambios en los servidores (migraciones, actualizaciones, etc.).
Un plugin o módulo ha modificado los archivos de configuración.

Vamos a ir de lo más simple a lo más complejo, para que puedas resolverlo sin volverte loco.

Paso 1: Verifica que el servidor MySQL está activo

Lo primero que debes comprobar es si el servicio de base de datos está funcionando. Esto depende de si tienes un hosting compartido o un servidor propio (VPS o dedicado).

Si tienes un hosting compartido (típico en Hostinger, SiteGround, etc.)

Accede a tu panel de control del hosting (cPanel, Plesk o similar) y busca una sección llamada "MySQL Databases" o "Base de datos". Allí verás si la base de datos aparece activa.

Si ves que el estado es "caído" o "inactivo", intenta reiniciar el servicio desde el panel. En algunos hostings, también puedes contactar con soporte técnico para que lo activen ellos.

Si tienes un VPS o servidor dedicado

Accede por SSH y ejecuta:

systemctl status mysql

O si usas MariaDB:

systemctl status mariadb

Si está inactivo, ejecuta:

systemctl restart mysql

O en su caso:

systemctl restart mariadb

[TIP] Si no sabes qué es SSH, no te preocupes: en un hosting compartido nunca lo necesitarás. Ve directamente al panel de control.

Paso 2: Revisa las credenciales en el archivo parameters.php

Si el servidor MySQL está activo, el siguiente paso es comprobar que PrestaShop tiene las credenciales correctas para conectarse.

PrestaShop guarda esta información en un archivo llamado parameters.php, que se encuentra en la carpeta app/config/ de tu instalación.

Cómo localizar y editar el archivo

Accede a tu hosting mediante el administrador de archivos del panel (o por FTP con FileZilla).
Navega hasta la carpeta app/config/.
Busca el archivo parameters.php.
Ábrelo con un editor de texto (puedes usar el editor del propio panel).

Dentro del archivo verás algo similar a esto:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Comprueba que estos datos son correctos. Si no los recuerdas, puedes encontrarlos en el panel de tu hosting, en la sección de bases de datos MySQL.

[WARNING] Ten mucho cuidado al editar este archivo: si borras una coma o una comilla, podrías romper tu tienda por completo. Haz una copia de seguridad antes de modificarlo.

Paso 3: El puerto de conexión MySQL

A veces, el error conexion mysql prestashop se debe a que la conexión se está intentando realizar por un puerto incorrecto. El puerto predeterminado de MySQL es el 3306, pero algunos hostings usan puertos alternativos.

En el archivo parameters.php, asegúrate de que la línea 'database_port' tiene el valor correcto. Si tu hosting te proporcionó un puerto específico, cámbialo ahí.

[INFO] Si no estás seguro del puerto, contacta con tu proveedor de hosting y pregunta: "¿Qué puerto MySQL debo usar para conexiones externas?"

Paso 4: Comprueba si la base de datos existe y tiene contenido

Si las credenciales son correctas, pero PrestaShop sigue sin conectar, puede que la base de datos haya sido eliminada o esté vacía.

Cómo verificarlo

Entra en el panel de tu hosting.
Ve a la sección de bases de datos MySQL.
Haz clic en "phpMyAdmin" (o la herramienta similar que tenga tu hosting).
Selecciona tu base de datos y mira si hay tablas (debería haber decenas, como ps_products, ps_orders, etc.).

Si no hay tablas, significa que la base de datos está vacía. Esto puede pasar tras una migración fallida o un ataque.

[WARNING] Si la base de datos está vacía y no tienes una copia de seguridad reciente, la situación es grave. Contacta con tu hosting inmediatamente para intentar recuperarla desde sus backups.

Paso 5: El error "PrestaShop no conecta BD" tras una migración

Este es un caso muy típico: has movido tu tienda a un nuevo hosting, o has cambiado de dominio, y ahora prestashop no conecta bd.

Lo que suele pasar es que el archivo parameters.php conserva los datos antiguos del hosting anterior. La solución es actualizar los datos de conexión.

Además del parameters.php, hay otro archivo que debes revisar: app/config/parameters.yml. Este archivo también contiene datos de conexión y, en ocasiones, PrestaShop lee de ahí en lugar del .php.

Abre ambos archivos y asegúrate de que tienen los mismos datos.

Paso 6: Problemas con el caché de PrestaShop

A veces, el error base datos prestashop persiste incluso después de corregir las credenciales. Esto puede deberse a que PrestaShop guarda en caché la configuración antigua.

Cómo limpiar el caché manualmente

Conecta por FTP a tu servidor.
Navega hasta la carpeta var/cache/ (o app/cache/ en versiones antiguas).
Elimina el contenido de las carpetas dev y prod (pero no las carpetas en sí).
Si no puedes borrar archivos por FTP, usa el administrador de archivos del hosting.

Después de limpiar el caché, intenta acceder a tu tienda de nuevo.

Paso 7: Verifica el archivo .htaccess

Un .htaccess corrupto también puede provocar problemas que impiden la conexión a la base de datos. Este archivo se encuentra en la raíz de tu instalación de PrestaShop.

Cómo solucionarlo

Renombra el archivo .htaccess a .htaccess_old (por si acaso).
Intenta acceder a tu tienda.
Si funciona, ve a Back Office > Parámetros Avanzados > Rendimiento y pulsa en "Regenerar el archivo .htaccess".

Si no funciona, restaura el archivo original.

Paso 8: Comprueba los límites de conexión y recursos

En algunos hostings, especialmente los económicos, hay límites estrictos de conexiones MySQL simultáneas. Si tu tienda recibe mucho tráfico, el servidor puede rechazar nuevas conexiones.

Señales de que este es tu problema

El error aparece solo en horas punta.
Funciona después de reiniciar el servidor, pero vuelve a fallar.
Otros sitios en tu mismo hosting también dan errores de base de datos.

La solución pasa por:

Contactar con tu hosting y pedirles que aumenten el límite.
Optimizar las consultas de PrestaShop (instalar un módulo de caché como "Cache & Chunk").
Considerar migrar a un plan superior.

Paso 9: Si tienes Syspanel (antes HestiaCP)

Si tu hosting utiliza el panel de control Syspanel (anteriormente conocido como HestiaCP), el proceso de verificación de la base de datos es ligeramente diferente.

[INFO] Recuerda que el acceso a Syspanel se realiza por el puerto 2106. Por ejemplo: https://tudominio.com:2106

Dentro de Syspanel:

Ve a la sección "Bases de datos" en el menú lateral.
Verás un listado con todas tus bases de datos y su estado.
Haz clic en "Editar" junto a la base de datos de tu PrestaShop.
Comprueba que el usuario y la contraseña coinciden con los del parameters.php.

Si los datos no coinciden, actualízalos en el archivo parameters.php.

Paso 10: Contacta con el soporte de tu hosting

Si has llegado hasta aquí y nada funciona, es hora de pedir ayuda profesional. El error conexion mysql prestashop puede deberse a problemas internos del servidor que solo el equipo de soporte puede resolver.

Qué información preparar antes de contactar

El mensaje de error exacto (cópialo y pégalo).
La URL de tu tienda.
Fecha y hora en que empezó el problema.
Pasos que ya has intentado.
Capturas de pantalla si es posible.

Preguntas Frecuentes (FAQ)

¿He perdido todos mis datos si veo este error?

No. En la gran mayoría de los casos, los datos siguen en la base de datos, solo que PrestaShop no puede acceder a ellos por un problema de configuración o de conexión. No toques nada que no sepas lo que es y contacta con soporte si tienes dudas.

¿Puedo arreglar el error sin acceso al panel de administración?

Sí, puedes hacerlo editando los archivos por FTP o desde el administrador de archivos del hosting. No necesitas acceder al Back Office.

¿Cuánto tiempo se tarda en solucionar?

Si es un problema de credenciales, unos 10 minutos. Si es un problema del servidor, puede tardar más, dependiendo de la respuesta del soporte técnico.

¿Debo actualizar PHP a la última versión?

PrestaShop requiere una versión específica de PHP. Si tu hosting ha actualizado PHP y tu PrestaShop es antiguo, puede dar problemas de conexión. Consulta la compatibilidad en la documentación oficial.

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

Es posible, aunque poco frecuente. Si sospechas que alguien ha modificado tus archivos, revisa la fecha de modificación del parameters.php y cambia todas tus contraseñas (hosting, base de datos, FTP).

Resumen final: checklist rápido

Para que no se te escape nada, aquí tienes la lista completa de comprobaciones:

¿El servidor MySQL/MariaDB está activo?
¿Las credenciales en parameters.php son correctas?
¿El puerto MySQL es el correcto?
¿La base de datos existe y tiene tablas?
¿Has limpiado el caché de PrestaShop?
¿El .htaccess está en buen estado?
¿Hay límites de conexión activos?
¿Has contactado con soporte si nada funciona?

Conclusión

El error base datos prestashop es un problema molesto, pero casi siempre tiene solución. La clave está en ir paso a paso, sin desesperarse, y verificar cada uno de los puntos que hemos visto en este artículo.

Recuerda que la prevención es la mejor medicina: haz copias de seguridad periódicas de tu base de datos y de tus archivos, mantén PrestaShop actualizado y no instales módulos de dudosa procedencia.

Si has llegado hasta aquí, ya sabes exactamente cómo diagnosticar el error conexion mysql prestashop y qué hacer para que tu tienda vuelva a funcionar. Espero que este artículo te haya sido de gran ayuda y que tu tienda online esté operativa en muy poco tiempo.

[TIP] Guarda este artículo en tus favoritos: te será útil cada vez que aparezca un problema de conexión, no solo en PrestaShop, sino en cualquier CMS que use MySQL.