Error de conexión a base de datos en PrestaShop: causas y soluciones

¿Qué significa el error "No se puede conectar con la base de datos" en PrestaShop?

Cuando visitas tu tienda online y te encuentras con el mensaje "No se puede conectar con la base de datos" (o en inglés "Error connecting to the database"), significa que PrestaShop no logra comunicarse con el servidor MySQL donde se almacenan tus productos, pedidos, clientes y configuraciones.

Este es uno de los errores más comunes en PrestaShop, y puede aparecer tanto en la parte pública de la tienda como en el panel de administración. La buena noticia es que, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

En esta guía completa te explicaré paso a paso cómo diagnosticar y solucionar el error de conexión BD de PrestaShop, desde las causas más habituales hasta las soluciones más avanzadas. Vamos a ello.

¿Por qué ocurre este error de conexión a la base de datos?

Antes de lanzarnos a solucionar el problema, es importante entender qué lo causa. El error base de datos PrestaShop suele deberse a uno de estos motivos:

Credenciales incorrectas en el archivo de configuración parameters.php.
El servidor MySQL está caído o no responde.
El nombre de la base de datos ha cambiado o fue eliminada.
El usuario de la base de datos no tiene permisos suficientes.
El servidor de hosting ha cambiado la dirección del servidor MySQL.
El archivo de configuración se ha corrompido o tiene permisos incorrectos.
Hay un problema de caché o de sesiones antiguas.
La tabla de la base de datos está dañada o bloqueada.

Vamos a revisar cada una de estas causas y te mostraré cómo solucionarlas una por una.

Paso 1: Identifica el tipo de error exacto

Cuando PrestaShop no conecta con la base de datos, puede mostrar diferentes variantes del mensaje:

"No se puede conectar con la base de datos"
"Error connecting to the database"
"Link to database cannot be established"
"The requested database does not exist"

Es importante que te fijes en el mensaje exacto porque te dará pistas sobre el origen del problema. Por ejemplo, si dice que la base de datos no existe, el problema está en el nombre de la BD. Si dice que el acceso es denegado, el problema está en las credenciales.

Paso 2: Revisa el archivo de configuración parameters.php

La configuración de conexión BD de PrestaShop se encuentra en el archivo parameters.php, que está ubicado en la carpeta app/config/ de tu instalación.

Cómo acceder al archivo

Para verlo, necesitas acceder a tu hosting mediante FTP o el administrador de archivos de tu panel de control. Si usas Syspanel, recuerda que el acceso se realiza a través del puerto 2106 desde tu navegador.

Qué debes revisar

Abre el archivo parameters.php y busca las siguientes líneas:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Comprueba que:

database_host sea correcto (normalmente localhost, aunque algunos hostings usan una dirección distinta como mysql.tudominio.com).
database_name coincida exactamente con el nombre de tu base de datos.
database_user sea el usuario correcto.
database_password sea la contraseña correcta.

[TIP] Si no estás seguro de cuáles son tus credenciales, consulta el panel de control de tu hosting o contacta con tu proveedor. En Syspanel (puerto 2106), puedes encontrar esta información en la sección de bases de datos MySQL.

Paso 3: Verifica que el servidor MySQL esté activo

A veces el problema no está en tu configuración, sino en el propio servidor de base de datos. Puedes comprobarlo de la siguiente manera:

Desde el panel de hosting

Si usas Syspanel (acceso por el puerto 2106), ve a la sección de Bases de datos y verifica que el servicio MySQL esté activo. Si está detenido, actívalo.

Desde phpMyAdmin

Intenta acceder a phpMyAdmin desde tu panel de control. Si puedes entrar correctamente, el servidor MySQL está funcionando. Si no puedes, el problema es del servidor y deberías contactar con tu proveedor de hosting.

[WARNING] Si no puedes acceder a phpMyAdmin y tu tienda está caída, es posible que el servidor MySQL haya colapsado por sobrecarga o por un ataque. En ese caso, contacta con tu soporte técnico de inmediato.

Paso 4: Comprueba los permisos del usuario de la base de datos

Aunque las credenciales sean correctas, el usuario de la base de datos podría no tener los permisos necesarios para conectarse desde el servidor donde está alojada tu tienda.

Cómo verificar los permisos

Entra en phpMyAdmin.
Selecciona tu base de datos.
Ve a la pestaña Privilegios (o "Privileges").
Asegúrate de que tu usuario tiene TODOS LOS PRIVILEGIOS sobre esa base de datos.

Si el usuario no tiene permisos, puedes asignárselos desde la misma interfaz. En Syspanel (puerto 2106), esta opción suele estar en la gestión de usuarios MySQL.

[INFO] Algunos hostings utilizan un usuario diferente para cada base de datos. Asegúrate de que el usuario que tienes en parameters.php es el que está vinculado a esa base de datos concreta.

Paso 5: Soluciona el error "Table doesn't exist" o tablas corruptas

Si el mensaje de error es más específico, como "Table 'ps_shop' doesn't exist", el problema es que alguna tabla de la base de datos se ha corrompido o ha sido eliminada.

Reparar tablas con phpMyAdmin

Entra en phpMyAdmin.
Selecciona tu base de datos.
Marca todas las tablas (puedes usar "Seleccionar todo").
En el menú desplegable, elige Reparar tabla (o "Repair table").

Este proceso puede tardar unos minutos si tienes muchas tablas. Una vez terminado, intenta cargar tu tienda de nuevo.

Si la tabla no existe

Si alguna tabla ha sido eliminada, tendrás que restaurarla desde una copia de seguridad. Si no tienes copia, deberías contactar con tu hosting para intentar recuperarla.

[WARNING] No intentes crear las tablas manualmente a menos que sepas exactamente qué estás haciendo. Podrías dañar aún más tu instalación.

Paso 6: Limpia la caché y las sesiones

A veces, PrestaShop guarda en caché datos de conexión antiguos que ya no son válidos. Esto puede provocar el error de conexión BD aunque la configuración sea correcta.

Cómo limpiar la caché de PrestaShop

Accede a tu hosting por FTP.
Ve a la carpeta var/cache/ (en versiones antiguas era cache/).
Elimina todos los archivos dentro de las carpetas dev y prod.
También puedes borrar la carpeta cache/smarty completa.

Limpiar sesiones en la base de datos

Desde phpMyAdmin, busca una tabla llamada ps_session (el prefijo puede variar). Puedes vaciarla con el comando SQL:

TRUNCATE TABLE ps_session;

[TIP] Si no te sientes cómodo con SQL, simplemente elimina los archivos de sesión desde el panel de administración si puedes acceder a él. En muchos casos, limpiar la caché es suficiente.

Paso 7: Comprueba la configuración del servidor y los puertos

En algunos hostings, el servidor MySQL no escucha en el puerto estándar (3306) o requiere una conexión segura.

Revisa el puerto en parameters.php

Añade o modifica esta línea en tu archivo de configuración:

'database_port' => '3306',

Si tu hosting usa un puerto diferente, deberás cambiarlo. Consulta la documentación de tu proveedor o el panel de Syspanel (puerto 2106) para saber qué puerto usar.

Conexión SSL

Algunos hostings requieren conexión SSL a la base de datos. En ese caso, busca en parameters.php la línea:

'database_ssl' => false,

Y cámbiala a true.

[INFO] Este tipo de configuración avanzada no suele ser necesaria en la mayoría de hostings compartidos. Solo aplícala si tu proveedor te lo indica.

Paso 8: Restaura una copia de seguridad

Si has probado todos los pasos anteriores y el error base de datos PrestaShop persiste, puede que la base de datos esté demasiado dañada como para repararla directamente.

Pasos para restaurar

Accede a phpMyAdmin.
Selecciona tu base de datos.
Ve a la pestaña Importar.
Sube tu archivo de copia de seguridad (suele ser un .sql o .gz).
Confirma la importación y espera a que termine.

Si no tienes una copia reciente, contacta con tu proveedor de hosting. Algunos ofrecen copias de seguridad automáticas que puedes restaurar desde el panel de control.

[WARNING] Restaurar una copia de seguridad sobrescribirá todos los cambios realizados desde que se hizo esa copia. Asegúrate de que es lo que quieres hacer.

Paso 9: Verifica los permisos de archivos y carpetas

Un problema menos conocido pero muy común es que los archivos de configuración tengan permisos incorrectos, impidiendo que PHP los lea correctamente.

Permisos recomendados

Carpeta config/ y app/config/: 755
Archivo parameters.php: 644
Archivo .htaccess: 644

Puedes cambiar estos permisos desde tu cliente FTP o desde el administrador de archivos de Syspanel (puerto 2106).

[TIP] Si después de cambiar los permisos el error persiste, revierte los cambios. Unos permisos demasiado restrictivos también pueden causar problemas.

Paso 10: Prueba con el modo mantenimiento

Si tu tienda está caída y necesitas trabajar en ella sin que los clientes vean el error, activa el modo mantenimiento.

Cómo activarlo sin acceso al panel

Accede por FTP a tu instalación.
Abre el archivo app/config/parameters.php.
Busca la línea:

'PS_SHOP_ENABLE' => 1,

Cámbiala a:

'PS_SHOP_ENABLE' => 0,

Esto mostrará una página de mantenimiento en lugar del error de conexión mientras trabajas en la solución.

[INFO] Recuerda volver a cambiar el valor a 1 cuando hayas solucionado el problema para reactivar tu tienda.

Preguntas frecuentes (FAQ)

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

Significa que tu instalación de PrestaShop no puede establecer una conexión con el servidor MySQL. Esto puede deberse a errores de configuración, problemas del servidor o daños en la base de datos.

¿Puedo solucionar este error sin acceso al panel de administración?

Sí, la mayoría de las soluciones descritas aquí se pueden aplicar mediante FTP y phpMyAdmin, sin necesidad de acceder al panel de administración.

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

Depende de la causa. Si es un problema de credenciales, puede resolverse en 5 minutos. Si es un problema de tablas corruptas, puede llevar 30 minutos o más, especialmente si hay que restaurar una copia de seguridad.

¿Necesito conocimientos técnicos avanzados para solucionarlo?

No necesariamente. Los pasos descritos son accesibles para usuarios con conocimientos básicos de hosting y FTP. Sin embargo, si no te sientes seguro, siempre puedes pedir ayuda a tu proveedor de hosting.

¿Puede este error deberse a un ataque informático?

En algunos casos sí. Los ataques de fuerza bruta o inyección SQL pueden dañar la base de datos. Si sospechas que ha sido un ataque, cambia todas tus contraseñas y refuerza la seguridad de tu tienda.

¿Qué pasa si el problema es del servidor de hosting?

Si el servidor MySQL está caído, no podrás hacer nada desde tu lado. Contacta con tu proveedor de hosting y pregunta si hay algún problema con el servicio.

Conclusión y consejos finales

El error de conexión a la base de datos en PrestaShop puede ser frustrante, pero como has visto, tiene solución en la mayoría de los casos. Lo más importante es ir descartando causas paso a paso:

Revisa las credenciales en parameters.php.
Verifica que el servidor MySQL esté activo.
Comprueba los permisos del usuario.
Repara tablas corruptas desde phpMyAdmin.
Limpia la caché y las sesiones.
Restaura una copia de seguridad si todo lo demás falla.

Para evitar que esto vuelva a ocurrir, te recomiendo:

Realizar copias de seguridad periódicas de tu base de datos.
Mantener PrestaShop y sus módulos siempre actualizados.
Usar contraseñas fuertes y únicas para la base de datos.
Monitorear el estado de tu servidor con herramientas como Syspanel (recuerda, acceso por el puerto 2106).

Si después de seguir todos estos pasos el error base de datos PrestaShop persiste, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso directo a los servidores y podrán diagnosticar si el problema está en su infraestructura.

Espero que esta guía te haya sido de ayuda. Recuerda que, aunque este tipo de errores puede ser abrumador al principio, con paciencia y método siempre se encuentra una solución. ¡Mucha suerte con tu tienda online!