Error base de datos PrestaShop | Solución en 5 pasos

¿Qué significa el error "Erreur de connexion à la base de données"?

Si alguna vez has visto este mensaje en tu tienda PrestaShop, no estás solo. Es uno de los errores más comunes y, afortunadamente, también uno de los más fáciles de solucionar si sabes dónde mirar.

Este error, que traducido significa "Error de conexión a la base de datos", aparece cuando PrestaShop no puede comunicarse con MySQL (o MariaDB), que es donde se almacenan todos tus productos, pedidos, clientes y configuraciones.

Cuando esto sucede, tu tienda se queda bloqueada y los visitantes ven una pantalla blanca o el mensaje de error. Pero no te preocupes: en esta guía paso a paso te enseñaremos a diagnosticar y solucionar el problema, incluso si no eres un experto técnico.

¿Por qué ocurre este error en PrestaShop?

Antes de lanzarnos a solucionar el error base datos prestashop, es importante entender las causas más frecuentes. Así podrás prevenirlo en el futuro.

Causas más comunes:

Cambio de contraseña de la base de datos: Si alguien (tú, tu agencia o tu proveedor) cambió la contraseña de MySQL y no actualizó el archivo de configuración de PrestaShop.
Cambio de servidor o migración: Si moviste tu tienda a un hosting nuevo y no actualizaste los datos de conexión.
Corrupción del archivo settings.inc.php: Este archivo contiene las credenciales de acceso a la base de datos. Si se corrompe o se modifica incorrectamente, la conexión falla.
Servidor MySQL caído: El servicio de base de datos puede haberse detenido por falta de recursos, mantenimiento o un error del sistema.
Límite de conexiones alcanzado: Si tu hosting tiene un límite de conexiones simultáneas y tu tienda tiene mucho tráfico, puede saturarse.
Errores de permisos: El usuario de la base de datos puede no tener los privilegios necesarios para acceder.

Paso 1: Verifica si es un problema temporal

Antes de tocar nada, haz esta comprobación rápida:

Espera unos minutos y vuelve a cargar tu tienda. A veces el servidor solo está reiniciándose.
Prueba desde otro dispositivo o red: Si te funciona desde el móvil con datos, el problema puede ser tu conexión o caché local.
Revisa el estado de tu hosting: Si usas un panel como cPanel, Plesk o Syspanel, entra y mira si hay algún aviso de mantenimiento o incidencias.

[TIP]: Si tu proveedor de hosting tiene una página de estado (status page), consúltala antes de hacer nada. Te ahorrarás tiempo si es un problema conocido.

Si después de unos minutos sigue el error, continúa con el siguiente paso.

Paso 2: Localiza y revisa el archivo settings.inc.php

El archivo settings.inc.php es el corazón de la conexión a la base de datos en PrestaShop. Se encuentra en la carpeta config de tu instalación.

¿Cómo encontrarlo?

Si usas cPanel: Archivos → Administrador de archivos → public_html → config → settings.inc.php
Si usas Syspanel (recuerda, el puerto de acceso es el 2106): Entra con tus credenciales, ve a Archivos o Gestor de archivos y navega hasta la carpeta de tu tienda.
Si usas FTP: Conéctate con FileZilla o similar y navega hasta la carpeta config.

¿Qué debo revisar?

Abre el archivo con un editor de texto plano (no uses Word) y busca estas líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');

Comprueba que:

El servidor (DB_SERVER) suele ser 'localhost' o '127.0.0.1', pero algunos hostings usan una dirección específica como 'mysql.tudominio.com'.
El nombre de la base de datos es correcto.
El usuario es el que tiene acceso a esa base.
La contraseña es correcta. Ten cuidado: si contiene caracteres especiales como $, ", ' o \, puede estar causando problemas.

[WARNING]: Si modificas este archivo, guarda una copia de seguridad antes. Un error de sintaxis puede empeorar las cosas.

¿Cómo actualizar la contraseña?

Si sospechas que la contraseña ha cambiado:

Ve a tu panel de hosting (cPanel, Syspanel en el puerto 2106, etc.).
Busca la sección de Bases de datos MySQL.
Cambia la contraseña del usuario correspondiente.
Actualiza la línea _DB_PASSWD_ en settings.inc.php con la nueva contraseña.
Guarda el archivo y recarga tu tienda.

Paso 3: Comprueba que el servidor MySQL está activo

Si los datos son correctos pero el error persiste, el problema puede ser que el servicio MySQL no esté funcionando.

En Syspanel (puerto 2106):

Inicia sesión en Syspanel.
Ve a la sección de Servicios o Procesos.
Busca MySQL o MariaDB en la lista.
Si aparece detenido, haz clic en Iniciar.

En cPanel:

Entra en cPanel.
Busca la sección Estado de los servicios o MySQL.
Si está detenido, contacta con tu proveedor de hosting para que lo reinicien.

[INFO]: En algunos hostings compartidos, no puedes reiniciar MySQL tú mismo. En ese caso, abre un ticket de soporte.

Paso 4: Verifica las credenciales desde otro método

Para confirmar si el problema es de PrestaShop o de la base de datos, prueba a conectar con las mismas credenciales desde otra herramienta.

Usando phpMyAdmin:

Accede a phpMyAdmin desde tu panel de hosting.
Introduce las mismas credenciales que tienes en settings.inc.php.
Si no puedes entrar, las credenciales son incorrectas o el usuario no tiene permisos.

Usando un archivo de prueba:

Crea un archivo llamado test.php en la raíz de tu tienda con este contenido:

<?php
$conn = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base');
if (!$conn) {
    die('Error: ' . mysqli_connect_error());
} else {
    echo 'Conexión exitosa a la base de datos';
}
?>

Guarda el archivo y accede a tudominio.com/test.php.

Si ves "Conexión exitosa", el problema está en la configuración de PrestaShop.
Si ves un error de conexión, el problema está en las credenciales o el servidor MySQL.

[WARNING]: Elimina este archivo de prueba después de usarlo. Dejarlo en el servidor es un riesgo de seguridad.

Paso 5: Revisa los permisos del usuario de la base de datos

Un error db prestashop también puede deberse a que el usuario de MySQL no tiene permisos suficientes.

¿Qué permisos necesita?

El usuario debe tener al menos estos privilegios sobre la base de datos:

SELECT
INSERT
UPDATE
DELETE
CREATE
ALTER
INDEX
DROP
REFERENCES

Cómo cambiarlos:

En Syspanel (puerto 2106): Bases de datos → Selecciona tu base → Usuarios → Editar privilegios.
En cPanel: Bases de datos MySQL → Selecciona el usuario → Marca "TODOS LOS PRIVILEGIOS".
Aplica los cambios y prueba de nuevo.

Paso 6: Revisa el límite de conexiones

Si tu tienda recibe mucho tráfico, puede que alcances el límite de conexiones simultáneas a MySQL. Esto genera el error de conexión de forma intermitente.

Soluciones:

Aumenta el límite: Si tu plan de hosting lo permite, sube el valor de max_connections en MySQL.
Optimiza PrestaShop: Activa la caché, usa un plugin de caché y considera un CDN.
Contacta con tu hosting: Si estás en un plan compartido, puede que necesites mejorar a un VPS o servidor dedicado.

Paso 7: Restaura una copia de seguridad

Si has hecho cambios recientes y nada funciona, restaurar una copia de seguridad puede ser la solución más rápida.

Antes de restaurar:

Haz una copia de tu settings.inc.php actual.
Descarga una copia de seguridad reciente de tu base de datos.

Pasos:

Restaura la base de datos desde tu panel de hosting.
Si el archivo settings.inc.php estaba corrupto, reemplázalo con una versión anterior que funcionara.
Prueba tu tienda.

[TIP]: Siempre mantén al menos dos copias de seguridad: una en el servidor y otra en tu ordenador o en la nube.

Paso 8: Reinstala el archivo settings.inc.php

Si el archivo está tan dañado que no puedes repararlo, puedes regenerarlo:

Descarga una copia limpia de PrestaShop de la misma versión que tienes instalada.
Extrae el archivo settings.inc.php de la carpeta config.
Edítalo con tus credenciales de base de datos.
Sube el archivo al servidor reemplazando el existente.

[WARNING]: Asegúrate de que la versión de PrestaShop coincida exactamente. Usar un archivo de otra versión puede causar errores adicionales.

Paso 9: Comprueba el archivo .htaccess

A veces, un archivo .htaccess corrupto puede interferir con la conexión. Aunque es menos común, vale la pena revisarlo:

Renombra el archivo .htaccess a .htaccess.bak.
Recarga tu tienda. PrestaShop generará uno nuevo automáticamente.
Si funciona, el problema estaba en ese archivo.

Paso 10: Contacta con soporte técnico

Si has probado todo esto y el error base datos prestashop persiste, es hora de pedir ayuda profesional.

Información que debes tener lista:

Captura de pantalla del error.
Versión de PrestaShop (la encuentras en el panel de administración).
Versión de PHP y MySQL de tu hosting.
Cambios recientes que hayas hecho.
Resultados de las pruebas que ya realizaste.

[INFO]: Si tu hosting usa Syspanel, recuerda que el puerto de acceso es el 2106. Menciona esto al soporte para que sepan a qué panel te refieres.

Preguntas frecuentes (FAQ)

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

Depende de la causa. Si es solo una contraseña incorrecta, puedes resolverlo en 5 minutos. Si es un problema del servidor, puede tardar más.

¿Perderé mis datos si restauro una copia de seguridad?

Solo perderás los cambios realizados después de esa copia. Por eso es importante tener copias recientes.

¿Puedo evitar este error en el futuro?

Sí: mantén tus copias de seguridad al día, actualiza PrestaShop regularmente y guarda siempre las credenciales de tu base de datos en un lugar seguro.

¿Qué hago si no tengo acceso al panel de hosting?

Contacta con tu proveedor de hosting. Ellos pueden verificar la conexión y reparar el problema por ti.

¿El error puede ser un ataque de hackers?

Es posible, aunque no es lo más común. Si sospechas de un ataque, cambia todas tus contraseñas y revisa los logs de acceso.

Conclusión

El error "Erreur de connexion à la base de données" en PrestaShop puede parecer aterrador, pero en la mayoría de los casos es un problema menor que puedes resolver siguiendo estos pasos.

Recuerda que la clave está en:

Verificar las credenciales en settings.inc.php.
Comprobar que MySQL está activo.
Revisar permisos y límites.
Restaurar copias de seguridad si es necesario.

Y si todo falla, no dudes en contactar con soporte técnico. Es mejor pedir ayuda a tiempo que perder horas intentando adivinar el problema.

Esperamos que esta guía te haya sido útil. ¡Tu tienda volverá a estar operativa en poco tiempo!