Error de conexión a base de datos en PrestaShop Syspanel | Solución

¡Hola! Soy tu técnico de soporte amigable. Entiendo que ver un error de conexión a la base de datos en PrestaShop puede ser frustrante, especialmente si no eres un experto técnico. No te preocupes, estoy aquí para guiarte paso a paso para que puedas solucionarlo de forma clara y sencilla.

En este artículo, vamos a centrarnos en resolver el temido error base datos PrestaShop, específicamente cuando aparece en el contexto de un panel de control conocido como Syspanel PrestaShop error. Aprenderemos qué significa, por qué ocurre y, lo más importante, cómo solucionarlo para que tu tienda vuelva a funcionar.

[INFO] A lo largo de esta guía, cuando hablemos del panel de control que usamos para gestionar tu servidor, lo llamaremos "Syspanel". Recuerda que el acceso a Syspanel es a través del puerto 2106 (por ejemplo, tudominio.com:2106 o tu-ip:2106).

¿Qué significa este error y por qué es urgente solucionarlo?

El error conexión base datos PrestaShop es un aviso que indica que tu tienda online no puede comunicarse con el lugar donde guarda toda su información (productos, clientes, pedidos, configuraciones). Sin esta conexión, PrestaShop simplemente no puede cargar.

Cuando ves un mensaje como "Error de conexión a la base de datos" o "No se puede conectar con la base de datos", tu tienda se vuelve inaccesible para ti y tus clientes. Es como si la llave de tu tienda física no abriera la puerta. Por eso, solucionar PrestaShop es una prioridad.

Las causas más comunes 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 de PrestaShop.
Servidor de base de datos caído o sobrecargado: El servicio que gestiona las bases de datos (normalmente MySQL o MariaDB) se ha detenido o está respondiendo muy lento.
Problemas de permisos: El usuario de la base de datos no tiene permisos para acceder a ella desde el servidor web.
Cambios en el servidor: Has migrado tu tienda a otro hosting, has cambiado la IP del servidor o has reinstalado el sistema operativo.
Archivo de configuración dañado: El archivo app/config/parameters.php (en versiones recientes de PrestaShop) o config/settings.inc.php (en versiones antiguas) está corrupto o incompleto.

Preparación: Acceso a Syspanel y herramientas necesarias

Antes de empezar, necesitas tener a mano dos cosas:

Acceso a Syspanel: Abre tu navegador y escribe tudominio.com:2106 o tu-ip-del-servidor:2106. Introduce tu usuario y contraseña de administrador de Syspanel.
Acceso FTP (o gestor de archivos de Syspanel): Necesitarás poder ver y editar archivos de tu tienda. Puedes usar un cliente FTP (como FileZilla) o el gestor de archivos integrado en Syspanel (normalmente en la sección "Archivos" o "File Manager").

[WARNING] Antes de hacer cualquier cambio, siempre es recomendable hacer una copia de seguridad de tu base de datos y de los archivos de configuración. En Syspanel, puedes hacer una copia de seguridad completa desde la sección "Backup". Si algo sale mal, podrás restaurarlo.

Paso 1: Verificar que el servicio de base de datos esté funcionando

El primer paso para solucionar PrestaShop es asegurarte de que el motor de base de datos esté activo.

Inicia sesión en Syspanel (puerto 2106).
Busca la sección "Servicios" o "Service Status". Normalmente está en el menú principal o en el panel de inicio.
Localiza el servicio llamado "MySQL" o "MariaDB".
Verifica que su estado sea "Running" (en ejecución) o "Active".
Si aparece como "Stopped" (detenido), haz clic en el botón "Start" o "Iniciar" para arrancarlo.
Después de iniciarlo, intenta acceder a tu tienda PrestaShop de nuevo.

[TIP] Si el servicio se detiene constantemente, puede ser un problema de falta de memoria RAM o un error en la configuración del servidor. En ese caso, contacta con tu proveedor de hosting o con el administrador del sistema.

Paso 2: Comprobar las credenciales en el archivo de configuración

Si el servicio está activo, el problema suele estar en las credenciales. PrestaShop guarda esta información en un archivo de texto. Vamos a revisarlo.

Para PrestaShop 1.7 y versiones superiores (más comunes hoy en día)

Conéctate por FTP a tu servidor o usa el Gestor de Archivos de Syspanel.
Navega hasta la carpeta raíz de tu tienda (donde están las carpetas admin, themes, modules, etc.).
Abre la carpeta app/config/.
Busca el archivo parameters.php.
Descarga una copia a tu ordenador por seguridad (o renómbralo a parameters_backup.php).
Abre el archivo parameters.php con un editor de texto simple (como Notepad, Sublime Text, o el editor integrado de Syspanel). No uses Word o procesadores de texto, ya que pueden añadir formato extraño.

Busca estas líneas (deberían verse similares):

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_de_tu_base_de_datos',
'database_user' => 'usuario_de_la_base',
'database_password' => 'contraseña_super_segura',
'database_prefix' => 'ps_',

Verifica que los valores sean correctos:
- database_host: Normalmente es localhost si la base de datos está en el mismo servidor que PrestaShop. Si tu base de datos está en un servidor externo, aquí deberá ir la IP o nombre del host.
- database_name: El nombre exacto de la base de datos. Puedes encontrarlo en Syspanel, en la sección "Bases de datos" o "Databases".
- database_user: El nombre de usuario asociado a esa base de datos. También lo ves en Syspanel.
- database_password: Este es el punto más común de error. La contraseña debe coincidir exactamente con la que pusiste al crear el usuario en Syspanel. Si no la recuerdas, tendrás que cambiarla (lo veremos en el Paso 3).
Si encuentras algún error, corrígelo y guarda el archivo. Luego, sube el archivo modificado al servidor (si usaste FTP) o guarda los cambios (si usaste el editor de Syspanel).

Para PrestaShop 1.6 o versiones anteriores

El proceso es similar, pero el archivo se encuentra en la raíz de tu tienda y se llama config/settings.inc.php. Ábrelo y busca las líneas que empiezan por define('_DB_SERVER_',, define('_DB_NAME_',, define('_DB_USER_', y define('_DB_PASSWD_',. Corrige los valores de la misma manera.

[WARNING] Después de editar el archivo, no olvides guardar los cambios. Si usas FTP, asegúrate de subir el archivo correctamente y sobrescribir el antiguo.

Paso 3: Restablecer la contraseña de la base de datos (si no la recuerdas)

Si no estás seguro de la contraseña del usuario de la base de datos, la opción más segura es cambiarla desde Syspanel.

En Syspanel, ve a la sección "Bases de datos" o "Databases".
Busca la base de datos que usa tu PrestaShop (debe coincidir con el database_name que viste en el paso anterior).
Busca el usuario asociado a esa base de datos.
Haz clic en "Editar" o "Edit User" (normalmente hay un icono de lápiz).
En el campo de "Contraseña" o "Password", escribe una nueva contraseña segura. Puedes usar el generador de contraseñas que suele incluir Syspanel.
Guarda los cambios.
Ahora, repite el Paso 2 y actualiza la contraseña en el archivo parameters.php o settings.inc.php con la nueva contraseña que acabas de crear.

[INFO] Al cambiar la contraseña desde Syspanel, el sistema automáticamente actualiza los permisos. Solo necesitas reflejar ese cambio en el archivo de configuración de PrestaShop.

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

A veces, el usuario tiene acceso a la base de datos pero no los permisos suficientes (por ejemplo, no puede leer o escribir tablas).

En Syspanel, ve a "Bases de datos".
Busca la base de datos de tu PrestaShop.
Busca la opción "Gestionar permisos" o "Manage Privileges".
Asegúrate de que el usuario tenga todos los privilegios marcados (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, etc.). La opción más fácil es marcar "ALL PRIVILEGES" o "Todos los privilegios".
Guarda los cambios.

Paso 5: Comprobar el archivo .htaccess (en casos raros)

En ocasiones, el archivo .htaccess de PrestaShop puede tener reglas que bloqueen la conexión a la base de datos (aunque es poco común). Si los pasos anteriores no funcionan, puedes probar esto:

Conéctate por FTP a la raíz de tu tienda.
Renombra el archivo .htaccess a .htaccess_backup (esto lo desactivará temporalmente).
Intenta acceder a tu tienda. Si funciona, el problema está en el .htaccess.
No te preocupes, no necesitas borrarlo. Ve a tu panel de administración de PrestaShop (si puedes acceder) y ve a "Configuración de la tienda" > "Tráfico y SEO" > "URLs amigables". Desmarca y vuelve a marcar la opción "URLs amigables" y guarda. Esto regenerará el .htaccess de forma correcta.
Si no puedes acceder al panel de admin, tendrás que editar manualmente el .htaccess o restaurar una copia de seguridad.

Paso 6: Revisar los logs del servidor (para usuarios más avanzados)

Si nada de lo anterior funciona, el problema puede ser más profundo. Los logs (registros) del servidor pueden darte pistas.

En Syspanel, busca la sección "Logs" o "Registros".
Busca los logs de "MySQL" o "MariaDB".
También puedes revisar los logs de errores de Apache/Nginx (el servidor web).
Busca errores como Access denied for user, Can't connect to MySQL server, o Unknown database. Estos mensajes te dirán exactamente qué está mal.

[TIP] Si ves un error de Access denied, significa que el usuario o contraseña son incorrectos (vuelve al Paso 2). Si ves Can't connect, el servicio no está corriendo (Paso 1) o el host es incorrecto.

Preguntas Frecuentes (FAQ) para solucionar PrestaShop

P: ¿Por qué aparece el error después de migrar mi tienda a un nuevo hosting?
R: Es muy común. Al migrar, cambian los datos de conexión (host, usuario, contraseña). Debes actualizar el archivo app/config/parameters.php con los nuevos datos que te proporcione tu nuevo hosting. Asegúrate también de que la base de datos se haya importado correctamente.

P: ¿Puedo solucionar este error sin perder datos?
R: Sí, en la gran mayoría de los casos. Este error no borra tus productos ni clientes; solo impide que PrestaShop se conecte a la base de datos donde están guardados. Una vez que corrijas la conexión, tu tienda volverá a la normalidad con todos los datos intactos.

P: ¿Qué hago si el archivo parameters.php está vacío o dañado?
R: Si el archivo está dañado, no podrás editarlo. La mejor solución es restaurar una copia de seguridad de ese archivo. Si no tienes copia, puedes crear uno nuevo desde cero, pero necesitarás saber los datos de conexión exactos. Otra opción es reinstalar PrestaShop, pero esto borrará todos tus datos a menos que tengas una copia de seguridad de la base de datos.

P: ¿Cómo accedo a Syspanel si no recuerdo la contraseña?
R: En la pantalla de inicio de sesión de Syspanel (puerto 2106), suele haber un enlace de "¿Olvidaste tu contraseña?". Si no funciona, contacta con tu proveedor de hosting, ya que ellos pueden restablecerla.

P: ¿El error puede deberse a un plugin o módulo de PrestaShop?
R: Es posible, pero poco probable. Los módulos no suelen modificar los datos de conexión a la base de datos. Sin embargo, un módulo mal programado podría sobrecargar el servidor de base de datos, provocando un error temporal. Si el error aparece justo después de instalar un módulo, desactívalo (renombra la carpeta del módulo en /modules/ por FTP) y prueba de nuevo.

Conclusión: Resumen para solucionar el error de conexión

Para solucionar PrestaShop cuando aparece el error de base de datos, sigue esta checklist:

Verifica el servicio MySQL/MariaDB en Syspanel (puerto 2106) -> debe estar "Running".
Revisa y corrige las credenciales en app/config/parameters.php (o config/settings.inc.php).
Restablece la contraseña desde Syspanel si no la recuerdas y actualízala en el archivo.
Confirma los permisos del usuario de la base de datos (debe tener todos los privilegios).
Comprueba los logs si el error persiste.

No te desanimes. La mayoría de las veces, el error se soluciona en los primeros dos pasos. Si has seguido toda la guía y el problema continúa, puede ser un fallo más complejo del servidor. En ese caso, no dudes en contactar con el soporte técnico de tu hosting, proporcionándoles esta información: "Error de conexión a la base de datos en PrestaShop, he verificado credenciales y servicio en Syspanel, pero sigue sin funcionar".

¡Espero que esta guía te haya sido de gran ayuda! Recuerda que siempre estoy aquí para ayudarte a resolver cualquier duda técnica. ¡Mucha suerte con tu tienda!