Solucionar error de conexión a la base de datos en PrestaShop (Syspanel)

¿Te ha aparecido el temido mensaje de error conexión base de datos PrestaShop justo cuando intentabas entrar a tu tienda o al panel de administración? No te preocupes, es uno de los sustos más comunes en el mundo del eCommerce, pero también uno de los que tiene solución más directa.

Cuando ves ese aviso en pantalla, tu tienda no carga, y si intentas acceder al back-office, todo se queda en blanco. La causa casi siempre es la misma: PrestaShop no conecta BD, es decir, tu tienda no puede establecer comunicación con el servidor MySQL donde guarda todos sus datos (productos, pedidos, clientes, configuraciones...).

En esta guía extensa y paso a paso, vamos a desglosar cómo solucionar el error de conexión a la base de datos en PrestaShop, especialmente cuando gestionas tu servidor a través del panel de control Syspanel (recuerda, el acceso a Syspanel es a través del puerto 2106). Vamos a ir desde lo más básico hasta lo más técnico, sin necesidad de que seas un experto en programación.

¿Por qué aparece el error "No se puede conectar a la base de datos"?

Antes de lanzarnos a tocar archivos, es fundamental entender qué está fallando. PrestaShop guarda la información de acceso a su base de datos en un archivo llamado parameters.php, que se encuentra en la carpeta app/config/.

Este archivo contiene datos como:

El nombre de la base de datos.
El usuario de MySQL.
La contraseña.
El servidor de la base de datos (normalmente localhost o 127.0.0.1).

Si alguno de estos datos es incorrecto, o si el servidor MySQL está caído o saturado, PrestaShop no conecta BD y muestra el error. Las causas más frecuentes suelen ser:

Cambios de credenciales: Has cambiado la contraseña de tu base de datos desde Syspanel y no has actualizado el archivo de PrestaShop.
Migración de servidor: Te has movido a un hosting nuevo y has olvidado actualizar los parámetros de conexión.
Corrupción del archivo: Una edición manual fallida o un ataque informático pueden dejar el archivo parameters.php dañado.
Servidor MySQL saturado: A veces el problema no es tuyo, sino del servidor. Demasiadas conexiones simultáneas pueden bloquear el acceso.
Espacio en disco lleno: Si el disco duro del servidor está al 100%, MySQL puede negarse a iniciar o a aceptar conexiones.

Vamos a atacar cada uno de estos puntos de forma ordenada.

Paso 1: Verifica el estado del servidor MySQL en Syspanel

[INFO] Este es el primer paso. No tiene sentido tocar archivos si el servidor de base de datos está apagado.

Para ello, necesitas acceder a tu panel de control Syspanel. Abre tu navegador y escribe la dirección de tu servidor seguida del puerto 2106. Por ejemplo: https://tu-dominio.com:2106 o https://tu-ip:2106.

Una vez dentro de Syspanel, sigue estos pasos:

Busca la sección de "Servicios" o "Servidores" en el menú lateral.
Localiza el servicio llamado MySQL o MariaDB (es el motor de base de datos que usa PrestaShop).
Verifica que el estado aparezca como "En ejecución" o "Running" (normalmente en verde).

¿Está detenido o en rojo? Entonces ese es el problema. Haz clic en el botón de "Iniciar" o "Reiniciar" que aparece junto al servicio.

[WARNING] Si el servicio se detiene solo, es señal de que el servidor está quedándose sin memoria RAM o que hay un problema de configuración. Anota este detalle por si el error persiste.

Paso 2: Comprueba las credenciales de acceso a la BD

Si MySQL está activo, el siguiente paso es verificar que los datos que PrestaShop está usando para conectar son los correctos. Para ello, vamos a comparar dos sitios: la base de datos real en Syspanel y el archivo de configuración de PrestaShop.

2.1. Localiza tus credenciales en Syspanel

En Syspanel, ve a la sección de "Base de Datos" o "Bases de datos MySQL".
Verás una lista con tus bases de datos. Busca la que corresponda a tu tienda PrestaShop (suele tener un nombre relacionado con tu dominio o usuario).
Anota el nombre exacto de la base de datos, el usuario asociado y ten a mano la contraseña (si no la recuerdas, puedes cambiarla desde ahí, pero hazlo con cuidado).

2.2. Revisa el archivo de configuración de PrestaShop

Ahora vamos a ver qué es lo que PrestaShop está intentando usar. Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de Syspanel.

Conéctate a tu hosting.
Navega hasta la carpeta raíz donde está instalada tu tienda (normalmente public_html o www).
Entra en la carpeta app.
Dentro de app, entra en la carpeta config.
Busca el archivo llamado parameters.php.
Descárgalo o ábrelo con un editor de texto (como el Bloc de notas o Sublime Text).

Busca las líneas que dicen database_host, database_name, database_user y database_password. Algo parecido a esto:

'database_host' => 'localhost',
'database_name' => 'miusuario_prestashop',
'database_user' => 'miusuario_admin',
'database_password' => 'mipasswordsecreto',

Compara estos datos con los que tienes en Syspanel. ¿Coinciden? Si el nombre de la base de datos o el usuario son diferentes, o si la contraseña ha cambiado, ahí tienes el fallo.

Paso 3: Corrige el archivo `parameters.php` (si es necesario)

Si has detectado que los datos no coinciden, es hora de arreglarlo. Puedes hacerlo de dos maneras:

Opción A: Editar el archivo manualmente (recomendado para usuarios con algo de experiencia)

Edita el archivo parameters.php con un editor de texto.
Cambia los valores de database_name, database_user y database_password por los correctos que has verificado en Syspanel.
IMPORTANTE: No toques el database_host si tu hosting es compartido, normalmente es localhost. Si usas un servidor dedicado o VPS, podría ser una IP. Déjalo como estaba a menos que sepas con certeza que ha cambiado.
Guarda el archivo y súbelo de nuevo a la misma ubicación (app/config/) mediante FTP, sobrescribiendo el anterior.

Opción B: Usar el instalador de PrestaShop (más seguro para novatos)

PrestaShop tiene un mecanismo para arreglar la conexión sin tocar código. Consiste en ejecutar el instalador de nuevo.

Descarga la última versión de PrestaShop desde el sitio oficial.
Descomprime el ZIP en tu ordenador.
Sube la carpeta install (que viene dentro del ZIP) a la raíz de tu hosting, junto a las carpetas app, admin, etc.
Renombra esa carpeta a install si ya existe una, o simplemente súbela.
Ve a tu navegador y escribe tu-dominio.com/install.
Sigue los pasos del asistente. Cuando llegue a la pantalla de "Información de la base de datos", introduce los datos correctos que verificaste en Syspanel.
El instalador detectará que ya hay una tienda instalada y te preguntará si quieres "Actualizar" o "Restaurar la base de datos". Elige la opción de "Actualizar" (no la de restaurar, ya que eso borraría datos).
Al finalizar, borra la carpeta install del servidor por seguridad.

[TIP] Este método es mucho más fiable porque PrestaShop reescribe el archivo parameters.php con la estructura correcta y verifica que todo funcione antes de terminar.

Paso 4: Revisa los permisos de los archivos y carpetas

A veces, el error no es de credenciales, sino de permisos. Si los archivos de PrestaShop no tienen los permisos adecuados, el sistema no puede leer la configuración.

En tu cliente FTP, haz clic derecho sobre la carpeta app y selecciona "Permisos de archivo" o "Atributos".
Asegúrate de que los permisos sean 755 para las carpetas y 644 para los archivos.
Aplica estos permisos de forma recursiva (a todas las subcarpetas y archivos).

[WARNING] No pongas permisos 777 en todo. Eso es un agujero de seguridad enorme. Úsalo solo de forma temporal para probar y luego vuelve a 755/644.

Paso 5: Verifica el espacio en disco y la memoria del servidor

Si has llegado hasta aquí y sigues con el problema, puede que el servidor esté al límite de sus recursos. Esto es muy común en hosting compartidos.

Espacio en disco:

Entra en Syspanel y busca la sección de "Estadísticas" o "Uso de disco".
Si el disco está al 90% o más, MySQL puede estar fallando.
Libera espacio eliminando copias de seguridad antiguas, logs o archivos temporales desde el administrador de archivos de Syspanel.

Memoria RAM:

En Syspanel, mira la sección de "Monitor" o "Recursos".
Si la RAM está al 100% constantemente, el servidor está haciendo thrashing (intercambio de memoria) y no puede atender las peticiones de la base de datos.
La solución a corto plazo es reiniciar el servicio MySQL desde Syspanel (como hicimos en el Paso 1).
A largo plazo, considera optimizar tu tienda (desactivar módulos pesados) o contratar un plan superior.

Paso 6: Revisa los logs de error para obtener pistas más precisas

Si nada de lo anterior funciona, los registros del sistema te darán la pista definitiva. No es tan difícil como parece.

En Syspanel, busca la sección de "Registros" o "Logs".
Busca los logs de MySQL y de PHP.
Abre el log de MySQL y busca errores recientes con la fecha de hoy. Presta atención a mensajes como "Access denied for user" (acceso denegado) o "Too many connections" (demasiadas conexiones).
Abre el log de PHP y busca errores de conexión o de archivos no encontrados.

[INFO] Si ves el error "Access denied for user 'admin'@'localhost' (using password: YES)", significa que el usuario o la contraseña son incorrectos. Vuelve al Paso 2 y cámbialos. Si ves "Too many connections", el problema es de saturación, no de configuración.

Paso 7: Solución avanzada: Editar la configuración de MySQL (si tienes VPS)

Si tienes un VPS y gestionas MySQL directamente, el problema puede estar en el archivo de configuración my.cnf. A veces, el límite de conexiones (max_connections) es demasiado bajo.

Accede a tu servidor por SSH (necesitarás conocimientos de terminal).
Edita el archivo /etc/mysql/my.cnf o /etc/my.cnf.
Busca la línea max_connections y auméntala (por ejemplo, de 150 a 300).
Guarda el archivo y reinicia MySQL con el comando systemctl restart mysql.

[WARNING] Este paso es solo para usuarios con experiencia en administración de servidores. Un cambio incorrecto puede dejar tu base de datos inaccesible. Si no estás seguro, contacta con tu proveedor de hosting.

Preguntas Frecuentes (FAQ) sobre el error de conexión

¿Por qué PrestaShop no conecta BD después de un cambio de contraseña en Syspanel?

Porque el archivo parameters.php guarda la contraseña antigua. Debes actualizarlo siguiendo el Paso 3 de esta guía. Te recomiendo usar el instalador para que sea automático.

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

Sí, aunque es menos común. Un módulo mal codificado puede intentar hacer conexiones a una base de datos externa y saturar el sistema. Si el error apareció tras instalar un módulo, desactívalo renombrando su carpeta en /modules/nombre_del_modulo a /modules/nombre_del_modulo_bak mediante FTP.

¿Qué significa el error "Syspanel PrestaShop error" en el panel?

El error no es de Syspanel en sí, sino de la aplicación. Syspanel es la herramienta que te permite gestionar el servidor. El error "No se puede conectar a la base de datos" es de PrestaShop, pero Syspanel es donde tienes que ir a buscar la solución, ya que ahí gestionas las bases de datos.

¿Perderé mis productos si edito el archivo de configuración?

No. Editar parameters.php solo cambia los datos de conexión. No toca las tablas de la base de datos. Tus productos, pedidos y clientes están a salvo en MySQL. Eso sí, no borres la base de datos ni la restaures sin hacer una copia de seguridad.

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

Si es un problema de credenciales, en 10 minutos lo tienes. Si es un problema de saturación del servidor, puede llevar más tiempo, ya que necesitas liberar recursos o contactar con el soporte.

Conclusión: Recupera tu tienda sin pánico

El error de conexión a la base de datos es un susto, pero rara vez es un problema fatal. Siguiendo estos pasos de forma metódica, en la mayoría de los casos lo resolverás sin necesidad de contactar con un técnico.

Resumen rápido de acciones:

Reinicia MySQL desde Syspanel (puerto 2106).
Verifica credenciales en Syspanel vs. app/config/parameters.php.
Corrige el archivo o usa el instalador para actualizarlo.
Revisa permisos (755/644).
Libera espacio en disco si está lleno.
Revisa logs para obtener el error exacto.

Si después de todo esto el problema persiste, no dudes en contactar con el soporte de tu hosting. Diles que ya has reiniciado MySQL, revisado las credenciales y verificado el espacio en disco. Eso les ahorrará tiempo y te ayudarán mucho más rápido.

Recuerda: la calma es tu mejor aliada. Tu base de datos sigue ahí, solo necesitas restablecer el puente de conexión. ¡Manos a la obra y a recuperar tu tienda!