Error de conexión a BD en PrestaShop con Syspanel - Solución

¿Tu tienda PrestaShop muestra un mensaje de error de conexión a la base de datos? No te preocupes, es uno de los problemas más comunes, pero también de los más fáciles de solucionar si sabes dónde mirar. En esta guía completa, te explicaré paso a paso cómo diagnosticar y resolver el error base datos PrestaShop Syspanel, incluso si no eres un experto en tecnología. Vamos a ello.

¿Qué significa exactamente "Error de conexión a la base de datos"?

Cuando PrestaShop no puede conectarse a su base de datos (MySQL/MariaDB), muestra mensajes como "Error de conexión a la base de datos" o "Link to database cannot be established". Esto significa que tu tienda no puede leer ni escribir información, por lo que se bloquea por completo.

Las causas más habituales suelen ser:

Credenciales incorrectas (usuario, contraseña o nombre de BD).
El servidor de base de datos está caído o no responde.
El servicio MySQL no está activo en tu panel de control.
Problemas de permisos o de IP restringida.
Cambios recientes en la configuración del hosting o del panel.

Para solucionarlo, vamos a trabajar directamente con Syspanel, el panel de control que gestiona tu hosting. Recuerda que siempre accedes a Syspanel a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106).

Primer paso: Accede a Syspanel y verifica el estado del servicio MySQL

Antes de tocar archivos de configuración, debemos confirmar que el motor de base de datos está funcionando. Es como comprobar si el motor del coche arranca antes de abrir el capó.

Abre tu navegador y accede a Syspanel usando el puerto 2106. Introduce tus credenciales de administrador.
Dentro del panel, busca la sección "Servicios" o "Servicios del sistema". En Syspanel suele estar en el menú lateral izquierdo.
Localiza MySQL o MariaDB en la lista de servicios. Verás un indicador de estado (verde = activo, rojo = detenido).
Si el estado es "detenido" o "no activo", haz clic en el botón "Iniciar" o "Reiniciar". Espera unos segundos y refresca la página.

[TIP] Si el servicio se detiene constantemente, puede ser un problema de falta de memoria o de configuración. Pero primero, reinícialo y prueba de nuevo tu tienda.

Segundo paso: Revisa las credenciales de conexión en PrestaShop

Si el servicio MySQL está activo pero el error persiste, el siguiente sospechoso son las credenciales de acceso. PrestaShop guarda esta información en un archivo llamado parameters.php, que se encuentra en la carpeta app/config/ de tu instalación.

Para revisarlo:

Accede a tu hosting mediante FTP o el administrador de archivos de Syspanel. En Syspanel, puedes usar la opción "Administrador de archivos" en el menú principal.
Navega hasta public_html/app/config/ (o la carpeta donde tengas instalado PrestaShop).
Busca el archivo parameters.php. Ábrelo con el editor de texto que te ofrece Syspanel.
Busca la sección database_params o database. Verás algo así:

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

Compara estos datos con los que tienes en Syspanel. Para ello, ve a la sección "Bases de datos" en Syspanel. Ahí verás el nombre exacto de tu BD, el usuario y podrás restablecer la contraseña.

[WARNING] Si cambias la contraseña en Syspanel, tendrás que actualizarla también en parameters.php. Si no lo haces, PrestaShop seguirá intentando conectarse con la contraseña antigua.

¿Cómo restablecer la contraseña de la base de datos en Syspanel?

En Syspanel, ve a "Bases de datos".
Localiza la base de datos que usa tu PrestaShop.
Haz clic en el icono de editar o en "Cambiar contraseña".
Introduce una contraseña nueva y segura (usa letras, números y símbolos).
Guarda los cambios y actualiza parameters.php con la nueva contraseña.

Tercer paso: Verifica que el host de la base de datos sea el correcto

Un error muy común es tener configurado localhost cuando en realidad el servidor de BD es otro. En la mayoría de los hosting compartidos, el host suele ser localhost, pero en servidores dedicados o VPS puede ser una IP o un nombre como mysql.tudominio.com.

¿Cómo saber cuál es el host correcto? En Syspanel:

Ve a "Bases de datos" y selecciona tu base de datos.
Busca el campo "Host" o "Servidor". Suele aparecer como localhost o una IP.
Copia ese valor exacto y pégalo en el campo database_host del archivo parameters.php.

[INFO] Si tu hosting usa un host remoto, asegúrate de que el puerto MySQL (por defecto 3306) esté abierto en el firewall. Syspanel suele gestionarlo automáticamente, pero si tienes dudas, contacta con soporte.

Cuarto paso: Repara los permisos de los archivos de configuración

En ocasiones, el problema no es de contraseña sino de permisos. Los archivos de PrestaShop deben tener permisos específicos para que el sistema pueda leerlos. Si los permisos son demasiado restrictivos, PHP no podrá acceder a parameters.php.

Para solucionarlo:

En el administrador de archivos de Syspanel, navega hasta app/config/parameters.php.
Haz clic derecho sobre el archivo y selecciona "Permisos" o "Chmod".
Establece los permisos a 644 (lectura y escritura para el propietario, lectura para el grupo y el resto).
Si el problema persiste, también puedes dar permisos 755 a la carpeta app/config/.

[WARNING] No pongas permisos 777 a los archivos de configuración, ya que supone un grave riesgo de seguridad. Con 644 es suficiente.

Quinto paso: Comprueba si la base de datos está corrupta o saturada

A veces, el error no es de conexión sino de la propia base de datos. Si la BD está llena o corrupta, PrestaShop no podrá operar correctamente.

¿Cómo saber si tu BD está llena?

En Syspanel, ve a "Bases de datos".
Junto a tu base de datos, verás el tamaño ocupado. Si supera el límite de tu plan, tendrás que liberar espacio o ampliarlo.

¿Cómo reparar una base de datos corrupta?

Syspanel incluye herramientas de administración de BD. Busca la opción "phpMyAdmin" dentro de la sección de bases de datos:

Abre phpMyAdmin desde Syspanel.
Selecciona tu base de datos en el panel izquierdo.
Marca todas las tablas (clic en "Seleccionar todo").
En el menú desplegable inferior, elige "Reparar tabla".
Ejecuta la acción y espera a que termine.

[TIP] Si la reparación no funciona, puedes hacer una copia de seguridad antes de intentar otras soluciones más drásticas.

Sexto paso: Revisa los logs de error para obtener más pistas

PrestaShop y el propio servidor generan registros de errores que te dirán exactamente qué está fallando. Para acceder a ellos:

En Syspanel, ve a "Registros" o "Logs" (puede llamarse "Bitácora").
Busca los logs de error de PHP o del servidor web (Apache/Nginx).
Filtra por fecha y hora del error que estás viendo.

También puedes activar el modo depuración de PrestaShop temporalmente:

Edita el archivo config/defines.inc.php en la raíz de tu PrestaShop.
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true.
Guarda y recarga tu tienda. Verás mensajes de error más detallados.

[WARNING] No olvides volver a poner false cuando termines de depurar, ya que el modo dev muestra información sensible a los visitantes.

Séptimo paso: Prueba la conexión desde la línea de comandos (SSH)

Si tienes acceso SSH a tu servidor (Syspanel te permite habilitarlo), puedes probar la conexión directamente:

Conéctate por SSH a tu servidor.
Ejecuta el siguiente comando, reemplazando los datos:

mysql -u tu_usuario -p tu_basededatos

Te pedirá la contraseña. Si introduce la correcta, entrarás al prompt de MySQL. Si no, verás un mensaje de acceso denegado.

Si el comando te da error, el problema está claro: o las credenciales son incorrectas o el usuario no tiene permisos para esa BD.

¿Cómo otorgar permisos al usuario de BD en Syspanel?

Ve a "Bases de datos" en Syspanel.
Busca tu base de datos y haz clic en "Gestionar permisos" o "Usuarios".
Asegúrate de que el usuario que usa PrestaShop tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Si no aparece, añade el usuario a la base de datos con permisos completos.

Octavo paso: Comprueba el archivo .htaccess y la configuración de PHP

A veces, modificaciones en el .htaccess o en la versión de PHP pueden romper la conexión a la BD. Asegúrate de que:

La versión de PHP es compatible con tu PrestaShop (recomendado PHP 7.4 u 8.0 para versiones modernas).
El archivo .htaccess no tiene reglas que bloqueen las solicitudes internas.

Para cambiar la versión de PHP en Syspanel:

Ve a "Configuración" o "PHP" en el panel.
Selecciona la versión recomendada para tu PrestaShop.
Guarda y prueba de nuevo.

Noveno paso: Restaura una copia de seguridad reciente

Si nada de lo anterior funciona, la solución más rápida es restaurar una copia de seguridad de tu base de datos. Syspanel ofrece copias automáticas diarias o semanales.

En Syspanel, ve a "Copias de seguridad" o "Backups".
Localiza una copia de tu base de datos de una fecha anterior al error.
Restaura esa copia. Si el error desaparece, significa que algo se corrompió después de esa fecha.

[WARNING] Al restaurar una copia, perderás los cambios realizados desde esa fecha. Asegúrate de tener una copia actual de tus archivos y datos para minimizar pérdidas.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error de BD después de cambiar el hosting?

Es muy común. Al migrar, las rutas y credenciales cambian. Debes actualizar parameters.php con los datos del nuevo servidor. También verifica que hayas importado correctamente la base de datos y que el usuario tenga permisos.

¿Qué hago si Syspanel me da error al restablecer la contraseña de BD?

Prueba a crear un nuevo usuario de BD y asigna ese usuario a tu base de datos. Luego actualiza parameters.php con las nuevas credenciales.

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

Sí, un módulo mal codificado puede generar consultas que saturan la BD. Prueba a desactivar todos los módulos no esenciales desde el administrador de PrestaShop. Si no puedes acceder al admin, desactívalos temporalmente renombrando la carpeta modules (si tienes acceso por FTP) o mediante la base de datos (cambiando el estado de los módulos en la tabla ps_module).

¿Cuánto tarda en solucionarse este tipo de error?

Depende de la causa. Si es una contraseña incorrecta, en 5 minutos. Si es un problema de servidor, puede llevar más tiempo. Con esta guía, la mayoría de los casos se resuelven en menos de 30 minutos.

Consejos finales para evitar futuros errores de conexión

Realiza copias de seguridad periódicas de tu base de datos y archivos. Syspanel te permite programarlas automáticamente.
No cambies las credenciales sin actualizar inmediatamente el archivo parameters.php.
Mantén PrestaShop y los módulos actualizados a la última versión estable.
Supervisa el espacio disponible en tu plan de hosting. Una BD llena da errores muy raros.
Usa contraseñas fuertes para la BD y el panel de control.

Recuerda que Syspanel está diseñado para que puedas gestionar todo esto de forma sencilla. Si después de seguir todos estos pasos el error base datos PrestaShop Syspanel persiste, contacta con el soporte técnico de tu proveedor de hosting, indicando los pasos que ya has realizado y adjuntando los logs de error. Así podrán ayudarte mucho más rápido.

Espero que esta guía te haya sido útil. Con un poco de paciencia y siguiendo estos pasos, tu tienda volverá a estar operativa en poco tiempo. ¡Mucho ánimo y a vender!