🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Cómo resolver problemas de conexión a base de datos en PrestaShop con Syspanel

Actualizado el 23 de enero de 2026

¿Te ha pasado que al intentar acceder a tu tienda PrestaShop te encuentras con un mensaje de error relacionado con la base de datos? Es uno de los sustos más comunes para cualquier propietario de una tienda online. Ver un error conexión base datos PrestaShop puede ser desesperante, pero no te preocupes: en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo.

En este artículo, te guiaré paso a paso para diagnosticar y resolver cualquier problema de conexión a la base de datos de PrestaShop, especialmente si tu tienda está alojada en un panel de control como Syspanel (el nombre que le damos a HestiaCP). Aprenderás desde lo más básico (verificar credenciales) hasta trucos avanzados como reparar tablas dañadas. Todo explicado de forma clara, sin tecnicismos y pensando en que lo puedas hacer aunque no seas un experto.

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

Antes de lanzarnos a solucionarlo, es útil entender qué significa este error. PrestaShop guarda toda la información de tu tienda (productos, clientes, pedidos, configuraciones) en una base de datos. Cuando la tienda intenta conectarse a esa base y no lo consigue, se muestra un error como:

  • «Error de conexión a la base de datos»
  • «Cannot connect to database»
  • «Error establishing a database connection»

Las causas más frecuentes son:

  • Credenciales incorrectas: El usuario, la contraseña, el nombre de la base de datos o el servidor han cambiado.
  • Servidor de base de datos caído: El servicio MySQL/MariaDB no está funcionando.
  • Tablas dañadas: Después de una actualización o un corte de luz, algunas tablas pueden corromperse.
  • Archivo de configuración dañado: El archivo app/config/parameters.php puede tener información incorrecta.
  • Problemas de permisos: El usuario de la base de datos no tiene permisos suficientes.

Syspanel (HestiaCP) facilita la gestión de estos aspectos, pero a veces un pequeño cambio puede romper la conexión. Vamos a ver cómo solucionarlo.

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

Lo primero es asegurarte de que el motor de base de datos (MySQL o MariaDB) esté activo. Si está apagado, ningún ajuste en los archivos funcionará.

¿Cómo comprobarlo en Syspanel?

  1. Accede a tu panel Syspanel (HestiaCP). Recuerda que la URL suele ser https://tudominio.com:2106 (el puerto es el 2106). Inicia sesión con tu usuario y contraseña de administrador.
  2. En el menú lateral izquierdo, busca la sección «Servidores» o «Servicios».
  3. Verás una lista de servicios. Busca MySQL o MariaDB.
  4. Si el estado es «Running» (verde) o «Activo», está funcionando. Si aparece «Stopped» (rojo), haz clic en el botón «Start» o «Reiniciar» para activarlo.

[TIP] Si no ves la opción de servicios, es posible que tu plan de hosting no te dé acceso directo. En ese caso, contacta con tu proveedor de hosting y pídeles que verifiquen el estado del servicio MySQL.

Paso 2: Localizar y revisar el archivo de configuración de PrestaShop

La configuración de la base de datos de PrestaShop se guarda en un archivo llamado parameters.php. Si los datos son incorrectos, la conexión fallará.

¿Dónde está el archivo?

Está en la carpeta raíz de tu tienda, dentro de app/config/. Por ejemplo, si tu tienda está en /public_html/, la ruta completa sería /public_html/app/config/parameters.php.

¿Cómo acceder a él?

Puedes usar el Administrador de Archivos de Syspanel o un cliente FTP como FileZilla.

  1. En Syspanel, ve a la sección «Archivos» o «File Manager».
  2. Navega hasta la carpeta app/config/.
  3. Busca el archivo parameters.php. Haz clic derecho sobre él y selecciona «Editar».

¿Qué debes comprobar?

Dentro del archivo verás líneas como estas:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Verifica que:

  • database_host: Normalmente es localhost. Si tu base de datos está en un servidor remoto, aquí irá la IP o el nombre del host.
  • database_port: Por defecto es 3306. Si tu hosting usa otro puerto, debe coincidir.
  • database_name: El nombre exacto de la base de datos. En Syspanel, suele ser usuario_nombrebd.
  • database_user: El usuario. Normalmente es el mismo que el nombre de la base de datos.
  • database_password: La contraseña. Asegúrate de que no tenga espacios al principio o al final. Si la cambiaste recientemente, actualízala aquí.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una coma mal puesta) puede romper tu tienda. Si no te sientes seguro, haz una copia de seguridad del archivo antes de editarlo.

Si modificas algo, guarda los cambios y vuelve a cargar tu tienda.

Paso 3: Obtener las credenciales correctas desde Syspanel

A veces, la información del archivo parameters.php está desactualizada. Lo mejor es obtener los datos directamente desde el panel de Syspanel.

¿Cómo ver las credenciales de la base de datos en Syspanel?

  1. Inicia sesión en Syspanel (puerto 2106).
  2. Busca la sección «Base de datos» o «Databases».
  3. Verás una lista de tus bases de datos. Busca la que usa tu PrestaShop (normalmente tiene el mismo nombre que tu usuario o el dominio).
  4. Haz clic en el nombre o en el icono de «Editar» (un lápiz).
  5. Allí aparecerán los datos exactos:
    • Nombre de la base de datos
    • Usuario de la base de datos
    • Contraseña (si no la ves, puedes generar una nueva o copiarla si está visible). Anótala exactamente como aparece.
    • Servidor: Normalmente localhost.

Ahora, vuelve al archivo parameters.php y actualiza estos valores con los que acabas de copiar. Guarda el archivo.

[INFO] Si cambias la contraseña de la base de datos desde Syspanel, debes actualizarla también en parameters.php. De lo contrario, tu tienda dejará de funcionar.

Paso 4: Reparar tablas dañadas de la base de datos

Si el error persiste a pesar de tener las credenciales correctas, es posible que algunas tablas de la base de datos estén dañadas. Esto suele pasar después de una actualización fallida o un corte de energía.

¿Cómo reparar las tablas desde Syspanel?

Syspanel (HestiaCP) no tiene una herramienta gráfica de reparación, pero puedes usar phpMyAdmin, que suele estar instalado.

  1. En Syspanel, busca «phpMyAdmin» en el menú. Si no lo ves, puedes acceder directamente desde https://tudominio.com:2106/phpmyadmin (o preguntar a tu hosting).
  2. Inicia sesión con el usuario y contraseña de la base de datos (los mismos que viste en el paso 3).
  3. En el panel izquierdo, selecciona la base de datos de tu PrestaShop.
  4. Marca la casilla «Seleccionar todo» para elegir todas las tablas.
  5. En el menú desplegable de abajo (junto a «Con seleccionados»), elige «Reparar tabla».
  6. phpMyAdmin ejecutará el comando REPAIR TABLE y te mostrará los resultados. Si alguna tabla no se pudo reparar, te lo indicará.

[TIP] Si la reparación no funciona, puedes intentar «Optimizar tabla» desde el mismo menú. A veces, la optimización también soluciona problemas menores.

Después de reparar, vuelve a cargar tu tienda.

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

El usuario de la base de datos debe tener todos los permisos necesarios para que PrestaShop funcione. Si por error se eliminaron algunos permisos, la conexión puede fallar.

¿Cómo comprobar los permisos en Syspanel?

  1. Ve a «Base de datos» en Syspanel.
  2. Haz clic en «Editar» sobre la base de datos de tu tienda.
  3. Busca la sección de «Usuarios» o «Permisos».
  4. Deberías ver al usuario asociado. Asegúrate de que tenga marcados permisos como:
    • ALL PRIVILEGES (todos los privilegios) o al menos:
    • SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, CREATE TEMPORARY TABLES, LOCK TABLES.

Si no ves estos permisos, selecciona «Todos los privilegios» o marca las opciones necesarias y guarda.

[WARNING] No otorgues permisos a usuarios que no sean de confianza. Solo modifica los permisos del usuario que usa tu PrestaShop.

Paso 6: Probar la conexión manualmente

A veces, el problema no está en PrestaShop sino en la configuración del servidor. Puedes hacer una prueba rápida creando un archivo PHP simple.

¿Cómo crear un archivo de prueba?

  1. Con el Administrador de Archivos de Syspanel, ve a la carpeta raíz de tu tienda (por ejemplo, public_html/).
  2. Crea un nuevo archivo llamado test_db.php.
  3. Pega este código:
<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_basededatos');
if (!$link) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo '¡Conexión exitosa!';
mysqli_close($link);
?>

Recuerda reemplazar 'localhost', 'tu_usuario', 'tu_contraseña' y 'tu_basededatos' con los datos reales de tu base de datos (los mismos del paso 3).

  1. Guarda el archivo.
  2. Accede a él desde tu navegador: https://tudominio.com/test_db.php.

Si ves «¡Conexión exitosa!», significa que la base de datos funciona y el problema está en PrestaShop (probablemente en el archivo parameters.php o en algún módulo).

Si ves un error, anota el mensaje. Puede ser algo como «Access denied for user» (credenciales incorrectas) o «Unknown database» (el nombre de la base está mal).

[INFO] Después de la prueba, elimina el archivo test_db.php de tu servidor por seguridad. No dejes archivos de prueba accesibles públicamente.

Paso 7: Restaurar una copia de seguridad de la base de datos

Si has intentado todo y el error persiste, puede que la base de datos esté tan dañada que sea mejor restaurar una copia de seguridad anterior.

¿Cómo restaurar desde Syspanel?

  1. Ve a «Base de datos» en Syspanel.
  2. Selecciona tu base de datos.
  3. Busca la opción «Copias de seguridad» o «Backups».
  4. Elige una copia de seguridad reciente (anterior al problema) y haz clic en «Restaurar».

Si no tienes copias de seguridad en Syspanel, puedes subir un archivo .sql manualmente desde phpMyAdmin:

  1. Accede a phpMyAdmin.
  2. Selecciona tu base de datos.
  3. Ve a la pestaña «Importar».
  4. Selecciona el archivo .sql de tu copia de seguridad y haz clic en «Continuar».

[WARNING] Restaurar una copia de seguridad sobrescribirá todos los datos actuales. Asegúrate de que la copia sea reciente y no pierdas pedidos o productos importantes.

Preguntas frecuentes (FAQ) sobre errores de conexión a base de datos en PrestaShop

¿Qué hago si veo «Error de conexión a la base de datos» después de mover mi tienda a un nuevo hosting?

Es muy común. Debes actualizar el archivo app/config/parameters.php con las nuevas credenciales de la base de datos del nuevo hosting. Sigue el Paso 2 de esta guía.

¿Puedo cambiar la contraseña de la base de datos desde Syspanel sin que se rompa la tienda?

Sí, pero debes actualizar la contraseña también en el archivo parameters.php. Si no lo haces, la tienda dejará de funcionar. Sigue el Paso 2 y Paso 3.

¿Por qué aparece el error después de una actualización de PrestaShop?

Las actualizaciones a veces modifican la estructura de la base de datos. Si falla la actualización, las tablas pueden quedar dañadas. Prueba el Paso 4 (reparar tablas) y, si no funciona, restaura una copia de seguridad (Paso 7).

¿Qué significa «mysqli_connect(): (HY000/1045): Access denied for user»?

Este error indica que el usuario o la contraseña de la base de datos son incorrectos. Revisa las credenciales en Syspanel (Paso 3) y actualiza el archivo parameters.php (Paso 2).

¿Cómo sé si mi base de datos está en «localhost» o en un servidor remoto?

En la mayoría de los planes de hosting compartido, la base de datos está en localhost. Si tu hosting te proporciona un servidor separado (como mysql.tudominio.com), usa ese valor. En Syspanel, al editar la base de datos, verás el campo «Servidor» o «Host».

¿Puedo usar Syspanel para crear una nueva base de datos y luego conectarla a PrestaShop?

Sí. Ve a «Base de datos» en Syspanel, crea una nueva, anota las credenciales y luego edita el archivo parameters.php de PrestaShop para que apunte a esa nueva base. Luego, tendrás que importar los datos de tu tienda (productos, clientes, etc.) desde una copia de seguridad.

Conclusión

Un error conexión base datos PrestaShop puede ser frustrante, pero como has visto, la mayoría de las veces se soluciona con unos pocos pasos: verificar que el servicio MySQL esté activo, revisar las credenciales en el archivo parameters.php y, si es necesario, reparar las tablas desde phpMyAdmin. Syspanel (HestiaCP) te da todas las herramientas para gestionar tu base de datos de forma sencilla, siempre que sepas dónde mirar.

Recuerda siempre hacer copias de seguridad periódicas de tu base de datos. Así, ante cualquier problema grave, podrás restaurar tu tienda en cuestión de minutos. Si después de seguir todos estos pasos el problema persiste, contacta con tu proveedor de hosting; puede ser un fallo a nivel de servidor que ellos deben resolver.

Espero que esta guía te haya sido de ayuda. ¡Tu tienda online volverá a funcionar en poco tiempo!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel