Fix 'Error de conexión a base de datos' en PrestaShop

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

Cuando visitas tu tienda PrestaShop y ves un mensaje como "No se puede conectar a la base de datos" o el clásico "Error de conexión a la base de datos", no significa que tu tienda haya desaparecido. Lo que está ocurriendo es que tu tienda PrestaShop (el código PHP) no puede comunicarse con el servidor donde están guardados todos tus productos, clientes y pedidos.

Este es uno de los errores más comunes y, afortunadamente, también uno de los más fáciles de solucionar si sigues los pasos adecuados. En esta guía completa, te explicaré desde cero cómo diagnosticar y resolver el error base de datos PrestaShop sin necesidad de ser un experto en programación.

Antes de empezar, es importante que sepas que este error puede aparecer por varias razones: desde una contraseña mal escrita en un archivo de configuración, hasta un ataque informático o un problema con tu proveedor de hosting. Vamos a ir paso a paso, de lo más simple a lo más complejo, para que puedas fix prestashop database de forma segura.

Primeros pasos antes de tocar nada

Cuando aparece el prestashop error db, lo primero que debes hacer es mantener la calma. Tu información sigue en el servidor, no se ha borrado. Lo que falla es el "puente" entre tu tienda y los datos.

1. Comprueba si es un problema general o solo tuyo

Antes de modificar archivos, verifica si el problema es global o solo afecta a tu tienda. Puedes hacer esto de dos formas:

Visita tu tienda desde un dispositivo móvil (con datos móviles, no con tu misma conexión WiFi).
Usa una herramienta externa como "Down for Everyone or Just Me" (https://downforeveryoneorjustme.com/) e introduce tu dominio.

Si la herramienta dice que tu web está caída para todos, entonces el problema es del servidor. Si solo te falla a ti, puede ser un problema de tu conexión o de caché local.

2. Revisa si el panel de administración de tu hosting funciona

Si tu hosting tiene un panel de control (como cPanel, Plesk o Syspanel), intenta acceder a él. Si puedes entrar sin problemas, el servidor está encendido y funcionando. Recuerda que Syspanel (el antiguo HestiaCP) se accede normalmente a través del puerto 2106 (por ejemplo: https://tu-dominio.com:2106).

Si no puedes acceder ni al panel, entonces el problema está en el servidor y deberías contactar con tu proveedor de hosting inmediatamente.

Causa 1: Datos incorrectos en el archivo de configuración (la más común)

La causa más frecuente de este error es que los datos de acceso a la base de datos han cambiado o están mal escritos en el archivo de configuración de PrestaShop.

¿Dónde se guardan estos datos?

PrestaShop guarda la configuración de conexión en el archivo parameters.php, que se encuentra en la carpeta app/config/ de tu instalación.

Para acceder a él necesitas un gestor de archivos (desde el panel de tu hosting) o un cliente FTP como FileZilla. Los datos que debes revisar son:

database_host: La dirección del servidor de base de datos (normalmente localhost o 127.0.0.1, aunque algunos hostings usan direcciones específicas).
database_name: El nombre exacto de tu base de datos.
database_user: El usuario con permisos para acceder a esa base de datos.
database_password: La contraseña de ese usuario.

Cómo corregirlo paso a paso

Accede a tu hosting y abre el gestor de archivos.
Navega hasta app/config/ y busca parameters.php.
Descarga una copia de seguridad de este archivo (nunca lo modifiques directamente en el servidor sin respaldo).
Ábrelo con un editor de texto plano (como el Bloc de notas o Notepad++).
Busca las líneas que empiezan por 'database_' y verifica que los valores coinciden con los datos de tu base de datos.

[WARNING] Ten mucho cuidado al editar este archivo. Un solo carácter mal puesto (una coma, una comilla) puede romper toda la tienda. Si tienes dudas, haz una copia de seguridad antes de guardar.

¿No sabes cuáles son los datos correctos? Puedes encontrarlos en el panel de tu hosting, en la sección de "Bases de datos MySQL". Si usas Syspanel, entra por el puerto 2106, ve a "Bases de datos" y ahí verás el nombre de la BD, el usuario y podrás cambiar la contraseña.

Causa 2: La base de datos está llena o corrupta

Otra razón muy habitual es que la base de datos haya alcanzado su límite de tamaño o que esté dañada. Esto pasa sobre todo en hostings compartidos donde el espacio es limitado.

Síntomas típicos

El error aparece después de intentar hacer una copia de seguridad.
La tienda funciona a ratos y luego da el error.
Recibes un correo de tu hosting avisando de que la BD está llena.

Solución paso a paso

Accede a tu panel de control (cPanel, Plesk o Syspanel por el puerto 2106).
Busca la sección de "Bases de datos" o "MySQL".
Comprueba el tamaño de tu base de datos. Si está al 100%, tendrás que optimizarla o ampliar el espacio con tu proveedor.

Para optimizarla puedes usar la herramienta phpMyAdmin:

Entra en phpMyAdmin desde tu panel.
Selecciona tu base de datos.
En la pestaña "Operaciones" o "Operations", busca la opción "Optimizar tablas".
También puedes vaciar las tablas de caché (prefijo ps_ seguido de cache o log), pero ten cuidado de no borrar datos importantes.

[TIP] Si no te atreves a tocar nada en phpMyAdmin, contacta con tu soporte técnico. Es una tarea sencilla para ellos y no deberían cobrarte por ello.

Causa 3: El servidor de base de datos está caído

A veces el problema no es tuyo, sino del servidor donde se aloja la base de datos. Esto es especialmente común en hostings compartidos donde otros clientes pueden sobrecargar el sistema.

Cómo comprobarlo

Revisa el correo electrónico asociado a tu cuenta de hosting. Muchas veces el proveedor envía avisos de mantenimiento o incidencias.
Entra en tu panel de control. Si puedes ver el estado de los servicios, busca el de "MySQL" o "MariaDB".
Si en Syspanel (puerto 2106) ves que el servicio de base de datos aparece en rojo o detenido, puedes intentar reiniciarlo desde el panel.

Qué hacer si el servidor está caído

Espera unos minutos y vuelve a intentarlo. A veces es un reinicio automático.
Si pasa más de 30 minutos, contacta con tu proveedor de hosting por teléfono o ticket.
Pregunta si hay algún problema generalizado en sus servidores.

Causa 4: Problemas con los permisos de la base de datos

Es posible que el usuario de la base de datos haya perdido los permisos necesarios. Esto puede pasar después de una migración, una restauración o un cambio de contraseña.

Solución en phpMyAdmin o desde el panel

Entra en tu panel de control y accede a la gestión de bases de datos.
Busca la opción de "Usuarios de la base de datos" o "Privilegios".
Asegúrate de que el usuario que usa PrestaShop tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc.) sobre la base de datos.

Si usas Syspanel (recuerda, puerto 2106), ve a la sección de bases de datos, selecciona tu base y revisa los usuarios asociados. Asegúrate de que están marcadas las casillas de todos los permisos.

[WARNING] No elimines ni cambies el nombre del usuario de la base de datos. Si lo haces, tendrás que actualizar también el archivo parameters.php y podrías liarlo más.

Causa 5: Archivos de PrestaShop corruptos o incompletos

A veces el problema no está en la base de datos, sino en los archivos de PrestaShop que se encargan de conectarse a ella. Esto puede ocurrir después de una actualización fallida o de un ataque.

Solución: Reemplazar los archivos de configuración

Descarga una copia limpia de PrestaShop desde la web oficial (la misma versión que tienes instalada).
Descomprime el archivo en tu ordenador.
Sube por FTP solo la carpeta app/config/ y la carpeta src/Adapter/Database.php (si existe en tu versión), reemplazando los archivos existentes.

[INFO] No subas todos los archivos de la instalación limpia, solo los de configuración. Si subes todo, podrías perder tus ajustes personalizados y sobreescribir archivos importantes.

Después de reemplazarlos, vuelve a intentar acceder a tu tienda. Si el problema era un archivo corrupto, se solucionará.

Causa 6: El host de la base de datos no es localhost

Muchos hostings modernos no usan localhost como dirección de la base de datos. En su lugar, usan una dirección como mysql.tudominio.com o una IP específica. Si tu hosting ha cambiado esta dirección, PrestaShop no podrá conectar.

Cómo encontrar la dirección correcta

Entra en el panel de tu hosting.
Busca la sección de "Bases de datos MySQL".
Ahí aparecerá el "Host" o "Servidor" de la base de datos. Normalmente es algo como localhost o una URL del tipo db.tudominio.com.

Si ves que el host es diferente al que tienes en parameters.php, cámbialo y guarda el archivo.

Causa 7: Ataques o malware

Los ataques informáticos pueden modificar el archivo parameters.php o incluso borrar la base de datos. Si has descartado todas las causas anteriores, es posible que tu tienda haya sido hackeada.

Señales de que has sido atacado

El error apareció de repente sin que hayas tocado nada.
Hay archivos extraños en tu servidor (como .php que no reconoces).
Tu web muestra contenido raro o redirige a otras páginas.

Qué hacer en este caso

Contacta inmediatamente con tu proveedor de hosting.
Restaura tu tienda desde una copia de seguridad anterior al ataque.
Cambia todas las contraseñas (de FTP, base de datos, panel de control y administración de PrestaShop).

[WARNING] Si sospechas de un ataque, no intentes arreglarlo solo. Un atacante podría dejar puertas traseras y volver a entrar. Mejor que lo revise un profesional.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si intento arreglar este error?

No, siempre que no borres la base de datos. Los datos están en el servidor y no se pierden al editar archivos de configuración. Eso sí, haz una copia de seguridad antes de tocar nada.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Si es un problema de contraseña, en 5 minutos lo tienes. Si es una base de datos corrupta, puede llevar una hora o más. En la mayoría de los casos, no debería llevarte más de 30 minutos.

¿Necesito conocimientos técnicos avanzados?

No. Solo necesitas saber usar un editor de texto y un panel de hosting. Si sigues esta guía paso a paso, podrás resolver el error base de datos PrestaShop sin ayuda.

¿Qué hago si después de todo sigue fallando?

Si has probado todas las soluciones anteriores y el error persiste, contacta con tu proveedor de hosting. A veces el problema está en su infraestructura y solo ellos pueden solucionarlo.

Resumen y consejos finales

El error "No se puede conectar a la base de datos" en PrestaShop es uno de los más frecuentes, pero también uno de los más fáciles de resolver. Siguiendo estos pasos en orden, podrás solucionarlo en la mayoría de los casos:

Revisa los datos de conexión en app/config/parameters.php.
Verifica el estado de la base de datos desde tu panel de control.
Comprueba los permisos del usuario de la BD.
Optimiza la base de datos si está llena.
Reemplaza archivos de configuración si están corruptos.
Contacta con tu hosting si todo lo demás falla.

[TIP] Para evitar futuros problemas, te recomiendo hacer copias de seguridad automáticas de tu base de datos y de los archivos de configuración. Así, si el error vuelve a aparecer, podrás restaurar en cuestión de minutos.

Recuerda que si tu hosting utiliza Syspanel (el antiguo HestiaCP), siempre podrás acceder a la gestión de bases de datos a través del puerto 2106. Y si tienes cualquier duda, no dudes en dejar un comentario o contactar con el soporte técnico de tu proveedor.

Espero que esta guía te haya sido de ayuda. ¡Tu tienda volverá a estar operativa en muy poco tiempo!