Solucionar error 'no conexión base de datos' PrestaShop en Syspanel

¿Qué significa realmente “PrestaShop no tiene conexión con la base de datos”?

Cuando intentas abrir tu tienda online y te aparece un mensaje similar a “PrestaShop no tiene conexión con la base de datos”, o directamente un error de MySQL, significa que tu tienda no puede comunicarse con el servidor donde se guarda toda la información de tus productos, clientes y pedidos.

Este es uno de los errores más comunes en PrestaShop, y puede aparecer tanto en la parte pública de tu tienda como en el panel de administración. La buena noticia es que, en la mayoría de los casos, no has perdido ningún dato y se puede solucionar siguiendo una serie de pasos lógicos.

En este artículo, te voy a explicar de forma clara y sencilla cómo arreglar el error conexión base datos PrestaShop usando tu panel de control Syspanel. No necesitas ser un experto en programación para conseguirlo, solo sigue las instrucciones con calma y en orden.

Antes de empezar: ¿Qué es Syspanel y cómo accedo?

Syspanel es el panel de control de tu hosting, el lugar donde gestionas tus dominios, archivos, bases de datos y cuentas de correo. Es la herramienta que utilizamos en lugar de otros paneles más conocidos como cPanel o HestiaCP.

Para acceder a Syspanel, abre tu navegador y escribe la dirección de tu servidor seguida del puerto 2106. Por ejemplo:

https://tu-servidor.com:2106

[INFO] El puerto 2106 es el acceso exclusivo a Syspanel. Si no lo recuerdas, también puedes encontrarlo en el correo de bienvenida que recibiste al contratar tu hosting o en el área de cliente de tu proveedor.

Una vez dentro, verás un panel con distintas secciones. Las que nos interesan para este tutorial son: Bases de datos y Archivos.

Paso 1: Identificar el origen del problema

Antes de tocar nada, es importante saber que el error “PrestaShop no conecta BD” puede deberse a varias causas:

La base de datos no existe o fue eliminada.
El usuario de la base de datos no tiene permisos o la contraseña es incorrecta.
El servidor de base de datos está caído o saturado.
El archivo de configuración de PrestaShop (parameters.php) contiene datos erróneos.
Los archivos de PrestaShop están corruptos o incompletos.

Vamos a comprobar cada uno de estos puntos paso a paso.

Paso 2: Verifica que la base de datos existe en Syspanel

El primer paso es comprobar que tu base de datos sigue existiendo. Accede a Syspanel y busca la sección Bases de datos o MySQL.

Dentro, deberías ver una lista con todas las bases de datos que tienes. Busca el nombre de la base de datos de tu PrestaShop. Si no aparece, puede que haya sido eliminada accidentalmente o que la hayas creado en otro servidor.

Si la base de datos existe, anota el nombre exacto. Lo necesitarás más adelante.

[WARNING] Si la base de datos no aparece, no intentes crearla tú mismo sin antes contactar con tu proveedor de hosting. Podría ser un problema del servidor y es mejor que lo revise un técnico.

Paso 3: Comprueba el usuario y la contraseña de la base de datos

Otro de los motivos más habituales del error conexión base datos PrestaShop es que la contraseña del usuario de la base de datos haya cambiado o sea incorrecta.

En la misma sección de Bases de datos de Syspanel, verás los usuarios asociados a cada base. Comprueba que:

El nombre de usuario coincide con el que tiene configurado PrestaShop.
El usuario tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).
La contraseña es correcta. Si no la recuerdas, puedes cambiarla desde aquí.

Para cambiar la contraseña, selecciona el usuario y busca la opción de cambiar contraseña. Elige una nueva, guárdala y apúntala en un lugar seguro.

[TIP] Es muy recomendable que después de cambiar la contraseña, la actualices también en el archivo de configuración de PrestaShop. Te explico cómo hacerlo en el siguiente paso.

Paso 4: Revisa el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php. Este archivo se encuentra en la carpeta app/config/ de tu instalación.

Para editarlo, necesitas acceder al Administrador de archivos de Syspanel. Busca la carpeta de tu tienda (normalmente es public_html o una subcarpeta con el nombre de tu dominio).

Dentro, navega hasta app/config/ y busca el archivo parameters.php. Haz clic derecho y selecciona Editar.

Dentro del archivo, busca las líneas que empiezan por database_host, database_name, database_user y database_password. Deben coincidir exactamente con los datos que has verificado en Syspanel.

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

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una comilla mal puesta) puede romper completamente tu tienda. Si no te sientes seguro, contacta con soporte técnico.

Paso 5: Comprueba si el servidor MySQL está activo

A veces el problema no está en tu tienda, sino en el servidor de bases de datos. Esto puede pasar si el servidor se ha reiniciado o ha sufrido una caída.

En Syspanel, busca la sección de Servicios o Estado del servidor. Deberías ver una lista con los servicios disponibles (Apache, MySQL, etc.). Comprueba que el servicio MySQL o MariaDB está activo y funcionando.

Si está detenido, intenta iniciarlo desde el mismo panel. Si no puedes o se detiene de nuevo, contacta con tu proveedor de hosting, ya que podría ser un problema más grave.

Paso 6: Prueba la conexión desde la línea de comandos (opcional)

Si los pasos anteriores no han funcionado, puedes probar la conexión directamente desde la línea de comandos. Esto te dará más información sobre el error exacto.

Accede a Syspanel y busca la opción Terminal o Consola SSH. Una vez dentro, escribe el siguiente comando:

mysql -u tu_usuario -p tu_base_de_datos

Te pedirá la contraseña. Si la conexión es correcta, verás el prompt de MySQL (mysql>). Escríbe exit; para salir.

Si recibes un error de acceso denegado, significa que el usuario o la contraseña no son correctos. Si el error dice que la base de datos no existe, entonces el problema está en el nombre.

Paso 7: Restaura una copia de seguridad (si es necesario)

Si has llegado hasta aquí y aún no has solucionado el error, puede que necesites restaurar una copia de seguridad de tu base de datos. Esto es especialmente útil si sospechas que la base de datos está corrupta o incompleta.

En Syspanel, busca la sección Copias de seguridad o Backups. Ahí deberías ver las copias automáticas que se realizan de tus bases de datos.

Selecciona la copia más reciente y restáurala. Ten en cuenta que esto sobrescribirá los datos actuales, así que asegúrate de que es lo que quieres hacer.

[INFO] Si no tienes una copia de seguridad reciente, contacta con tu proveedor. Puede que ellos tengan una copia en sus servidores.

Solucionar error MySQL PrestaShop: Consejos adicionales

Aquí tienes algunos consejos extra que pueden ayudarte a evitar este error en el futuro:

Realiza copias de seguridad periódicas de tu base de datos y archivos. Puedes configurar copias automáticas en Syspanel.
Anota los cambios de contraseña en un lugar seguro. Si cambias la contraseña de la base de datos, actualiza siempre parameters.php.
Mantén PrestaShop actualizado. Las versiones antiguas pueden tener vulnerabilidades que afecten a la conexión con la base de datos.
Contacta con soporte si el problema persiste. No pierdas tiempo intentando arreglar algo que puede ser un problema del servidor.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si restauro una copia de seguridad?

Sí, al restaurar una copia de seguridad, los datos actuales se sobrescriben con los datos de la copia. Por eso es importante elegir la copia más reciente posible y asegurarte de que es la que necesitas.

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

Si no encuentras el archivo, puede que tu instalación de PrestaShop esté en una carpeta diferente o que el archivo esté oculto. En el administrador de archivos de Syspanel, activa la opción de mostrar archivos ocultos.

¿El error puede deberse a un problema con el dominio?

No, el error de conexión con la base de datos es independiente del dominio. Si el dominio no funciona, verás un error diferente.

¿Cuánto tiempo se tarda en solucionar este error?

Depende de la causa. Si es un problema de contraseña, puedes solucionarlo en menos de 10 minutos. Si es un problema del servidor, puede tardar más y necesitarás la ayuda de tu proveedor.

¿Debo contactar con soporte si no estoy seguro de lo que hago?

Siempre es recomendable contactar con soporte si no estás seguro de los pasos que estás realizando, especialmente si vas a editar archivos de configuración o restaurar copias de seguridad. Un error aquí podría causar más problemas.

Conclusión

El error conexión base datos PrestaShop puede ser frustrante, pero en la mayoría de los casos tiene solución siguiendo los pasos que te he explicado. Recuerda que la clave está en verificar la existencia de la base de datos, comprobar el usuario y la contraseña, y revisar el archivo de configuración.

Con Syspanel tienes todas las herramientas necesarias para gestionar tu base de datos y tus archivos de forma sencilla. No olvides que el acceso es a través del puerto 2106.

Si después de seguir todos estos pasos el problema persiste, no dudes en contactar con tu proveedor de hosting. A veces, el problema puede estar en el servidor y solo un técnico puede solucionarlo.

Espero que este artículo te haya sido de ayuda y que tu tienda vuelva a funcionar correctamente muy pronto. ¡Mucha suerte!