Error 'PrestaShop no puede conectarse a la base de datos' en Syspanel: Solución

¿Por qué aparece el error “PrestaShop no puede conectarse a la base de datos”?

Este es uno de los avisos más temidos por cualquier dueño de una tienda online, pero también uno de los más fáciles de resolver si sabes dónde mirar. Cuando PrestaShop no puede conectarse a la base de datos, normalmente significa que el archivo de configuración parameters.php (o settings.inc.php en versiones antiguas) contiene datos incorrectos, o que el servidor MySQL no está aceptando la conexión.

En este artículo te voy a guiar paso a paso para que soluciones este error base de datos PrestaShop desde tu panel de control Syspanel, incluso si no tienes experiencia técnica. Vamos a ello.

¿Qué es Syspanel y cómo accedo a él?

Syspanel es el panel de control que utilizamos para gestionar tu alojamiento web. Aquí puedes administrar tus bases de datos, dominios, archivos y mucho más. Para acceder a él, simplemente abre tu navegador y escribe la dirección de tu servidor seguida del puerto 2106. Por ejemplo: https://tu-dominio.com:2106.

[INFO] Si no recuerdas tus credenciales de acceso a Syspanel, contacta con nuestro soporte técnico y te las restableceremos en menos de 5 minutos.

Una vez dentro, verás un menú lateral con varias opciones: “Usuarios”, “Bases de datos”, “Dominios”, “Archivos”, entre otras. No te preocupes, no necesitamos tocar nada complicado.

Paso 1: Verifica que la base de datos exista y esté activa

El primer paso para solucionar el Syspanel error es comprobar que tu base de datos MySQL sigue existiendo y está corriendo correctamente. A veces, por mantenimiento o por un error humano, la base de datos se elimina o se detiene sin que te des cuenta.

Sigue estos pasos:

Entra en Syspanel con tu usuario y contraseña.
Busca la sección “Bases de datos” en el menú lateral.
Verás una lista con todas tus bases de datos. Localiza la que corresponde a tu tienda PrestaShop (normalmente tiene un nombre similar a tuusuario_prestashop).
Comprueba que el estado sea “Activa” o “Corriendo”. Si aparece detenida, haz clic en el botón de inicio.

[TIP] Si no encuentras tu base de datos en esa lista, es probable que se haya eliminado accidentalmente. En ese caso, necesitarás restaurar una copia de seguridad desde la sección “Copias de seguridad” de Syspanel.

Si la base de datos está activa, pasemos al siguiente paso.

Paso 2: Comprueba las credenciales de acceso a MySQL

La causa más común de este error base de datos PrestaShop es que las credenciales de acceso hayan cambiado. Esto puede ocurrir si cambiaste la contraseña de la base de datos desde Syspanel, o si el archivo de configuración de PrestaShop se corrompió.

Para verificar las credenciales:

Ve a la sección “Bases de datos” en Syspanel.
Haz clic en el icono de “Editar” o “Configurar” junto a tu base de datos.
Ahí verás el nombre de usuario y la contraseña asociados a esa base de datos. Anota ambos datos.
Ahora, abre el archivo parameters.php de tu PrestaShop. Puedes hacerlo desde la sección “Archivos” de Syspanel, navegando hasta public_html/app/config/parameters.php.

Dentro de ese archivo, busca las siguientes líneas:

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

Compara estos valores con los que tienes en Syspanel. Si no coinciden, corrígelos y guarda el archivo.

[WARNING] Ten mucho cuidado al editar este archivo. Un solo carácter mal puesto puede romper toda la tienda. Si no estás seguro, haz una copia de seguridad del archivo antes de modificarlo.

Paso 3: Verifica la dirección del servidor MySQL

Otro motivo habitual del Syspanel error es que la dirección del servidor de base de datos sea incorrecta. En la mayoría de los casos, debería ser localhost, pero en algunos servidores compartidos o VPS, puede que necesites usar una dirección IP o un hostname específico.

Para comprobarlo:

En Syspanel, ve a la sección “Bases de datos” y busca el campo “Host” o “Servidor”.
Anota ese valor. Normalmente será localhost, pero si ves algo como mysql.tudominio.com o una IP, usa ese valor.
Actualiza el archivo parameters.php con el host correcto.

[INFO] Si tu hosting usa MySQL remoto, es posible que necesites añadir tu IP a la lista de hosts permitidos en Syspanel. Esto se hace desde la configuración de la base de datos.

Paso 4: Revisa los permisos del usuario de la base de datos

A veces, el usuario de la base de datos existe y la contraseña es correcta, pero no tiene permisos suficientes para acceder a la base de datos. Esto puede pasar si alguien modificó los permisos por error.

Para solucionarlo:

En Syspanel, ve a la sección “Bases de datos”.
Busca la opción “Usuarios” o “Privilegios”.
Asegúrate de que el usuario asociado a tu base de datos tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Si no es así, selecciona “Todos los privilegios” y guarda los cambios.

[TIP] Si no encuentras esta opción, crea un nuevo usuario de base de datos con todos los permisos y asígnalo a tu base de datos. Luego actualiza los datos en parameters.php.

Paso 5: Comprueba si el puerto MySQL es el correcto

Por defecto, MySQL usa el puerto 3306. Sin embargo, algunos servidores configuran puertos personalizados por seguridad. Si tu hosting usa un puerto diferente, PrestaShop no podrá conectarse.

Para comprobarlo:

En Syspanel, ve a la sección “Bases de datos” y busca el campo “Puerto”.
Si ves un número diferente a 3306, anótalo.
En el archivo parameters.php, busca la línea 'database_port' => '3306' y cámbiala por el puerto correcto.

[WARNING] Si no estás seguro de cuál es el puerto, contacta con soporte antes de cambiar nada. Usar un puerto incorrecto puede generar más errores.

Paso 6: Verifica que el servicio MySQL esté corriendo en el servidor

Este paso es un poco más técnico, pero aún puedes hacerlo desde Syspanel. A veces, el servicio MySQL se detiene por falta de memoria o por un reinicio del servidor.

Para comprobarlo:

En Syspanel, busca la sección “Servicios” o “Estado del servidor”.
Busca el servicio MySQL o MariaDB.
Si está detenido, haz clic en “Iniciar” o “Reiniciar”.

[INFO] Si no encuentras esta opción en Syspanel, puedes usar el terminal integrado (si está disponible) y ejecutar el comando service mysql status. Si no te sientes cómodo con esto, contacta con soporte.

Paso 7: Limpia la caché de PrestaShop

A veces, PrestaShop guarda en caché datos de configuración antiguos, y aunque hayas corregido los archivos, sigue mostrando el error. Para solucionarlo:

Ve a la sección “Archivos” en Syspanel.
Navega hasta public_html/var/cache/ (o public_html/cache/ en versiones antiguas).
Elimina todos los archivos y carpetas dentro de ese directorio. No te preocupes, PrestaShop los regenerará automáticamente.

[TIP] También puedes desactivar la caché desde el archivo parameters.php cambiando 'cache_enabled' => false. Pero ten en cuenta que esto ralentizará tu tienda, así que vuelve a activarlo después de solucionar el problema.

Paso 8: Restaura una copia de seguridad reciente

Si has probado todos los pasos anteriores y el error base de datos PrestaShop persiste, es posible que algún archivo de configuración esté dañado más allá de una simple corrección. En ese caso, la solución más segura es restaurar una copia de seguridad reciente.

Para hacerlo:

En Syspanel, ve a la sección “Copias de seguridad”.
Selecciona una copia reciente de tu base de datos (idealmente de antes de que empezara el error).
Restaura la copia. Esto sobrescribirá todos los datos actuales de la base de datos.

[WARNING] Asegúrate de que la copia de seguridad sea de una fecha en la que tu tienda funcionaba correctamente. Restaurar una copia antigua puede hacerte perder pedidos o clientes recientes.

Paso 9: Contacta con soporte técnico

Si después de seguir todos estos pasos el problema continúa, no te preocupes. No estás solo. A veces, el problema está en el servidor y no en tu configuración, y solo un técnico especializado puede solucionarlo.

En nuestro equipo de soporte estamos disponibles 24/7 para ayudarte a resolver cualquier Syspanel error. Solo tienes que:

Enviar un ticket desde Syspanel indicando el error exacto que ves.
Adjuntar una captura de pantalla si es posible.
Indicar qué pasos has probado ya.

[INFO] Nuestro tiempo medio de respuesta es de menos de 15 minutos, y la mayoría de los problemas de conexión MySQL se resuelven en menos de una hora.

Preguntas frecuentes sobre este error

¿Por qué PrestaShop muestra este error después de cambiar la contraseña de la base de datos?

Porque el archivo parameters.php sigue guardando la contraseña antigua. Actualiza ese archivo con la nueva contraseña y limpia la caché.

¿Puedo usar una herramienta como phpMyAdmin para comprobar la conexión?

Sí, puedes acceder a phpMyAdmin desde Syspanel para verificar que la base de datos existe y que puedes conectarte con las credenciales que tienes. Si phpMyAdmin funciona, el problema está en la configuración de PrestaShop.

¿Qué hago si no tengo copia de seguridad?

Si no tienes una copia de seguridad, contacta con soporte inmediatamente. A veces podemos recuperar la base de datos desde el servidor, aunque no siempre es posible.

¿Este error afecta a la tienda en línea?

Sí, mientras PrestaShop no pueda conectarse a la base de datos, tu tienda mostrará un mensaje de error y los clientes no podrán comprar. Es importante resolverlo lo antes posible.

Consejos finales para evitar este error en el futuro

Para que no vuelvas a enfrentarte a este error base de datos PrestaShop, te recomiendo:

Realiza copias de seguridad automáticas semanales desde Syspanel.
Anota todos los cambios que hagas en las credenciales de la base de datos.
Actualiza PrestaShop regularmente a la última versión.
No compartas tus credenciales de Syspanel con nadie que no sea de confianza.
Revisa periódicamente el estado de tus servicios desde Syspanel.

Recuerda que, para cualquier problema con tu hosting, siempre puedes contar con nuestro equipo. El Syspanel error no tiene por qué ser el fin de tu tienda online. Con paciencia y los pasos correctos, tendrás tu PrestaShop funcionando en poco tiempo.

Espero que esta guía te haya sido de gran ayuda. Si te ha servido, compártela con otros usuarios que puedan estar pasando por el mismo problema. ¡Buena suerte con tu tienda!