Resolver error de base de datos en PrestaShop con Syspanel

¿Tu tienda PrestaShop ha dejado de funcionar de repente y ves un mensaje de error relacionado con la base de datos? No te preocupes, es uno de los problemas más comunes en tiendas online, pero también de los que tienen solución más directa. En esta guía extensa y muy detallada, te explicaré paso a paso cómo diagnosticar y solucionar los errores de conexión con la base de datos en PrestaShop, especialmente cuando gestionas tu servidor a través de Syspanel (el panel de control basado en HestiaCP, que se accede por el puerto 2106).

Vamos a desglosar el problema desde cero, como si fuera una conversación de soporte. Hablaremos de los errores típicos, de cómo revisar la configuración de conexión MySQL en PrestaShop, y de cómo usar Syspanel para verificar que la base de datos esté funcionando correctamente. Al final, tendrás una checklist clara para recuperar tu tienda en pocos minutos.

¿Qué significa "error de base de datos en PrestaShop"?

Cuando ves un mensaje como "Error de conexión a la base de datos" o "No se puede conectar con el servidor MySQL", lo que está ocurriendo es que tu tienda PrestaShop no logra comunicarse con la base de datos donde guarda toda la información: productos, pedidos, clientes, configuraciones, etc. Sin esa conexión, la tienda no puede cargar ninguna página.

Las causas pueden ser varias, pero las más frecuentes son:

Credenciales incorrectas en el archivo de configuración de PrestaShop (settings.inc.php).
El servidor MySQL está caído o no responde.
El usuario de la base de datos no tiene permisos o la base de datos ha sido eliminada por error.
Problemas de firewall o puertos bloqueados (especialmente el puerto 3306 para MySQL).
Cambios recientes en el hosting (migraciones, actualizaciones de PHP o MySQL).

Vamos a revisar cada una de estas causas con pasos prácticos.

Primeros pasos: diagnóstico rápido desde el front y el back office

Antes de meterte en archivos de configuración, observa el comportamiento de tu tienda:

Si ves el error en la página principal (front office) pero puedes acceder al back office (admin), el problema puede ser parcial o de permisos.
Si no puedes acceder ni al front ni al back, lo más probable es que la conexión esté totalmente rota.
Si el error aparece después de una actualización de PrestaShop o un cambio en el hosting, seguramente sea un cambio en las credenciales o en la versión de MySQL.

Consejo rápido: Anota el mensaje exacto de error. Te ayudará a buscar la causa concreta. Por ejemplo: "Error de conexión a la base de datos: Access denied for user" indica que el usuario o contraseña son incorrectos.

Solución paso a paso con Syspanel (HestiaCP)

Syspanel es la herramienta que te permite gestionar tu servidor web, bases de datos, dominios y correos. Para acceder, abre tu navegador y escribe: https://tu-dominio-o-ip:2106. Allí iniciarás sesión con las credenciales de administrador que te proporcionó tu proveedor de hosting.

1. Verificar que el servicio MySQL esté activo

Lo primero es asegurarte de que el motor de bases de datos (MySQL o MariaDB) esté funcionando. En Syspanel:

Ve a la sección Servicios o Estado del servidor (suele estar en el menú lateral).
Busca el servicio MySQL o MariaDB. Debe aparecer con un indicador verde o "running".
Si está rojo o "stopped", haz clic en Iniciar o Reiniciar.

[TIP] Si no ves la opción de reiniciar, puedes hacerlo desde la terminal SSH (si tienes acceso) con el comando: systemctl restart mysql o service mysql restart.

2. Revisar la base de datos y el usuario en Syspanel

Ahora comprobemos que la base de datos que usa PrestaShop existe y que el usuario tiene los permisos correctos.

En Syspanel, ve a Base de datos (o Databases).
Busca el nombre de la base de datos que usa tu tienda. Si no lo recuerdas, puedes consultarlo en el archivo de configuración de PrestaShop (lo veremos más adelante).
Haz clic en el nombre de la base de datos para ver sus detalles.
Verifica que el usuario asociado (por ejemplo, usuario_tienda) esté listado y tenga permisos ALL PRIVILEGES (todos los privilegios).

Si la base de datos no aparece, puede que haya sido eliminada por error. En ese caso, tendrías que restaurarla desde una copia de seguridad. Si el usuario no tiene permisos, puedes editarlos desde la misma interfaz.

3. Comprobar las credenciales en el archivo settings.inc.php

Este es el paso más crítico. PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado settings.inc.php. Si las credenciales son incorrectas, la conexión falla.

Para acceder a este archivo:

Conéctate a tu servidor mediante FTP o desde el administrador de archivos de Syspanel (en la sección Archivos o File Manager).
Navega hasta la carpeta config/ dentro del directorio de tu tienda PrestaShop (por ejemplo, public_html/config/).
Busca el archivo settings.inc.php. Ábrelo con un editor de texto (nunca con WordPad o procesadores que añadan formato).

Dentro verás líneas como estas:

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_');

Verifica que:

_DB_SERVER_ sea localhost (o la dirección del servidor MySQL si está en otro equipo).
_DB_NAME_ coincida exactamente con el nombre de la base de datos que viste en Syspanel.
_DB_USER_ y _DB_PASSWD_ sean los mismos que configuraste en Syspanel para esa base de datos.

[WARNING] Si cambiaste la contraseña recientemente en Syspanel, debes actualizarla también en este archivo. Si no, PrestaShop seguirá usando la contraseña antigua.

4. Probar la conexión MySQL manualmente

Para descartar que el problema sea de PrestaShop y no del servidor, puedes hacer una prueba de conexión directa desde la herramienta phpMyAdmin que suele estar integrada en Syspanel.

En Syspanel, busca phpMyAdmin o Base de datos -> phpMyAdmin.
Inicia sesión con el usuario y contraseña de la base de datos (los mismos que aparecen en settings.inc.php).
Si puedes acceder y ves las tablas de PrestaShop (con el prefijo, por ejemplo ps_orders, ps_products), entonces la base de datos y el usuario funcionan correctamente. El problema está en la configuración de PrestaShop o en algún permiso de archivos.

Si no puedes acceder a phpMyAdmin con esas credenciales, entonces el error está en el usuario o contraseña. En ese caso, desde Syspanel puedes cambiar la contraseña del usuario de la base de datos (en la sección Base de datos -> Editar usuario) y luego actualizarla en settings.inc.php.

5. Verificar el archivo .htaccess y los permisos de carpeta

A veces, un error de conexión puede ser causado por un archivo .htaccess corrupto o por permisos incorrectos en la carpeta config/.

Desde el administrador de archivos de Syspanel, asegúrate de que la carpeta config/ tenga permisos 755 (o 750 en algunos servidores).
El archivo settings.inc.php debe tener permisos 644 (o 640) para que PrestaShop pueda leerlo, pero no modificarlo desde la web.

Si el archivo .htaccess de la raíz de tu tienda está dañado, puedes renombrarlo temporalmente a .htaccess_old y luego regenerarlo desde el back office de PrestaShop (si puedes acceder) o pidiendo a tu hosting que lo restablezca.

6. Comprobar la versión de PHP y MySQL

PrestaShop es sensible a las versiones de PHP y MySQL. Por ejemplo, PrestaShop 1.6 no funciona bien con PHP 8.0 o superior, y necesita MySQL 5.6 o superior.

Desde Syspanel:

Ve a Servicios o Configuración del servidor.
Busca la versión de PHP que tienes asignada a tu dominio (en algunos paneles se configura en Web -> Dominio -> PHP).
Asegúrate de que sea compatible con tu versión de PrestaShop. Si no estás seguro, consulta la documentación oficial de PrestaShop.

Para MySQL, en Syspanel puedes ver la versión en Base de datos o en Servicios. Si es muy antigua (MySQL 5.5) o muy nueva (MySQL 8.0 con problemas de compatibilidad), considera migrar a una versión intermedia como MariaDB 10.3 o 10.4.

7. Restaurar desde una copia de seguridad

Si después de todos estos pasos el error persiste y no puedes acceder a la base de datos, es posible que la base de datos esté corrupta o haya sido eliminada. En ese caso:

En Syspanel, ve a Base de datos -> Copias de seguridad (o Backups).
Busca la copia de seguridad más reciente de tu base de datos.
Restáurala. Normalmente se hace con un solo clic.

Si no tienes copia de seguridad en Syspanel, pero sí un archivo .sql descargado previamente, puedes importarlo desde phpMyAdmin.

Errores comunes y soluciones rápidas

Aquí tienes una lista de errores típicos con su solución más directa:

"Access denied for user": El usuario o contraseña son incorrectos. Revisa settings.inc.php y cámbialos en Syspanel.
"Can't connect to MySQL server on 'localhost'": El servicio MySQL no está corriendo. Reinícialo desde Syspanel o SSH.
"Unknown database": La base de datos no existe. Crea una nueva en Syspanel con el mismo nombre y restaura los datos desde un backup.
"Too many connections": Hay muchas conexiones simultáneas. Aumenta el límite en la configuración de MySQL (my.cnf) o reinicia el servicio.
"Table 'ps_shop_url' doesn't exist": La base de datos está corrupta o incompleta. Restaura desde un backup.

FAQ: Preguntas frecuentes sobre error base datos PrestaShop

¿Por qué aparece el error después de una actualización de PrestaShop?
Las actualizaciones pueden cambiar la versión de PHP requerida o modificar el archivo settings.inc.php. Revisa que las credenciales sigan siendo las mismas y que la versión de PHP sea compatible.

¿Puedo solucionar el error sin acceder al back office?
Sí, la mayoría de las soluciones se hacen desde Syspanel o mediante FTP editando archivos. Solo necesitas acceso al panel de control.

¿Qué hago si no recuerdo la contraseña de la base de datos?
En Syspanel puedes cambiar la contraseña de cualquier usuario de base de datos desde la sección Base de datos -> Editar usuario. Luego actualiza settings.inc.php.

¿El error puede deberse a un plugin o módulo?
Raramente. Los módulos no afectan la conexión a la base de datos, a menos que hayan modificado el archivo settings.inc.php (lo cual es muy extraño). Si sospechas, desactiva los módulos renombrando la carpeta modules/ temporalmente.

¿Cómo sé si mi hosting tiene un corte de servicio?
Revisa el estado del servidor en Syspanel. Si el servicio MySQL está caído, es un problema del hosting. Contacta con soporte técnico.

Conclusión: Checklist para recuperar tu tienda

Si sigues estos pasos en orden, en la mayoría de los casos recuperarás la conexión a la base de datos de PrestaShop en menos de 15 minutos:

Accede a Syspanel (puerto 2106) y verifica que MySQL esté activo.
Comprueba que la base de datos y el usuario existan y tengan permisos.
Abre config/settings.inc.php y confirma que las credenciales coincidan.
Prueba la conexión con phpMyAdmin.
Revisa permisos de archivos y versión de PHP.
Si todo falla, restaura desde una copia de seguridad.

[INFO] Recuerda que siempre es recomendable tener copias de seguridad automáticas de tu base de datos. En Syspanel puedes programarlas diariamente.

[WARNING] No modifiques el archivo settings.inc.php con editores que añadan formato (como Word). Usa un editor de texto plano como Notepad++ o el editor integrado en Syspanel.

Con esta guía, espero que hayas podido resolver el error de conexión con la base de datos en PrestaShop. Si el problema persiste, contacta con el soporte técnico de tu hosting, indicándoles el mensaje exacto de error y los pasos que ya has realizado. ¡Buena suerte con tu tienda!