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

Errores de conexión a base de datos en PrestaShop y soluciones

Actualizado el 6 de mayo de 2026

Imagina que estás a punto de abrir tu tienda online en PrestaShop y, de repente, te encuentras con una pantalla en blanco o un mensaje de error que dice algo como “Error de conexión a la base de datos”. No te preocupes, es uno de los problemas más comunes y, por suerte, también de los más fáciles de solucionar. En esta guía extensa y paso a paso, vamos a desglosar las causas más frecuentes de este error y te daremos soluciones prácticas para que tu tienda vuelva a funcionar en minutos.

Vamos a empezar desde lo más básico: entender qué es una base de datos y por qué PrestaShop no puede vivir sin ella. Luego, pasaremos a diagnosticar el problema y aplicar las correcciones, todo explicado en un lenguaje muy sencillo, sin tecnicismos innecesarios. Al final, responderemos a las preguntas más frecuentes que nos hacen los usuarios.

¿Qué significa el error de conexión a la base de datos en PrestaShop?

PrestaShop almacena toda la información de tu tienda (productos, clientes, pedidos, configuraciones) en una base de datos, normalmente MySQL o MariaDB. Cuando tu tienda intenta acceder a esa base de datos y no puede, se produce el famoso error base datos PrestaShop. Puede aparecer de varias formas: un mensaje de error directo, una página en blanco, o incluso un mensaje de instalación (como si la tienda no estuviera configurada).

Las causas más habituales son:

  • Cambio de contraseña de la base de datos.
  • Cambio de servidor o de hosting.
  • Archivos de configuración dañados.
  • Servicio de base de datos detenido.
  • Problemas de permisos.

No entres en pánico. Vamos a solucionarlo paso a paso.

Paso 1: Identificar el tipo de error

Antes de tocar nada, necesitas saber exactamente qué dice el mensaje. Los errores más comunes son:

  • "Error connecting to database": Indica que PrestaShop no puede establecer la conexión con el servidor de base de datos.
  • "Cannot connect to database": Similar al anterior, pero puede deberse a credenciales incorrectas.
  • "Table 'xxxx' doesn't exist": La base de datos está conectada, pero alguna tabla está corrupta o falta.
  • "Access denied for user": El usuario o la contraseña son incorrectos.

[TIP] Anota el mensaje exacto. Te ayudará a buscar la solución específica.

Paso 2: Verificar el archivo de configuración (settings.inc.php)

El archivo más importante para la conexión es app/config/parameters.php (en PrestaShop 1.7 y superiores) o config/settings.inc.php (en versiones antiguas). Aquí es donde se guardan los datos de acceso a la base de datos: servidor, nombre de la base, usuario y contraseña.

Cómo acceder al archivo

  1. Conéctate a tu hosting mediante FTP o el administrador de archivos de tu panel de control (por ejemplo, cPanel o Syspanel, que es el panel que usamos nosotros y al que accedes por el puerto 2106).
  2. Navega hasta la carpeta raíz de tu PrestaShop.
  3. Busca el archivo app/config/parameters.php (o config/settings.inc.php).
  4. Ábrelo con un editor de texto (como Notepad++ o el editor integrado en Syspanel).

Qué buscar dentro

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

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

Comprueba que estos datos sean correctos. Si has cambiado recientemente la contraseña de la base de datos, aquí es donde debes actualizarla.

[WARNING] Si haces cambios, guarda una copia de seguridad del archivo original antes de modificarlo.

Paso 3: Comprobar que el servicio de base de datos está activo

A veces el problema no está en tu tienda, sino en el servidor. Si el servicio MySQL/MariaDB está caído, PrestaShop no podrá conectarse.

Cómo verificarlo desde tu panel de hosting

Si usas Syspanel (puerto 2106):

  1. Inicia sesión en tu Syspanel (ejemplo: https://tudominio.com:2106).
  2. Ve a la sección de Servicios o Base de datos.
  3. Busca el servicio MySQL/MariaDB y comprueba que esté en verde (activo).
  4. Si está rojo, haz clic en Reiniciar.

Si no tienes acceso a Syspanel, contacta con tu proveedor de hosting y pregunta si el servicio de base de datos está funcionando.

[INFO] En la mayoría de los hosting compartidos, el servicio siempre está activo. Pero en servidores VPS o dedicados, puede detenerse por falta de recursos o errores.

Paso 4: Probar la conexión manualmente

Una forma rápida de saber si el problema es de credenciales o de servidor es probar la conexión desde fuera de PrestaShop.

Usando phpMyAdmin (desde tu panel)

  1. Accede a phpMyAdmin desde tu panel de control (Syspanel, cPanel, etc.).
  2. Intenta iniciar sesión con el usuario y contraseña que tienes en parameters.php.
  3. Si no puedes entrar, las credenciales son incorrectas o el usuario no tiene permisos.

Usando un script simple

Crea un archivo llamado test.php en la raíz de tu tienda con este contenido:

<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'nombre_de_tu_base');
if (!$link) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo 'Conexión exitosa';
mysqli_close($link);
?>

Sustituye los datos por los tuyos. Luego accede a tudominio.com/test.php. Si ves "Conexión exitosa", el problema está en PrestaShop, no en la base de datos. Si ves un error, tienes las credenciales mal.

[WARNING] Borra este archivo después de usarlo por seguridad.

Paso 5: Solucionar problemas comunes

5.1. Contraseña incorrecta o usuario cambiado

Es el error más frecuente. Si cambiaste la contraseña de la base de datos desde tu panel, debes actualizarla también en parameters.php. Si no recuerdas la contraseña, puedes resetearla desde tu panel de hosting (Syspanel: Base de datos -> Usuarios -> Cambiar contraseña).

5.2. Nombre de la base de datos incorrecto

A veces, al migrar de hosting, el nombre de la base cambia. Revisa que el nombre en parameters.php coincida exactamente con el que ves en tu panel.

5.3. Servidor de base de datos no es "localhost"

En algunos hosting, el servidor de base de datos no es localhost sino una dirección IP o un nombre como mysql.tudominio.com. Pregunta a tu proveedor o revisa la documentación.

5.4. Tablas corruptas

Si el error dice "Table doesn't exist" o "Table is marked as crashed", puedes repararlas desde phpMyAdmin:

  1. Selecciona la base de datos.
  2. Marca todas las tablas.
  3. En el menú desplegable, elige "Reparar tabla".

5.5. Problemas de permisos de usuario

El usuario de la base de datos debe tener todos los privilegios sobre la base. Desde Syspanel, ve a Base de datos -> Usuarios y asegúrate de que tenga permisos totales (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).

Paso 6: Restaurar desde una copia de seguridad

Si nada funciona y tienes una copia de seguridad reciente, puedes restaurar la base de datos. Esto es útil si el error apareció después de una modificación o ataque.

Cómo restaurar desde phpMyAdmin

  1. Accede a phpMyAdmin.
  2. Selecciona la base de datos.
  3. Haz clic en Importar.
  4. Sube tu archivo .sql y ejecuta.

[TIP] Siempre ten una copia de seguridad semanal de tu base de datos. En Syspanel puedes programar backups automáticos.

Paso 7: Reinstalar PrestaShop (último recurso)

Si después de todo sigues con el error, puede que los archivos de PrestaShop estén dañados. Entonces, lo mejor es hacer una instalación limpia:

  1. Descarga la última versión de PrestaShop.
  2. Sube los archivos a tu servidor (sobrescribiendo los existentes, pero sin borrar la carpeta img ni modules si quieres conservar datos).
  3. Durante la instalación, elige "Actualizar" y conecta con la misma base de datos.

Esto reparará los archivos de configuración sin perder productos ni clientes.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error después de cambiar de hosting?

Es muy común. Al migrar, las credenciales de la base de datos cambian. Debes actualizar parameters.php con los nuevos datos.

¿Puedo solucionarlo sin acceso al panel de control?

Si no tienes acceso FTP ni a phpMyAdmin, contacta con tu proveedor de hosting. Ellos pueden verificar la conexión por ti.

¿El error puede deberse a un plugin o módulo?

Sí, algunos módulos mal programados pueden saturar la base de datos. Si el error aparece después de instalar un módulo, desactívalo desde la base de datos (cambiando el estado en la tabla ps_module).

¿Cómo evito este error en el futuro?

  • Realiza copias de seguridad periódicas.
  • No cambies contraseñas sin actualizar el archivo de configuración.
  • Mantén PrestaShop actualizado.
  • Usa un hosting confiable con soporte técnico.

¿Syspanel puede ayudarme a diagnosticar el error?

Sí, desde Syspanel (puerto 2106) puedes acceder a phpMyAdmin, ver el estado de los servicios y gestionar usuarios de base de datos. Es la herramienta ideal para este tipo de problemas.

Conclusión

El error base datos PrestaShop es un contratiempo, pero con estos pasos puedes resolverlo tú mismo en la mayoría de los casos. Recuerda siempre empezar por lo más simple: verificar las credenciales en parameters.php y comprobar que el servicio de base de datos esté activo. Si todo falla, no dudes en pedir ayuda a tu hosting o en los foros de PrestaShop.

Esperamos que esta guía te haya sido útil. Si tienes más dudas, déjalas en los comentarios o consulta nuestra sección de ayuda. ¡Tu tienda online volverá a funcionar en un abrir y cerrar de ojos!

¿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