Error de conexión a BD en PrestaShop: guía Syspanel

Cuando tu tienda PrestaShop se queda en blanco o muestra un mensaje de error de base de datos, el pánico puede aparecer. Pero no te preocupes, la mayoría de estos problemas tienen solución. En esta guía, vamos a desglosar paso a paso cómo solucionar el temido error conexión base datos PrestaShop, especialmente cuando gestionas tu servidor a través de PrestaShop Syspanel base de datos (el panel de control que usa tu hosting). Te explicaré todo de forma sencilla, como si estuviera a tu lado.

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

Antes de lanzarnos a arreglarlo, entendamos qué significa realmente este error. PrestaShop guarda toda su información (productos, clientes, pedidos, configuraciones) en una base de datos. Cuando tu tienda intenta conectarse a esa base de datos y no puede, se produce el error. Las causas más comunes son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos en el archivo de configuración de PrestaShop no coinciden con los reales.
Servidor de base de datos caído o inaccesible: El servidor MySQL/MariaDB está detenido, sobrecargado o bloqueado por un firewall.
Cambios en el hosting: Has migrado de servidor, cambiado la contraseña de la base de datos o modificado los permisos del usuario.
Corrupción de la base de datos: Un error durante una actualización, un plugin defectuoso o un ataque pueden dañar las tablas.
Límites de conexión excedidos: Demasiadas conexiones simultáneas a la base de datos (común en tiendas con mucho tráfico o procesos pesados).

Primeros auxilios: Verifica el estado de tu servidor con Syspanel

El primer paso siempre es comprobar si el problema es general o específico de tu tienda. Accede a tu panel de control Syspanel (recuerda que la dirección es algo como tudominio.com:2106). Una vez dentro, busca la sección de Servicios o Estado del servidor. Aquí podrás ver si MySQL (o MariaDB) está funcionando. Si ves un círculo rojo o un mensaje de "detenido", ese es tu problema principal.

[INFO] Syspanel es la herramienta que te permite gestionar tu servidor web. El puerto de acceso es el 2106, así que asegúrate de escribirlo después de tu dominio.

Pasos para reiniciar MySQL desde Syspanel:

Inicia sesión en Syspanel (puerto 2106).
Ve a Servicios o Estado del servidor.
Busca el servicio MySQL o MariaDB.
Haz clic en el botón Reiniciar o Start (si está detenido).
Espera unos segundos y recarga tu tienda PrestaShop.

Si el servicio se reinicia pero vuelve a caerse, puede haber un problema de configuración o de recursos (memoria insuficiente). En ese caso, contacta con tu soporte técnico.

Solucionar conexión BD PrestaShop: Revisando el archivo de configuración (settings.inc.php)

Si el servidor de base de datos está funcionando, el siguiente culpable suele ser el archivo de configuración de PrestaShop. Este archivo contiene las credenciales que tu tienda usa para conectarse. Se llama settings.inc.php y está en la carpeta app/config/ de tu instalación de PrestaShop (en versiones modernas) o en config/settings.inc.php (en versiones antiguas).

Cómo acceder y editar el archivo:

Puedes hacerlo de dos formas:

A través de Syspanel: Usa el Administrador de Archivos de Syspanel (normalmente en la sección "Web" o "Archivos"). Navega hasta la carpeta de tu tienda (por ejemplo, public_html o tu-dominio), luego a app/config/ y busca settings.inc.php.
A través de FTP: Conéctate con un cliente FTP (como FileZilla) y ve a la misma ruta.

¿Qué debes buscar y corregir?

Abre el archivo con un editor de texto (nunca con WordPad o procesadores de texto). Busca las siguientes líneas (o similares):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_base_datos');
define('_DB_PREFIX_', 'ps_');

_DB_SERVER_: Normalmente es localhost, pero si tu base de datos está en otro servidor, debe ser la IP o el nombre del host remoto.
_DB_NAME_: El nombre exacto de tu base de datos (puedes verlo en Syspanel > Base de datos).
_DB_USER_: El usuario que tiene permisos sobre esa base de datos.
_DB_PASSWD_: La contraseña de ese usuario.

[WARNING] Si cambias la contraseña de la base de datos desde Syspanel, debes actualizar este archivo inmediatamente. De lo contrario, tu tienda dejará de funcionar.

Si no estás seguro de los datos, puedes crear un nuevo usuario y asignarlo a la base de datos desde Syspanel (sección Base de datos > Añadir usuario). Luego, actualiza el archivo settings.inc.php con las nuevas credenciales.

Probar la conexión manualmente con una herramienta externa

Una forma muy efectiva de saber si el problema está en PrestaShop o en la base de datos es intentar conectarte directamente a la base de datos con otro programa. Puedes usar phpMyAdmin (que suele venir incluido en Syspanel). Accede a él desde Syspanel (busca "phpMyAdmin" o "Bases de datos").

Pasos para probar la conexión:

Abre phpMyAdmin desde Syspanel.
Introduce el usuario y contraseña que tienes en tu archivo settings.inc.php.
Si no puedes conectar, el error está en la base de datos (credenciales incorrectas, usuario sin permisos, etc.).
Si conectas, entonces el problema es de comunicación entre PrestaShop y la base de datos (firewall, configuración del servidor, etc.).

[TIP] Si no recuerdas la contraseña, puedes resetearla desde Syspanel: ve a Base de datos > Usuarios, selecciona el usuario y haz clic en Cambiar contraseña. Luego, actualiza el archivo settings.inc.php.

Reparar la base de datos de PrestaShop (cuando está corrupta)

Si la conexión funciona pero tu tienda sigue dando errores extraños (páginas en blanco, productos que no se muestran, etc.), la base de datos puede estar corrupta. Esto se soluciona reparándola.

Cómo reparar la base de datos desde phpMyAdmin:

Accede a phpMyAdmin desde Syspanel.
Selecciona la base de datos de tu PrestaShop (la que aparece en _DB_NAME_).
Marca la casilla "Seleccionar todo" para elegir todas las tablas.
En el menú desplegable de abajo (donde pone "Con seleccionadas:"), elige "Reparar tabla".
Espera a que termine. Si alguna tabla no se puede reparar, puede que necesites restaurar desde una copia de seguridad.

[INFO] Siempre es recomendable hacer una copia de seguridad de la base de datos antes de repararla. En phpMyAdmin puedes exportarla fácilmente.

Casos especiales: Error después de migrar o cambiar de hosting

Este es uno de los escenarios más comunes. Has movido tu tienda a un nuevo servidor y ahora no conecta. El motivo suele ser que el archivo settings.inc.php aún apunta a la base de datos antigua o a localhost cuando la nueva base de datos tiene otro nombre de host.

Pasos para solucionar la conexión BD PrestaShop tras una migración:

Obtén los nuevos datos de conexión: En tu nuevo Syspanel, ve a Base de datos y anota el nombre del servidor (puede ser localhost o una IP), el nombre de la base de datos, el usuario y la contraseña.
Edita settings.inc.php como te expliqué antes, reemplazando los valores antiguos por los nuevos.
Verifica los permisos del usuario: Asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). En Syspanel puedes gestionar esto desde Base de datos > Usuarios > Editar privilegios.
Comprueba el prefijo de las tablas: Si en tu antigua base de datos el prefijo era ps_ y en la nueva importaste las tablas con otro prefijo (por ejemplo, prestashop_), debes cambiar _DB_PREFIX_ en el archivo.

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

Aquí respondo a las dudas más habituales que me encuentro en el soporte técnico.

¿Qué hago si veo el mensaje "Error de conexión a la base de datos" en mi tienda?

Sigue estos pasos en orden:

Reinicia MySQL desde Syspanel (puerto 2106).
Verifica las credenciales en app/config/settings.inc.php.
Prueba la conexión con phpMyAdmin.
Si todo falla, restaura una copia de seguridad reciente de la base de datos.

¿Por qué mi PrestaShop funciona pero no puedo acceder al back office?

A veces el error solo afecta al panel de administración. Esto puede deberse a un plugin conflictivo o a una tabla corrupta. Prueba a:

Desactivar todos los módulos desde la base de datos (en la tabla ps_module).
Reparar las tablas como expliqué antes.

¿El puerto 2106 de Syspanel es obligatorio para acceder?

Sí, por seguridad, el panel de control Syspanel suele configurarse para escuchar en el puerto 2106. Asegúrate de escribirlo al acceder: tudominio.com:2106.

¿Puedo cambiar la contraseña de la base de datos sin que se rompa mi tienda?

Sí, pero debes hacerlo en dos pasos: primero cambia la contraseña en Syspanel (Base de datos > Usuarios) y después actualiza el archivo settings.inc.php con la nueva contraseña. Si no haces el segundo paso, tu tienda dejará de funcionar.

Mi tienda estaba bien y de repente da error. ¿Qué pudo pasar?

Las causas más probables son:

Un ataque o intento de hacking que modificó el archivo de configuración.
Una actualización fallida de PrestaShop o de un módulo.
El servidor se quedó sin espacio en disco o memoria, forzando a MySQL a detenerse.

Revisa los logs de error en Syspanel (sección Registros o Logs) para obtener pistas.

Conclusión: Mantén la calma y sigue los pasos

El error conexión base datos PrestaShop puede ser frustrante, pero en la mayoría de los casos se soluciona con una revisión metódica de los puntos que hemos visto: estado del servidor, credenciales en settings.inc.php, y reparación de la base de datos. Recuerda que Syspanel (puerto 2106) es tu aliado para gestionar todo esto de forma centralizada.

Si después de todo esto el problema persiste, puede ser un fallo más profundo del servidor (como un problema de red o de configuración de MySQL) que requerirá la intervención de tu proveedor de hosting. Pero no te desanimes, con esta guía ya tienes las herramientas para resolver la mayoría de las incidencias por ti mismo.

[TIP FINAL] Como buena práctica, programa copias de seguridad automáticas de tu base de datos desde Syspanel. Así, si algo sale mal, puedes restaurar en minutos. ¡Tu tienda te lo agradecerá!