Problemas de base de datos en PrestaShop con Syspanel - Soluciones

¿Tu tienda PrestaShop se ha quedado en blanco? ¿Ves un mensaje de error que dice algo como “Error de conexión a la base de datos” o “No se puede conectar con el servidor de base de datos”? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía te voy a explicar paso a paso cómo solucionar los problemas de conexión a la base datos PrestaShop Syspanel, desde los errores típicos hasta cómo reparar la configuración desde tu panel de control.

Vamos a empezar por lo básico: entender qué está pasando y cómo arreglarlo sin necesidad de ser un experto en programación.

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

PrestaShop guarda toda la información de tu tienda (productos, clientes, pedidos, configuraciones) en una base de datos. Cuando tu tienda no puede conectarse a esa base de datos, se muestra un error en la pantalla. Las causas más frecuentes son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos en el archivo de configuración.
Servidor de base de datos caído o sobrecargado: El servidor donde se aloja la base de datos (MySQL/MariaDB) no está funcionando correctamente.
Cambios en el hosting: Al migrar tu tienda a otro servidor o al cambiar los datos de acceso en tu panel de control (Syspanel), la configuración de PrestaShop no se actualiza automáticamente.
Archivo de configuración dañado o faltante: El archivo app/config/parameters.php (en PrestaShop 1.7 y 8.x) o config/settings.inc.php (en PrestaShop 1.6) está corrupto o no existe.
Problemas de permisos o firewall: El servidor bloquea la conexión a la base de datos desde ciertas IPs o puertos.

[INFO] Si ves un mensaje como “Link to database cannot be established” o “Error de conexión a la base de datos”, no entres en pánico. Lo primero es mantener la calma y seguir los pasos que te explico a continuación.

Primeros pasos para diagnosticar el error conexión PrestaShop Syspanel

Antes de tocar archivos, haz estas comprobaciones rápidas desde tu panel de control Syspanel. Recuerda que para acceder a Syspanel debes ir a tudominio.com:2106 (el puerto 2106 es el que usamos para este panel).

Verifica el estado del servidor de base de datos

Inicia sesión en Syspanel con tu usuario y contraseña.
Busca la sección “Servicios” o “Estado del servidor” (suele estar en el menú lateral).
Revisa que el servicio MySQL o MariaDB esté marcado como “Activo” o “Running”. Si aparece como “Detenido”, haz clic en el botón “Iniciar” o “Reiniciar”.

[WARNING] Si el servicio no arranca, puede que haya un problema más grave. Contacta con tu soporte técnico de hosting, ya que puede ser necesario reparar la base de datos desde la terminal.

Comprueba los datos de acceso a la base de datos

Desde Syspanel, ve a “Base de datos” o “Bases de datos MySQL”. Allí encontrarás:

Nombre de la base de datos: Normalmente es algo como usuario_nombrebd.
Usuario de la base de datos: Suele ser el mismo que el nombre o uno asociado.
Contraseña: La que configuraste al crear la base de datos.
Servidor (host): Normalmente es localhost o una IP como 127.0.0.1. En algunos hosting compartidos puede ser un nombre como mysql.tudominio.com.

Anota estos datos exactamente como aparecen (respetando mayúsculas, minúsculas y guiones bajos). Son los que necesitarás para el siguiente paso.

Solucionar base datos PrestaShop: Corrigiendo el archivo de configuración

La mayoría de los errores de conexión se solucionan editando el archivo de configuración de PrestaShop. Dependiendo de la versión de PrestaShop que uses, el archivo es diferente.

Para PrestaShop 1.7, 8.x y versiones modernas

El archivo se llama parameters.php y está en la carpeta app/config/. Para editarlo:

Accede a tu hosting mediante FTP (FileZilla, por ejemplo) o desde el Administrador de archivos de Syspanel.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o www).
Abre la carpeta app, luego config.
Busca el archivo parameters.php. Haz clic derecho y selecciona “Editar” o “Ver/Editar”.
Busca las líneas que empiezan con 'database_host', 'database_name', 'database_user', 'database_password' y 'database_port'.

El contenido debería verse así (ejemplo):

'database_host' => 'localhost',
'database_name' => 'tu_usuario_tienda',
'database_user' => 'tu_usuario_tienda',
'database_password' => 'tu_contraseña_segura',
'database_port' => '3306',

Corrige los valores según los datos que anotaste en Syspanel. Presta especial atención a:
- database_host: Si en Syspanel el servidor es localhost, déjalo así. Si te dan una IP o un nombre, ponlo exactamente.
- database_password: Si cambiaste la contraseña desde Syspanel, asegúrate de poner la nueva.
- database_port: Por defecto es 3306. Si tu hosting usa otro puerto (por ejemplo 3307), cámbialo.
Guarda los cambios y cierra el archivo.

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde Syspanel en la sección de bases de datos. Luego actualiza el archivo parameters.php con la nueva contraseña.

Para PrestaShop 1.6 y versiones antiguas

El archivo se llama settings.inc.php y está en la carpeta config/. Los pasos son similares:

Ve a config/settings.inc.php.

Busca las líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_usuario_tienda');
define('_DB_USER_', 'tu_usuario_tienda');
define('_DB_PASSWD_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');

Corrige los valores de _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_ según los datos de Syspanel.
Guarda los cambios.

Soluciones avanzadas cuando el error persiste

Si después de corregir el archivo de configuración el problema continúa, prueba estas opciones:

1. Reinicia los servicios desde Syspanel

A veces el servidor de base de datos se queda colgado. Ve a Syspanel > Servicios y haz clic en “Reiniciar MySQL”. Espera unos segundos y vuelve a cargar tu tienda.

2. Verifica los permisos de la base de datos

Desde Syspanel, en la sección de bases de datos, asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, edita el usuario y marca todas las casillas.

3. Comprueba el archivo .htaccess

Un archivo .htaccess dañado puede causar errores extraños. Renómbralo temporalmente (por ejemplo a .htaccess_backup) y luego accede a tu tienda. Si funciona, ve a Configuración de la tienda > SEO y URLs en el back office y regenera el archivo.

4. Revisa los logs de error

Desde Syspanel, busca la sección “Logs” o “Registros”. Allí verás mensajes detallados del error. Si aparece algo como “Access denied for user”, es un problema de credenciales. Si ves “Can’t connect to MySQL server”, el servidor no está accesible.

[WARNING] Si en los logs ves “Connection refused” o “Host ‘tu_ip’ is not allowed to connect”, puede que tu IP esté bloqueada. En ese caso, desde Syspanel ve a “Base de datos” > “Acceso remoto” y añade tu IP o pon “%” para permitir cualquier IP (solo si es necesario, no es recomendable para producción).

Preguntas frecuentes (FAQ) sobre base datos PrestaShop Syspanel

Aquí respondo las dudas más comunes que nos llegan al soporte.

¿Qué hago si no encuentro el archivo parameters.php?

Si no ves el archivo parameters.php, puede que esté oculto. En tu cliente FTP, activa la opción “Mostrar archivos ocultos”. En Syspanel, en el administrador de archivos, busca el botón que dice “Mostrar archivos ocultos” o “Ver todo”. Si aún así no aparece, es posible que tu instalación de PrestaShop esté dañada; prueba a reinstalar los archivos del núcleo (sin borrar la base de datos).

¿Puedo cambiar el puerto de la base de datos desde Syspanel?

Sí, pero no es común. Por defecto MySQL usa el puerto 3306. Si tu hosting te ha asignado otro puerto (por ejemplo 3307), deberás configurarlo tanto en el archivo parameters.php como en los servicios de Syspanel. Normalmente el soporte técnico te indicará si es necesario.

¿Por qué después de migrar mi tienda a otro servidor aparece el error?

Al migrar, los datos de conexión (servidor, usuario, contraseña) cambian. Debes editar el archivo de configuración con los nuevos datos. Si no lo haces, PrestaShop intentará conectarse al servidor antiguo y fallará.

¿El error de conexión puede borrar mis datos?

No, el error de conexión no borra datos. Solo impide que PrestaShop acceda a la base de datos. Tus productos, clientes y pedidos siguen ahí. Una vez que corrijas la conexión, todo volverá a la normalidad.

¿Qué significa “Table ‘prestashop.ps_xxx’ doesn’t exist”?

Esto indica que una tabla de la base de datos falta o está dañada. Puede ocurrir tras una migración incompleta o un fallo en una actualización. La solución es restaurar una copia de seguridad de la base de datos desde Syspanel (sección “Base de datos” > “Restaurar”). Si no tienes copia, contacta con soporte.

Resumen rápido para solucionar el error

Verifica que el servicio MySQL esté activo en Syspanel (puerto 2106).
Anota los datos exactos de tu base de datos desde Syspanel.
Edita el archivo app/config/parameters.php (o config/settings.inc.php en versiones antiguas) con los datos correctos.
Reinicia el servicio MySQL desde Syspanel.
Revisa los logs si el error persiste.

[TIP] Siempre guarda una copia de seguridad de tu base de datos antes de hacer cambios importantes. En Syspanel puedes hacerlo fácilmente desde la sección “Base de datos” > “Exportar”.

Espero que esta guía te haya sido de ayuda. Si después de seguir todos los pasos el error de conexión a la base datos PrestaShop Syspanel sigue apareciendo, no dudes en contactar con nuestro equipo de soporte técnico. Estaremos encantados de ayudarte a solucionar el error conexión PrestaShop Syspanel de forma personalizada. ¡Tu tienda volverá a funcionar en poco tiempo!