Error de conexión a base de datos en PrestaShop: Cómo arreglarlo

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, es probable que hayas visto el temido mensaje: "No se puede conectar a la base de datos" en tu tienda PrestaShop. No te preocupes, es uno de los errores más comunes y, con esta guía paso a paso, lo solucionarás en unos minutos. Vamos a desglosar las causas y las soluciones de forma sencilla, como si estuviéramos tomando un café.

¿Qué significa este error?

Cuando PrestaShop intenta cargar tu tienda, necesita comunicarse con una base de datos (normalmente MySQL o MariaDB) para obtener productos, clientes, pedidos, etc. El mensaje "No se puede conectar a la base de datos" indica que esa comunicación falló. Las causas pueden ser varias, desde un cambio de contraseña hasta un archivo de configuración dañado. Lo bueno es que todas tienen solución.

Causas más comunes del error base de datos PrestaShop

Antes de lanzarnos a soluciones técnicas, identifiquemos las causas típicas:

Credenciales incorrectas: La contraseña o el usuario de la base de datos han cambiado (por ejemplo, al migrar de hosting o al restaurar una copia de seguridad).
Archivo de configuración corrupto: El archivo settings.inc.php (donde se guardan los datos de conexión) está dañado o tiene valores erróneos.
Servidor MySQL caído o sobrecargado: El servicio de base de datos no está funcionando en tu servidor.
Permisos de base de datos incorrectos: El usuario de la base de datos no tiene permisos para acceder a la tabla correspondiente.
Problemas de red o firewall: El puerto de MySQL (normalmente 3306) está bloqueado.

Solución paso a paso al error conexión MySQL PrestaShop

Vamos a resolverlo desde lo más simple a lo más complejo. Sigue estos pasos en orden.

1. Verifica que el servidor MySQL esté funcionando

Lo primero es asegurarte de que el servicio de base de datos esté activo. Si usas un panel de control como Syspanel (recuerda: acceso por puerto 2106), puedes hacerlo desde allí.

Accede a Syspanel:

Abre tu navegador y escribe: https://tudominio.com:2106 (sustituye tudominio.com por tu dominio real).
Inicia sesión con tus credenciales de administrador.
Busca la sección de Servicios o Estado del servidor.
Localiza el servicio MySQL o MariaDB y verifica que esté en verde (activo). Si está rojo, haz clic en "Reiniciar" o "Iniciar".

[INFO] Si no tienes acceso a Syspanel, pide a tu proveedor de hosting que verifique el estado del servicio MySQL.

2. Revisa el archivo settings.inc.php PrestaShop

Este archivo es el corazón de la conexión a la base de datos. Se encuentra en la carpeta config/ de tu instalación de PrestaShop. Aquí se guardan el nombre de la base de datos, el usuario, la contraseña y el servidor.

Cómo acceder a settings.inc.php:

Por FTP: Usa un cliente como FileZilla. Conéctate a tu servidor y navega hasta la carpeta config/. Busca el archivo settings.inc.php.
Por el panel de archivos de Syspanel: En Syspanel, ve a Archivos > Administrador de archivos y localiza la misma ruta.

Qué buscar dentro del archivo:
Abre settings.inc.php con un editor de texto (como Notepad++ o el editor integrado en Syspanel). Busca las siguientes líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base');
define('_DB_USER_', 'usuario_de_tu_base');
define('_DB_PASSWD_', 'contraseña_de_tu_base');

Verifica que los datos sean correctos:

DB_SERVER: Normalmente es localhost, pero si tu base de datos está en un servidor remoto, debe ser la IP o el nombre del servidor (ejemplo: mysql.tudominio.com).
DB_NAME: El nombre exacto de tu base de datos (sensible a mayúsculas/minúsculas).
DB_USER: El usuario asociado a esa base de datos.
DB_PASSWD: La contraseña de ese usuario.

[WARNING] Si acabas de restaurar una copia de seguridad o migrar tu tienda, es muy probable que estos datos hayan cambiado. Pide a tu hosting los datos correctos.

Cómo corregir los datos:
Si encuentras un error, simplemente edita las líneas con los valores correctos. Guarda el archivo y luego intenta acceder a tu tienda.

3. Prueba la conexión MySQL manualmente

Para asegurarte de que las credenciales funcionan, puedes hacer una prueba desde la línea de comandos (si tienes acceso SSH) o desde una herramienta como phpMyAdmin.

Opción A: Desde phpMyAdmin (recomendado para principiantes)

En Syspanel, busca phpMyAdmin (suele estar en la sección de bases de datos).
Inicia sesión con el usuario y contraseña que tienes en settings.inc.php.
Si no puedes iniciar sesión, las credenciales son incorrectas. Si sí puedes, el problema está en otro lado.

Opción B: Desde SSH (más avanzado)
Si tienes acceso SSH, ejecuta:

mysql -u usuario -p -h localhost nombre_base

Te pedirá la contraseña. Si el comando falla, el error te dirá si es de autenticación o de conexión.

4. Verifica los permisos del usuario de la base de datos

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para acceder a la base de datos desde el servidor web. Esto es común en migraciones.

Desde phpMyAdmin o Syspanel:

Ve a la sección de Usuarios de bases de datos.
Busca el usuario que aparece en settings.inc.php.
Asegúrate de que tenga todos los privilegios sobre la base de datos (especialmente SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER). Lo más seguro es marcar "Todos los privilegios".
Si el usuario no existe, créalo y asígnale la base de datos correcta.

[TIP] Si usas Syspanel, en la sección "Bases de datos" puedes gestionar usuarios y permisos de forma visual. No olvides que el puerto de acceso es el 2106.

5. Comprueba el puerto y el firewall

Aunque es raro, a veces el puerto de MySQL (3306) está bloqueado por un firewall. Si tu base de datos está en un servidor diferente al de tu web, esto puede ocurrir.

Cómo verificarlo:

Si tienes acceso SSH, ejecuta: telnet localhost 3306 (si falla, el puerto está cerrado).
En Syspanel, revisa la configuración del firewall (suele estar en Seguridad > Firewall). Asegúrate de que el puerto 3306 esté abierto para la IP de tu servidor web.

6. Reconstruye el archivo settings.inc.php

Si el archivo está corrupto o no puedes editarlo correctamente, puedes reconstruirlo desde cero. Necesitarás los datos de conexión correctos.

Pasos:

Haz una copia de seguridad del archivo actual (por si acaso).
Crea un nuevo archivo llamado settings.inc.php con el siguiente contenido (ajusta los valores):

<?php
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base');
define('_DB_USER_', 'usuario_base');
define('_DB_PASSWD_', 'contraseña_base');
define('_DB_PREFIX_', 'ps_');
define('_MYSQL_ENGINE_', 'InnoDB');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');
define('_PS_CACHE_ENABLED_', '0');
define('_MEDIA_SERVER_1_', '');
define('_MEDIA_SERVER_2_', '');
define('_MEDIA_SERVER_3_', '');
define('_COOKIE_KEY_', '');
define('_COOKIE_IV_', '');
define('_PS_CREATION_DATE_', '');
define('_PS_VERSION_', '1.7.8.0'); // Ajusta a tu versión
?>

[WARNING] No copies y pegues sin cambiar los valores. El _DB_PREFIX_ debe coincidir con el de tu base de datos (normalmente ps_). Si no sabes cuál es, mira en tablas existentes.

Sube el archivo a la carpeta config/ de PrestaShop.
Intenta acceder a tu tienda.

7. Restaura una copia de seguridad de la base de datos

Si nada funciona, es posible que la base de datos esté dañada. Restaurar una copia de seguridad reciente puede solucionarlo.

Desde Syspanel:

Ve a Bases de datos > phpMyAdmin.
Selecciona tu base de datos.
Haz clic en Importar y elige el archivo SQL de tu copia de seguridad.
Ejecuta la importación.

Desde SSH:

mysql -u usuario -p nombre_base < ruta/a/tu/copia.sql

8. Contacta a tu proveedor de hosting

Si después de todos estos pasos el error persiste, es hora de pedir ayuda profesional. El problema podría ser un fallo en el servidor que solo tu hosting puede resolver.

Qué decirles:

"Tengo un error base de datos PrestaShop: 'No se puede conectar a la base de datos'."
"Ya verifiqué el archivo settings.inc.php PrestaShop y los datos son correctos."
"¿Podrían revisar el servicio MySQL y los permisos de mi base de datos?"

Preguntas frecuentes (FAQ)

¿Por qué aparece este error después de migrar mi tienda?

Al migrar, las credenciales de la base de datos suelen cambiar. Debes actualizar el archivo settings.inc.php con los nuevos datos.

¿Puedo perder datos si modifico settings.inc.php?

No, el archivo solo contiene la configuración de conexión. Los datos están en la base de datos. Siempre haz una copia de seguridad antes de editarlo.

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

En versiones modernas de PrestaShop (1.7+), a veces el archivo se llama parameters.php o está en app/config/parameters.php. Busca también allí.

¿El error puede ser por un plugin o tema?

Sí, raramente un módulo mal codificado puede corromper la conexión. Prueba a desactivar todos los módulos no esenciales desde la base de datos (vía phpMyAdmin, en la tabla ps_module).

¿Cómo evito este error en el futuro?

Realiza copias de seguridad periódicas de tu base de datos.
Anota las credenciales en un lugar seguro.
Si usas Syspanel, configura alertas para cuando el servicio MySQL se caiga.

Conclusión

El error "No se puede conectar a la base de datos" en PrestaShop es frustrante, pero casi siempre se soluciona revisando el archivo settings.inc.php PrestaShop y verificando que el servidor MySQL esté activo. Con esta guía, tienes todas las herramientas para resolverlo tú mismo.

Recuerda: si usas Syspanel, el acceso es por el puerto 2106 y desde allí puedes gestionar bases de datos, servicios y archivos. ¡No dudes en explorarlo!

Si te ha quedado alguna duda, déjala en los comentarios y te ayudaré encantado. ¡Buena suerte con tu tienda!