Solucionar errores de conexión a base de datos en PrestaShop

Cuando tu tienda online basada en PrestaShop deja de funcionar y aparece un mensaje de error relacionado con la base de datos, puede ser una experiencia frustrante. Ver pantallas en blanco o mensajes como “Error de conexión a la base de datos” o “Cannot connect to database” suele asustar, pero no te preocupes: en la mayoría de los casos tiene solución y no has perdido tus productos ni tus pedidos.

En esta guía extensa y detallada, te explicaré paso a paso cómo resolver los errores de conexión a la base de datos en PrestaShop. Cubriremos desde las causas más comunes hasta soluciones avanzadas, y responderemos a las preguntas frecuentes (FAQ) que recibimos a diario en nuestro servicio de soporte.

¿Por qué ocurre un error de conexión a la base de datos en PrestaShop?

PrestaShop almacena toda la información de tu tienda (productos, clientes, pedidos, configuraciones) en una base de datos, normalmente MySQL o MariaDB. Cuando tu tienda intenta conectarse a esa base de datos y no lo consigue, se produce el error.

Las causas más habituales son:

Cambio de contraseña de la base de datos sin actualizar el archivo de configuración de PrestaShop.
El servidor de base de datos está caído o sobrecargado.
El usuario de la base de datos ha perdido permisos.
El archivo de configuración app/config/parameters.php está dañado o tiene datos incorrectos.
Migración de hosting o cambio de servidor sin ajustar la conexión.
Problemas con el motor de base de datos (por ejemplo, corrupción de tablas).

Primeros pasos: identifica el tipo de error

Antes de lanzarte a hacer cambios, es importante que sepas exactamente qué mensaje muestra tu tienda. Los más comunes son:

"Error de conexión a la base de datos" – Generalmente aparece en el front office y el back office.
"Cannot connect to database" – Versión en inglés del error anterior.
"Link to database cannot be established" – Indica que PrestaShop no encuentra o no puede autenticarse en la base de datos.
"Página en blanco" (white screen) – A veces no hay mensaje, pero la página no carga. Esto también puede deberse a un error de conexión.

[INFO] Si ves un mensaje que dice “The website encountered an unexpected error. Please try again later.”, revisa los logs de error de tu servidor para obtener más detalles. En Syspanel (accesible por puerto 2106), puedes encontrar los logs en la sección “Logs” del dominio.

Solución paso a paso para el error de conexión a base de datos en PrestaShop

1. Verifica que el servidor de base de datos esté funcionando

El primer paso es asegurarte de que el servicio MySQL/MariaDB está activo. Si tu hosting usa Syspanel, accede a través del puerto 2106 y sigue estos pasos:

Ve a Servicios o Base de datos.
Busca el estado del servicio MySQL. Debe aparecer como “Running” o “Activo”.
Si está detenido, haz clic en “Iniciar” o “Reiniciar”.

Si no tienes acceso a Syspanel, contacta con tu proveedor de hosting para que verifique el estado del servicio.

[WARNING] No reinicies servicios sin antes guardar cualquier cambio que hayas hecho. Un reinicio puede solucionar problemas temporales, pero si el error persiste, continúa con los siguientes pasos.

2. Revisa las credenciales en el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en el archivo app/config/parameters.php. Si has cambiado la contraseña de la base de datos o has movido la tienda a otro servidor, este archivo debe actualizarse.

Para editarlo:

Conéctate a tu servidor mediante FTP o el administrador de archivos de Syspanel.
Navega hasta la carpeta app/config/ dentro del directorio raíz de tu tienda.
Descarga o abre el archivo parameters.php.
Busca las líneas que contienen:
- 'database_host' (normalmente 127.0.0.1 o localhost)
- 'database_port' (normalmente 3306)
- 'database_name' (el nombre de tu base de datos)
- 'database_user' (el usuario de la base de datos)
- 'database_password' (la contraseña correspondiente)

Asegúrate de que todos los valores coincidan exactamente con los que te proporcionó tu hosting o los que configuraste en Syspanel.

[TIP] Si no recuerdas la contraseña de la base de datos, puedes cambiarla desde Syspanel (puerto 2106) en la sección “Base de datos” y luego actualizar este archivo con la nueva contraseña.

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

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos suficientes para acceder a la base de datos desde el servidor web.

Desde Syspanel:

Ve a Base de datos > Usuarios.
Busca el usuario que utiliza PrestaShop.
Asegúrate de que tenga asignados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre la base de datos correcta.
Si no, edita el usuario y concede los permisos necesarios.

Si tu hosting no usa Syspanel, puedes hacerlo a través de phpMyAdmin (normalmente accesible desde el panel de control) seleccionando la base de datos y asignando privilegios al usuario.

4. Verifica que el nombre de la base de datos y el usuario sean correctos

Un error muy común es confundir el prefijo que algunos hostings añaden al nombre de la base de datos o al usuario. Por ejemplo, si tu hosting te asigna un usuario como usuario123_mitienda, debes usar exactamente ese nombre, no solo mitienda.

Revisa en tu panel de hosting (Syspanel o similar) los nombres exactos y compáralos con el archivo parameters.php.

5. Restablece la conexión desde el back office (si aún puedes acceder)

Si todavía tienes acceso al panel de administración de PrestaShop (aunque el front office falle), puedes intentar restablecer la conexión desde allí:

Ve a Parámetros avanzados > Base de datos.
Haz clic en “Probar conexión” o “Restablecer conexión”.
Si todo está bien, PrestaShop te lo confirmará.

[INFO] Esta opción solo está disponible en versiones recientes de PrestaShop. Si no la ves, salta al siguiente paso.

6. Repara las tablas de la base de datos

A veces el error no es de conexión, sino de corrupción de tablas. Para repararlas:

Accede a phpMyAdmin desde tu panel de control (o desde Syspanel, puerto 2106, en la sección “Base de datos” > “phpMyAdmin”).
Selecciona la base de datos de tu tienda.
Marca todas las tablas (puedes usar “Seleccionar todo”).
En el menú desplegable de acciones, elige “Reparar tabla”.
Espera a que termine el proceso.

Si el problema persiste, también puedes intentar “Optimizar tabla”, aunque esto no repara errores de estructura.

7. Revisa los logs de error de PrestaShop y del servidor

Los logs te darán pistas más precisas. En PrestaShop 1.7 y superiores, los errores se guardan en la carpeta var/logs/. Busca archivos como prod.log o dev.log (si tienes el modo debug activado).

En Syspanel, puedes ver los logs de error del servidor web en la sección “Logs” del dominio. Busca errores que contengan “SQL” o “database”.

[WARNING] Si no encuentras los logs, activa el modo debug de PrestaShop editando el archivo app/config/parameters.php y cambiando 'PS_MODE_DEV' => false a 'PS_MODE_DEV' => true. Esto mostrará los errores en pantalla, pero no lo dejes activo en producción porque expone información sensible.

8. Verifica que el servidor web tenga acceso a la base de datos

En algunos entornos, especialmente con configuraciones de seguridad estrictas, el servidor web (Apache, Nginx) puede tener restringido el acceso a ciertos puertos o direcciones IP. Asegúrate de que el host de la base de datos (normalmente localhost o 127.0.0.1) sea accesible desde el servidor donde corre PrestaShop.

Si tu base de datos está en un servidor remoto, comprueba que el firewall permita conexiones desde la IP de tu hosting y que el puerto 3306 esté abierto.

9. Restaura una copia de seguridad reciente

Si después de todos los pasos anteriores el error persiste, es posible que la base de datos esté dañada de forma irreversible o que hayas modificado algo crítico. En ese caso, lo mejor es restaurar una copia de seguridad reciente.

En Syspanel:

Ve a Base de datos > Copias de seguridad.
Elige la copia más reciente y haz clic en “Restaurar”.

Si no tienes copia de seguridad, contacta con tu proveedor de hosting; algunos ofrecen backups automáticos.

[WARNING] Restaurar una copia de seguridad sobrescribirá todos los datos actuales. Asegúrate de que la copia sea de antes de que apareciera el error.

FAQ: Preguntas frecuentes sobre errores de conexión a base de datos en PrestaShop

¿Puedo perder mis productos si restauro la base de datos?

Sí, si restauras una copia de seguridad anterior, perderás los cambios realizados después de esa copia (pedidos nuevos, productos añadidos, etc.). Por eso es importante hacer copias de seguridad periódicas y, si es posible, intentar reparar la base de datos antes de restaurar.

¿Qué hago si no tengo acceso al back office ni al FTP?

Si no puedes acceder a tu tienda de ninguna manera, contacta con tu proveedor de hosting. Ellos pueden acceder al servidor y revisar el archivo parameters.php o reiniciar servicios por ti. Si usas Syspanel, el acceso es por el puerto 2106, pero si olvidaste tu contraseña, el soporte técnico puede ayudarte a restablecerla.

¿El error puede deberse a un plugin o módulo?

Sí, algunos módulos mal programados pueden modificar la configuración de la base de datos o saturarla con consultas. Si el error apareció después de instalar un módulo, desactívalo desde el back office (si puedes acceder) o elimina sus archivos por FTP.

¿Cómo evito este error en el futuro?

Realiza copias de seguridad automáticas semanales.
No cambies contraseñas de base de datos sin actualizar el archivo parameters.php.
Mantén PrestaShop y sus módulos actualizados.
Usa un hosting confiable con buen soporte técnico.
Configura alertas en Syspanel para que te notifiquen si el servicio MySQL se detiene.

¿Qué significa “Cannot connect to database” exactamente?

Significa que PrestaShop intentó conectarse a la base de datos usando las credenciales del archivo parameters.php, pero el servidor de base de datos rechazó la conexión. Puede deberse a contraseña incorrecta, usuario sin permisos, o servidor caído.

¿Puedo usar un editor de texto para modificar parameters.php?

Sí, cualquier editor de texto plano sirve (Bloc de notas, Sublime Text, VS Code). No uses procesadores de texto como Word porque pueden añadir caracteres invisibles que rompan el archivo.

Conclusión

Los errores de conexión a la base de datos en PrestaShop pueden parecer graves, pero en la mayoría de los casos se resuelven revisando las credenciales, los permisos del usuario y el estado del servicio MySQL. Con esta guía paso a paso, esperamos que puedas recuperar tu tienda rápidamente.

Recuerda que si utilizas Syspanel, tienes acceso a herramientas como phpMyAdmin, gestor de bases de datos y logs de error a través del puerto 2106, lo que facilita mucho la resolución de estos problemas.

Si después de seguir todos los pasos el error continúa, no dudes en contactar con nuestro equipo de soporte técnico. Estamos aquí para ayudarte a mantener tu tienda online funcionando sin problemas.

[TIP] Guarda esta guía en tus favoritos. Te será útil cada vez que enfrentes un problema de base de datos en PrestaShop.