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

¿Tu tienda PrestaShop muestra el temido mensaje "No se puede conectar a la base de datos"? No te preocupes, es uno de los errores más comunes, pero también de los que más fácil se solucionan si sigues los pasos adecuados. Este aviso aparece cuando tu tienda no logra comunicarse con MySQL, el sistema donde se guardan todos tus productos, pedidos y clientes.

En esta guía completa, te explicaré de forma sencilla y paso a paso cómo diagnosticar y arreglar el error base datos prestashop, incluso si no tienes experiencia técnica. Vamos a ello.

¿Por qué ocurre este error en PrestaShop?

Antes de lanzarnos a solucionarlo, es clave entender qué lo causa. El mensaje suele aparecer por estas razones:

Datos de acceso incorrectos en el archivo de configuración de PrestaShop.
El servidor MySQL está caído o no responde.
Los permisos del usuario de la base de datos son insuficientes.
El archivo de configuración está corrupto o tiene rutas erróneas.
El hosting ha cambiado la contraseña o el puerto de la base de datos.
La base de datos ha alcanzado su límite de conexiones simultáneas.

La buena noticia es que casi todos estos problemas tienen solución. Solo necesitas ir paso a paso y con calma.

Primeros pasos: Respira y verifica lo básico

Cuando veas el error, no entres en pánico. Empieza por estas comprobaciones rápidas:

Recarga la página después de 30 segundos. A veces es un fallo temporal del servidor.
Revisa si otras páginas de tu tienda funcionan (por ejemplo, el panel de administración). Si solo falla la tienda pública, el problema puede estar en un módulo o en la caché.
Comprueba el estado de tu hosting. Entra en el panel de control de tu proveedor (como cPanel, Plesk o Syspanel) y mira si el servicio MySQL está activo. Si está apagado, actívalo desde ahí.

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que accedes por el puerto 2106. Por ejemplo: https://tu-dominio.com:2106. Ahí podrás ver el estado de MySQL fácilmente.

Solución paso a paso para el error de conexión

Si lo básico no funciona, sigue esta guía ordenada. No te saltes pasos, ya que cada uno resuelve una causa distinta.

1. Revisa el archivo de configuración de PrestaShop

El archivo parameters.php (en versiones nuevas) o settings.inc.php (en versiones antiguas) contiene los datos de acceso a tu base de datos. Si estos datos son incorrectos, la conexión bd prestashop falla.

¿Dónde está el archivo? En la carpeta raíz de tu instalación, normalmente en config/.

Para revisarlo:

Accede a tu hosting mediante FTP (con FileZilla, por ejemplo) o el Administrador de archivos del panel.
Navega hasta config/ y descarga parameters.php a tu ordenador.
Ábrelo con un editor de texto (como Notepad++ o Sublime Text).
Busca las líneas que empiezan por 'database_host', 'database_name', 'database_user' y 'database_password'.

Comprueba que estos datos coinciden con los que tienes en tu panel de hosting. Si no estás seguro, crea una nueva base de datos y usuario en tu panel (o pide a tu proveedor que te los confirme).

[WARNING] Nunca edites este archivo directamente desde el panel de tu hosting sin hacer una copia de seguridad. Si te equivocas, puedes dejar tu tienda completamente inaccesible.

2. Verifica que el servidor MySQL está activo

El problema puede ser que MySQL no esté corriendo. Esto es más común en servidores compartidos o VPS.

En cPanel ve a "Base de Datos MySQL" y mira si hay algún indicador de error.
En Plesk, revisa la sección de "Servicios" o "Base de datos".
En Syspanel (puerto 2106), busca el apartado de "Servicios" y comprueba que MySQL aparece como "Activo".

Si está apagado, actívalo. Si no puedes, contacta con tu proveedor de hosting, ya que puede ser un problema del servidor.

3. Comprueba los permisos del usuario de la base de datos

Un usuario de MySQL necesita permisos específicos para que PrestaShop funcione. A veces, al restaurar una copia o migrar, los permisos se pierden.

Desde tu panel de hosting:

Ve a la sección de bases de datos MySQL.
Localiza el usuario que usa PrestaShop.
Asegúrate de que tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.) sobre la base de datos de tu tienda.

Si no sabes cómo hacerlo, en cPanel hay una opción llamada "Asignar usuario a la base de datos" donde puedes marcar "TODOS LOS PRIVILEGIOS". En Syspanel, busca "Usuarios de base de datos" y edita los permisos.

[INFO] Es muy común que tras una migración de hosting, el usuario de MySQL pierda permisos. Este paso resuelve muchos casos de prestashop no conecta con la base de datos.

4. Actualiza los datos de conexión en PrestaShop

Si has confirmado que los datos son correctos pero el error persiste, puede que PrestaShop esté usando una caché de configuración obsoleta.

Para forzar que PrestaShop lea los nuevos datos:

Borra la carpeta var/cache (en PrestaShop 1.7 y 8) o cache (en versiones 1.6). No borres los archivos .htaccess que haya dentro, solo el contenido de la carpeta.
Si tienes acceso al panel de administración, ve a Parámetros Avanzados > Rendimiento y pulsa "Vaciar la caché". Pero si el error te impide entrar, hazlo por FTP.

5. Revisa el archivo `.env` o variables de entorno

En algunas configuraciones de hosting gestionado (como Docker o alojamientos específicos), los datos de la base de datos se definen mediante variables de entorno. Esto puede sobrescribir el parameters.php.

Si tu hosting usa este sistema:

Busca un archivo llamado .env en la raíz de tu instalación.
Ábrelo y comprueba las variables DB_HOST, DB_NAME, DB_USER y DB_PASS.
Asegúrate de que coinciden con los de tu base de datos.

[WARNING] Este archivo es sensible. No lo compartas ni lo subas a repositorios públicos. Si lo modificas, guarda una copia de seguridad.

6. Prueba la conexión directa a MySQL

Para descartar que el problema sea del servidor MySQL en sí, puedes hacer una prueba simple:

En tu hosting, busca la herramienta phpMyAdmin (o similar).
Intenta acceder con el mismo usuario y contraseña que usa PrestaShop.
Si no puedes entrar, el problema está en los datos de acceso o en el servidor.
Si sí puedes entrar, el problema está en la comunicación entre PrestaShop y MySQL.

Otra prueba: desde tu hosting, crea un archivo PHP temporal llamado test.php en la raíz con este código:

<?php
$conn = new mysqli('localhost', 'TU_USUARIO', 'TU_PASSWORD', 'TU_BASE_DATOS');
if ($conn->connect_error) {
    die("Error: " . $conn->connect_error);
} else {
    echo "Conexión exitosa";
}
?>

Sustituye los datos y accede a tudominio.com/test.php. Si ves "Conexión exitosa", el problema está en la configuración de PrestaShop, no en MySQL. Borra el archivo después de la prueba.

7. Comprueba el puerto y el host de MySQL

A veces el servidor MySQL no está en localhost, sino en otro puerto o dirección. Esto pasa en servidores dedicados o VPS.

En tu panel de hosting, busca el host de la base de datos (puede ser localhost, 127.0.0.1, o una dirección como mysql.tudominio.com).
Comprueba el puerto (por defecto es 3306, pero puede ser otro).
Actualiza estos valores en parameters.php en las líneas 'database_host' y 'database_port'.

[TIP] En Syspanel, el host suele ser localhost y el puerto 3306, pero si tienes dudas, mira la sección de "Bases de datos" donde aparece toda la información.

8. Verifica si hay un límite de conexiones activas

MySQL tiene un límite de conexiones simultáneas. Si tu tienda recibe mucho tráfico y hay muchas conexiones abiertas, puede bloquear nuevas conexiones.

Revisa en tu hosting si hay algún límite configurado.
Si es un plan compartido, puede que el problema sea temporal. Espera unos minutos.
Si tienes un VPS, puedes aumentar el límite editando el archivo my.cnf (parámetro max_connections), pero esto requiere conocimientos avanzados.

9. Restaura una copia de seguridad reciente

Si todo lo anterior falla, puede que tu base de datos esté dañada. En ese caso:

Haz una copia de seguridad de tu base de datos actual (si puedes acceder a phpMyAdmin).
Restaura una copia de seguridad anterior que sepas que funcionaba.
Si no tienes copia, contacta con tu proveedor de hosting para que te ayuden a recuperarla.

[WARNING] Restaurar una copia de seguridad puede hacer que pierdas pedidos o cambios recientes. Hazlo solo como último recurso y siempre con una copia de seguridad de lo actual.

Cómo evitar este error en el futuro

Una vez resuelto, toma medidas para que no vuelva a pasar:

Anota tus credenciales de la base de datos en un lugar seguro.
Haz copias de seguridad periódicas de tu base de datos (tu hosting puede tener copias automáticas).
No cambies la contraseña de MySQL sin actualizar el parameters.php.
Mantén PrestaShop actualizado a la última versión, ya que corrigen errores de conexión.
Si migras de hosting, sigue una guía específica para PrestaShop y verifica los permisos tras la migración.

Preguntas frecuentes (FAQ)

¿Qué significa exactamente "No se puede conectar a la base de datos"?

Significa que PrestaShop no puede comunicarse con el servidor MySQL donde se almacenan los datos de tu tienda. Es como si intentaras abrir una puerta con la llave equivocada: los datos de acceso no coinciden o el servidor no está disponible.

¿Puedo perder mis datos si hago estos pasos?

No, siempre que no borres la base de datos. Los pasos de esta guía solo modifican archivos de configuración o permisos. Aun así, te recomiendo hacer una copia de seguridad antes de empezar.

¿Y si no tengo acceso al panel de administración?

No pasa nada. Todos los pasos se pueden hacer desde el FTP y el panel de hosting. Si no puedes acceder a ninguno, contacta con tu proveedor de hosting directamente.

¿Cuánto tiempo se tarda en arreglar?

Depende de la causa. Si es un dato incorrecto, en 10 minutos lo tienes. Si es un problema del servidor, puede tardar más. Lo importante es ir paso a paso.

¿Debo contactar con mi proveedor de hosting?

Si has seguido todos los pasos y el error persiste, sí. Especialmente si sospechas que el problema es del servidor MySQL o de permisos a nivel de hosting. Ellos tienen herramientas para diagnosticarlo más rápido.

Conclusión

El error base datos prestashop es frustrante, pero casi siempre tiene solución. La clave está en revisar la configuración, los permisos y el estado del servidor MySQL de forma metódica.

Recuerda el orden lógico: primero verifica los datos de acceso, luego el estado del servidor, después los permisos y finalmente prueba la conexión directa. En la mayoría de los casos, el problema se resuelve actualizando el parameters.php o ajustando los permisos del usuario.

Si tu hosting usa Syspanel, no olvides que el acceso es por el puerto 2106. Y si te quedas atascado, no dudes en contactar con tu proveedor: para eso están.

Espero que esta guía te haya sido útil. Ahora ve y arregla esa conexión para que tu tienda vuelva a estar operativa. ¡Tu negocio te lo agradecerá!