Error de conexión a base de datos en PrestaShop: soluciones

¿Tu tienda PrestaShop ha dejado de funcionar y ves un mensaje como “No se puede conectar a la base de datos” o “Error de conexión MySQL”? No entres en pánico. Este es uno de los problemas más comunes en PrestaShop y, por suerte, en la mayoría de los casos tiene una solución sencilla.

Este error significa que tu tienda no puede comunicarse con la base de datos donde se almacenan tus productos, clientes, pedidos y configuraciones. Sin esa conexión, PrestaShop no puede funcionar.

En esta guía completa, te explicaré paso a paso cómo diagnosticar y solucionar el error base de datos PrestaShop. Vamos a ir desde lo más básico hasta soluciones más avanzadas, siempre con un lenguaje claro y fácil de seguir.

¿Por qué aparece este error? Causas principales

Antes de lanzarnos a solucionarlo, es útil entender por qué ocurre. Las causas más frecuentes son:

Credenciales incorrectas: El nombre de 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.
El servidor MySQL no está funcionando: El servicio de base de datos se ha detenido o ha fallado.
El servidor de base de datos ha cambiado: Por ejemplo, si migraste tu tienda a otro hosting y olvidaste actualizar la dirección del servidor.
Problemas de permisos: El usuario de la base de datos no tiene permisos suficientes para acceder a ella.
Corrupción de archivos: El archivo settings.inc.php (donde se guardan los datos de conexión) está dañado o tiene errores de sintaxis.
Límite de conexiones: El servidor MySQL ha alcanzado el máximo de conexiones simultáneas.

Paso 1: No hagas nada drástico (lo primero es verificar)

Cuando ves este error, lo peor que puedes hacer es reiniciar el servidor o reinstalar PrestaShop sin antes revisar lo básico. Sigue este orden:

1.1 Comprueba si el error es general o puntual

Accede a tu tienda desde otro dispositivo o red (por ejemplo, desde el móvil con datos móviles). Si solo te ocurre a ti, puede ser un problema de tu conexión o caché local. Si el error lo ven todos tus clientes, sigue leyendo.

1.2 Revisa el panel de control de tu hosting

Entra en el panel de control de tu proveedor de hosting (cPanel, Plesk, Syspanel, etc.). Busca una sección llamada “Base de datos” o “MySQL”. Verifica que:

La base de datos existe y no ha sido eliminada por error.
El usuario de la base de datos sigue existiendo.
El usuario está asignado a la base de datos correcta.

[TIP] Si usas Syspanel (anteriormente conocido como HestiaCP), accede a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Allí encontrarás la sección “Base de datos” donde podrás gestionar usuarios y contraseñas.

Paso 2: Localiza y revisa el archivo de configuración de PrestaShop

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

2.1 Accede al archivo

Puedes acceder a él mediante FTP (FileZilla, Cyberduck) o desde el administrador de archivos de tu hosting. La ruta típica es:

/public_html/config/settings.inc.php

Si tu tienda está en una subcarpeta (ejemplo: /tienda/), la ruta será:

/public_html/tienda/config/settings.inc.php

2.2 Abre el archivo con un editor de texto plano

No uses Word ni editores que añadan formato. Usa Notepad++, Sublime Text, o el editor de texto del panel de control.

Dentro del archivo, busca una sección que se parezca a esto (los valores variarán):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_secreta');
define('_DB_PREFIX_', 'ps_');

2.3 Verifica que los datos sean correctos

Comprueba cada línea:

_DB_SERVER_: Normalmente es localhost, pero si tu hosting usa servidores separados, puede ser una IP o un nombre como mysql.tudominio.com.
_DB_NAME_: El nombre exacto de la base de datos (sensible a mayúsculas/minúsculas).
_DB_USER_: El nombre del usuario.
_DB_PASSWD_: La contraseña. Si la cambiaste recientemente, aquí debe estar actualizada.

[WARNING] Si ves caracteres extraños o la contraseña está en blanco, es posible que el archivo se haya dañado. En ese caso, restaura una copia de seguridad o pide a tu hosting que te proporcione los datos correctos.

Paso 3: Prueba la conexión manualmente

Para asegurarte de que el problema no es de PrestaShop sino de la base de datos, puedes hacer una prueba directa.

3.1 Crea un archivo de prueba

Crea un archivo llamado test_db.php en la raíz de tu tienda (junto a la carpeta config). Pega este código:

<?php
$servidor = 'localhost'; // Cámbialo si es necesario
$usuario = 'tu_usuario';
$contraseña = 'tu_contraseña';
$base = 'tu_base_datos';

$conexion = new mysqli($servidor, $usuario, $contraseña, $base);

if ($conexion->connect_error) {
    die("Error de conexión: " . $conexion->connect_error);
} else {
    echo "Conexión exitosa a la base de datos.";
}
$conexion->close();
?>

3.2 Accede al archivo desde el navegador

Ve a http://tudominio.com/test_db.php. Si ves “Conexión exitosa”, el problema está en PrestaShop (archivo de configuración dañado, caché, etc.). Si ves un error como “Access denied” o “Unknown database”, entonces el problema está en las credenciales o en el servidor MySQL.

[INFO] No olvides eliminar test_db.php después de la prueba por seguridad.

Paso 4: Soluciones según el tipo de error

4.1 Error: “Access denied for user”

Esto significa que el usuario o la contraseña son incorrectos.

Soluciones:

Cambia la contraseña desde el panel de control de tu hosting (Syspanel, cPanel, etc.).
Actualiza la contraseña en el archivo settings.inc.php.
Si usas Syspanel, ve a Base de datos > Editar usuario y asigna una nueva contraseña segura.

4.2 Error: “Unknown database”

La base de datos especificada no existe.

Soluciones:

Verifica el nombre exacto en tu panel de control.
Si la base de datos fue eliminada, créala de nuevo con el mismo nombre y restaura una copia de seguridad.
Si migraste tu tienda, asegúrate de que el nombre de la base de datos coincida.

4.3 Error: “Can't connect to MySQL server”

El servidor MySQL no responde.

Soluciones:

Reinicia el servicio MySQL desde tu panel de control (en Syspanel, ve a Servicios > MySQL y haz clic en Reiniciar).
Si no puedes reiniciarlo, contacta con tu proveedor de hosting.
A veces el servidor está sobrecargado; espera unos minutos y vuelve a intentar.

4.4 Error: “Too many connections”

El servidor ha alcanzado su límite de conexiones simultáneas.

Soluciones:

Espera unos minutos y recarga la página.
Si es recurrente, contacta con tu hosting para aumentar el límite.
Revisa si tienes algún plugin o módulo que esté haciendo conexiones excesivas (por ejemplo, un módulo de chat en vivo mal configurado).

Paso 5: Limpia la caché de PrestaShop

A veces, aunque la base de datos funcione, PrestaShop guarda en caché datos antiguos de conexión. Para limpiarla:

5.1 Desde el panel de administración (si puedes acceder)

Ve a Parámetros avanzados > Rendimiento y haz clic en “Limpiar caché”.

5.2 Manualmente (si no puedes acceder al panel)

Conéctate por FTP y elimina el contenido de la carpeta /var/cache/ (todos los archivos y subcarpetas, excepto el archivo index.php). También puedes eliminar la carpeta /cache/smarty/ si existe.

[TIP] Después de limpiar la caché, recarga tu tienda. A veces el error desaparece mágicamente.

Paso 6: Verifica los permisos de archivos

Los permisos incorrectos pueden impedir que PrestaShop lea el archivo settings.inc.php.

El archivo settings.inc.php debe tener permisos 644 o 640 (nunca 777 por seguridad).
La carpeta config debe tener permisos 755.

Puedes cambiarlos desde tu cliente FTP (clic derecho > Permisos de archivo) o desde el administrador de archivos de tu hosting.

Paso 7: Restaura una copia de seguridad

Si has probado todo y nada funciona, es posible que el archivo settings.inc.php esté corrupto o que la base de datos tenga daños. En ese caso:

Restaura una copia de seguridad reciente de la base de datos (desde phpMyAdmin o la herramienta de tu hosting).
Restaura el archivo settings.inc.php desde la misma copia de seguridad.

[WARNING] Siempre haz una copia de seguridad de tu estado actual antes de restaurar.

Paso 8: Contacta con tu proveedor de hosting

Si después de todos estos pasos el error persiste, el problema puede estar en el servidor. Tu hosting puede:

Verificar si el servicio MySQL está caído.
Revisar los logs del servidor para ver errores específicos.
Aumentar los límites de conexión o memoria.
Migrar tu base de datos a un servidor más estable.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si cambio la contraseña de la base de datos?

No. Cambiar la contraseña solo afecta la conexión; los datos permanecen intactos. Solo asegúrate de actualizar la nueva contraseña en el archivo settings.inc.php.

¿Qué hago si no encuentro el archivo settings.inc.php?

Es posible que tu PrestaShop use una versión más reciente (1.7+) donde la configuración se almacena en la base de datos. En ese caso, el error suele deberse a que el servidor MySQL no responde. Contacta con tu hosting.

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

Sí, aunque es menos común. Si el error apareció después de instalar un módulo, desactívalo renombrando su carpeta en /modules/ (por FTP) y prueba de nuevo.

¿Usar Syspanel afecta la solución?

No. Syspanel (puerto 2106) es solo una interfaz para gestionar tu servidor. Los pasos de solución son los mismos que con cPanel o Plesk. La diferencia es que en Syspanel encontrarás las opciones de base de datos en un menú específico.

Conclusión

El error “No se puede conectar a la base de datos” en PrestaShop puede ser frustrante, pero siguiendo esta guía paso a paso podrás resolverlo en la mayoría de los casos. Recuerda siempre empezar por lo más simple: verificar credenciales, comprobar que el servidor MySQL esté activo y limpiar la caché.

Si el problema persiste, no dudes en contactar a tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden detectar problemas que tú no ves desde el panel de control.

Y recuerda: la prevención es clave. Mantén copias de seguridad periódicas de tu base de datos y archivos de configuración. Así, ante cualquier error, podrás recuperar tu tienda en minutos.

¿Tienes alguna duda específica? Déjala en los comentarios y te ayudaré encantado. ¡Buena suerte con tu tienda!