Solucionar error conexión base de datos PrestaShop | Guía rápida

¿Qué significa exactamente el error "PrestaShop no se conecta a la base de datos"?

Cuando tu tienda online muestra un mensaje parecido a "Error de conexión a la base de datos" o "PrestaShop no conecta base datos", significa que tu aplicación no puede comunicarse con el servidor donde están guardados todos tus productos, clientes, pedidos y configuraciones.

Imagina que tu tienda es un restaurante y la base de datos es la cocina. Si la cocina está cerrada o no encuentras al chef, no puedes servir ningún plato. Pues algo parecido ocurre aquí: sin esa conexión, tu tienda se queda completamente bloqueada y los visitantes verán una pantalla de error en lugar de tus productos.

Este es uno de los problemas más comunes en PrestaShop, pero también de los más solucionables si sigues los pasos adecuados. A continuación te explicamos cómo solucionar el error base datos prestashop de forma clara y sin necesidad de ser un experto en programación.

Causas más frecuentes de este error

Antes de lanzarnos a solucionar, es importante entender por qué ocurre. Las causas más habituales son:

Credenciales incorrectas: El usuario o la contraseña de la base de datos han cambiado o están mal escritos en el archivo de configuración.
El servidor de base de datos está caído: El hosting puede tener problemas temporales o el servicio MySQL/MariaDB no está activo.
El nombre de la base de datos es incorrecto: Al migrar de hosting o hacer una copia de seguridad, a veces el nombre cambia.
Archivo de configuración dañado: El archivo parameters.php (en PrestaShop 1.7 y 8) o settings.inc.php (en versiones antiguas) puede tener datos incorrectos.
Permisos de usuario insuficientes: El usuario de la base de datos no tiene permisos para acceder desde el servidor actual.
Cambio de puerto o servidor: Si tu hosting usa un puerto diferente al estándar (3306), la conexión fallará.
Espacio en disco lleno: Aunque menos común, un disco lleno puede impedir que MySQL funcione correctamente.

Paso 1: Verifica si el servidor de base de datos está activo

Lo primero que debes comprobar es si el problema viene de tu hosting o de la configuración de PrestaShop.

Cómo comprobarlo desde el panel de control

Accede a tu panel de control de hosting. Si usas Syspanel (el panel que antes se llamaba HestiaCP y que se accede a través del puerto 2106), sigue estos pasos:

Abre tu navegador y escribe: https://tu-dominio.com:2106
Inicia sesión con tus credenciales de administrador.
Busca la sección de "Bases de datos" o "MySQL".
Comprueba si la base de datos que usa tu PrestaShop aparece en la lista y si el estado es "Activa" o "En ejecución".

[WARNING] Si no ves tu base de datos en la lista, o si el servicio MySQL aparece detenido, contacta con tu proveedor de hosting. No podrás solucionar esto desde PrestaShop.

Comprobación rápida desde el navegador

Otra forma sencilla de comprobar si el servidor de bases de datos responde es crear un archivo de prueba. Pero si no te sientes cómodo con esto, pasa al siguiente paso, que es el más común.

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

Este es el paso más importante cuando PrestaShop no conecta base datos. Aquí es donde se guardan los datos de conexión.

Para PrestaShop 1.7 y versiones superiores (incluida la 8)

El archivo que debes revisar es app/config/parameters.php. Para acceder a él necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu hosting.

Conéctate a tu hosting por FTP.
Navega hasta la carpeta raíz de tu tienda.
Entra en la carpeta app y luego en config.
Busca el archivo parameters.php y descárgalo a tu ordenador.
Ábrelo con un editor de texto como el Bloc de notas o Notepad++.

Dentro verás algo similar a esto:

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

Para PrestaShop 1.6 y versiones anteriores

El archivo es config/settings.inc.php y las líneas que debes buscar son:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

¿Qué datos deben ser correctos?

database_host: Normalmente es localhost o 127.0.0.1. Pero si tu hosting usa servidores separados, puede ser una dirección IP o un nombre como mysql.tudominio.com.
database_port: El puerto estándar es 3306. Algunos hosts usan otros puertos por seguridad.
database_name: El nombre exacto de tu base de datos.
database_user: El usuario con permisos para acceder.
database_password: La contraseña de ese usuario.

[TIP] Si acabas de migrar tu tienda desde otro hosting, es muy probable que estos datos hayan cambiado. Compara con la información que te haya dado tu nuevo proveedor.

Paso 3: Prueba la conexión manualmente

Para saber si el error está en los datos o en otra cosa, puedes probar la conexión directamente. Esto te dirá si el problema es de credenciales o de red.

Opción A: Usando un archivo PHP de prueba

Crea un archivo de texto y nómbralo testdb.php.
Pega este código dentro:

<?php
$host = 'localhost';
$port = '3306';
$dbname = 'tu_base_de_datos';
$user = 'tu_usuario';
$pass = 'tu_contraseña';

try {
    $pdo = new PDO("mysql:host=$host;port=$port;dbname=$dbname", $user, $pass);
    echo "Conexión exitosa a la base de datos";
} catch (PDOException $e) {
    echo "Error: " . $e->getMessage();
}
?>

Sustituye los valores por los que tienes en tu parameters.php.
Sube el archivo a la raíz de tu tienda por FTP.
Ábrelo en el navegador: https://tu-dominio.com/testdb.php

Si ves "Conexión exitosa", el problema está en el archivo de configuración de PrestaShop. Si ves un error, sabrás exactamente qué dato está fallando.

[WARNING] Borra el archivo testdb.php inmediatamente después de hacer la prueba. Dejarlo en el servidor es un riesgo de seguridad grave.

Opción B: Desde Syspanel

Si tu hosting usa Syspanel:

Accede por el puerto 2106.
Ve a la sección de "Bases de datos".
Junto a tu base de datos, suele haber una opción de "phpMyAdmin".
Entra con las mismas credenciales que tienes en tu archivo de configuración.
Si puedes entrar y ver tus tablas, las credenciales son correctas y el problema está en PrestaShop.

Paso 4: Soluciones según el error encontrado

Dependiendo de lo que hayas descubierto, aplica una de estas soluciones:

Si las credenciales son incorrectas

Cambia los datos en el archivo de configuración de PrestaShop.
Guarda el archivo y súbelo de nuevo al servidor.
Recuerda que si usas Windows, el Bloc de notas puede añadir caracteres extraños. Usa un editor como Notepad++ o VS Code.

Si el host no es localhost

Algunos hosting usan servidores de bases de datos separados. En ese caso:

Contacta con tu proveedor y pide el hostname exacto.
Asegúrate de que el puerto sea el correcto.
Actualiza el archivo de configuración con esos datos.

Si el usuario no tiene permisos

Esto pasa mucho después de migrar. Desde Syspanel:

Accede al puerto 2106.
Ve a "Bases de datos".
Selecciona tu base de datos.
Revisa que el usuario asociado tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Si no los tiene, edita y concede todos los permisos.

Paso 5: Regenera el caché y los archivos de PrestaShop

A veces, aunque los datos sean correctos, PrestaShop guarda información antigua en caché. Para forzar la regeneración:

Conéctate por FTP.
Elimina el contenido de la carpeta var/cache (en PrestaShop 1.7 y 8) o cache (en versiones antiguas).
No borres la carpeta en sí, solo su contenido.
Intenta acceder a tu tienda de nuevo.

[INFO] Si no puedes acceder por FTP, también puedes hacerlo desde el administrador de archivos de Syspanel. Accede al puerto 2106, entra en "Administrador de archivos" y navega hasta la carpeta correspondiente.

Paso 6: Comprueba el espacio en disco y los recursos del servidor

Un detalle que muchos pasan por alto: si el disco está lleno, MySQL puede dejar de funcionar.

Entra en Syspanel por el puerto 2106.
Busca la sección de "Estadísticas" o "Uso de recursos".
Comprueba que el espacio en disco no esté al 100%.
Si lo está, elimina archivos temporales, copias de seguridad antiguas o logs.

Paso 7: Restaura desde una copia de seguridad

Si nada de lo anterior funciona, puede que la base de datos esté corrupta o que el archivo de configuración se haya dañado de forma irreparable.

[WARNING] Este paso borrará los cambios realizados desde que se hizo la copia de seguridad. Asegúrate de tener una copia reciente.

Desde Syspanel, ve a "Bases de datos".
Selecciona tu base de datos.
Usa la opción de "Restaurar" y elige la copia de seguridad más reciente.
También restaura los archivos de PrestaShop si tienes una copia completa.

Paso 8: Contacta con tu proveedor de hosting

Si después de todos estos pasos el error persiste, el problema puede ser del servidor. No te frustres: es algo que escapa a tu control.

Cuando contactes con soporte técnico, ten a mano:

El mensaje de error exacto.
Qué pasos ya has probado.
Si el error apareció después de algún cambio (migración, actualización, cambio de contraseña).

[TIP] Muchos problemas de conexión se resuelven simplemente reiniciando el servicio MySQL desde el panel del hosting. Pide que lo hagan si no tienes acceso.

Preguntas frecuentes sobre el error base datos prestashop

¿Puedo perder mis datos si cambio el archivo de configuración?

No. Cambiar las credenciales en parameters.php no borra nada. Solo cambia cómo se conecta PrestaShop a la base de datos. Tus productos y pedidos siguen intactos.

¿Por qué me funciona en local y no en el hosting?

En local usas localhost y en el hosting puede que el servidor de base de datos tenga otro nombre. Además, las contraseñas suelen ser diferentes. Revisa siempre los datos que te da tu proveedor.

¿Cada cuánto debo hacer copias de seguridad?

Idealmente, cada día si tu tienda tiene movimiento. Como mínimo, cada semana. Así, si algo falla, puedes restaurar rápidamente.

¿Es normal que este error aparezca después de una actualización de PrestaShop?

Sí, es bastante común. Las actualizaciones pueden cambiar la estructura de la base de datos o los archivos de configuración. Si el error aparece justo después de actualizar, revisa primero el archivo parameters.php.

Resumen final

El error "PrestaShop no se conecta a la base de datos" puede parecer grave, pero en la mayoría de los casos se soluciona revisando el archivo de configuración y comprobando las credenciales. Sigue estos pasos en orden:

Verifica que el servidor de base de datos está activo.
Revisa el archivo parameters.php o settings.inc.php.
Prueba la conexión manualmente con un archivo de prueba.
Corrige los datos erróneos.
Limpia el caché.
Comprueba el espacio en disco.
Restaura una copia de seguridad si es necesario.
Contacta con soporte si nada funciona.

Con un poco de paciencia y siguiendo esta guía, tu tienda volverá a estar operativa en poco tiempo. Y recuerda: si usas Syspanel, siempre puedes acceder a tu panel de control a través del puerto 2106 para gestionar tus bases de datos de forma cómoda y segura.