Solucionar error de conexión a base de datos en PrestaShop - FAQ

¡Hola! Soy tu técnico de soporte amigable. 😊

Hoy vamos a resolver uno de los errores más frustrantes que puedes encontrar en tu tienda online: el temido error de conexión a la base de datos en PrestaShop. Si ves un mensaje como “Cannot connect to database” o “Error de conexión a la base de datos”, no te preocupes. Aquí te explico paso a paso cómo solucionarlo, de forma sencilla y clara.

Este artículo está pensado para que, incluso si no eres un experto técnico, puedas seguir las instrucciones sin problema. Vamos a dividirlo en secciones fáciles de entender, con listas, alertas y un FAQ al final para resolver tus dudas más comunes.

¿Qué significa este error y por qué ocurre?

El error de conexión a la base de datos en PrestaShop suele aparecer cuando tu tienda no puede comunicarse con el servidor donde se almacenan tus productos, clientes, pedidos y configuraciones. Es como si la llave no encajara en la cerradura.

Las causas más comunes son:

Datos de acceso incorrectos en el archivo de configuración.
El servidor de base de datos está caído o no responde.
Cambios de contraseña en tu panel de hosting (por ejemplo, en Syspanel).
Problemas de permisos del usuario de la base de datos.
Archivos de configuración corruptos después de una migración o actualización.

Vamos a solucionarlo.

Paso 1: Verifica los datos de conexión en PrestaShop

El primer lugar donde debes mirar es el archivo app/config/parameters.php (en PrestaShop 1.7 y versiones posteriores) o config/settings.inc.php (en PrestaShop 1.6). Este archivo contiene toda la información que tu tienda necesita para conectarse a la base de datos.

Cómo acceder al archivo

Conéctate a tu hosting mediante FTP (FileZilla, por ejemplo) o al administrador de archivos de tu panel de control (como Syspanel, al que accedes por el puerto 2106).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Busca el archivo mencionado según tu versión.

[WARNING] Si editas este archivo, haz una copia de seguridad antes. Un cambio incorrecto puede bloquear tu tienda.

¿Qué debes revisar?

Dentro del archivo verás líneas como estas (en parameters.php):

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

Asegúrate de que:

database_host sea correcto (normalmente localhost, pero algunos hosting usan una IP o un nombre como mysql.tudominio.com).
database_name, database_user y database_password coincidan exactamente con los que tienes en tu panel de hosting.
database_port sea el puerto estándar 3306 (a menos que tu hosting use otro).

[TIP] Si no recuerdas tus datos, accede a Syspanel (puerto 2106) y ve a la sección Bases de Datos. Allí podrás ver los nombres de usuario y base de datos, y también restablecer la contraseña.

Paso 2: Verifica el estado del servidor de base de datos

A veces el error no está en tu configuración, sino en que el servidor de MySQL/MariaDB está caído o sobrecargado. Esto puede pasar por mantenimiento del hosting o por un pico de tráfico.

Cómo comprobarlo

Accede a Syspanel (puerto 2106) con tus credenciales de hosting.
Busca la sección Servicios o Estado del servidor.
Verifica que el servicio MySQL o MariaDB esté activo (marcado en verde).
Si está detenido, puedes reiniciarlo desde allí mismo (normalmente hay un botón "Reiniciar" o "Iniciar").

[INFO] Si no ves esta opción, contacta con el soporte de tu hosting. Ellos pueden verificar el estado del servidor por ti.

Paso 3: Cambia la contraseña de la base de datos (si es necesario)

Si sospechas que la contraseña ha cambiado (por ejemplo, después de un restablecimiento en Syspanel), debes actualizarla tanto en el archivo de PrestaShop como en la base de datos.

Pasos desde Syspanel (puerto 2106)

Ve a Bases de Datos > Usuarios.
Selecciona el usuario que usa PrestaShop.
Haz clic en Cambiar contraseña y escribe una nueva (guárdala en un lugar seguro).
Luego, edita el archivo parameters.php o settings.inc.php y actualiza la línea 'database_password' con la nueva contraseña.

[WARNING] Asegúrate de que la contraseña no tenga caracteres especiales que puedan romper el archivo PHP. Usa solo letras, números y guiones bajos.

Paso 4: Verifica los permisos del usuario de la base de datos

El usuario que usa PrestaShop debe tener permisos completos sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si los permisos son limitados, la conexión fallará.

Cómo comprobarlo desde Syspanel (puerto 2106)

Ve a Bases de Datos > Gestión de usuarios.
Busca el usuario que usa PrestaShop.
Asegúrate de que tenga marcados todos los privilegios (o al menos los básicos para una tienda).
Si no, edita y concede los permisos necesarios.

[TIP] Si no estás seguro, puedes crear un nuevo usuario con todos los privilegios y asignarlo a la base de datos. Luego actualiza los datos en el archivo de configuración.

Paso 5: Revisa el archivo .htaccess o problemas de redirección

A veces, un error de conexión puede ser causado por reglas de redirección incorrectas en el .htaccess que impiden que PrestaShop acceda a la base de datos. Esto es más común después de migrar el sitio.

Solución temporal

Conéctate por FTP y renombra el archivo .htaccess a .htaccess_old.
Ve a tu tienda y fuerza la regeneración del archivo desde el back office (Parámetros de la tienda > Tráfico y SEO > Configuración de URL > Guardar).
Si el error desaparece, el problema estaba en el .htaccess. Si no, restaura el archivo original.

[WARNING] No borres el .htaccess definitivamente, ya que contiene reglas importantes de seguridad y SEO. Solo es una prueba.

Paso 6: Verifica la versión de PHP y la compatibilidad

PrestaShop requiere una versión específica de PHP. Si tu hosting actualizó PHP a una versión no compatible, la conexión a la base de datos puede fallar.

Cómo comprobarlo

En Syspanel (puerto 2106), ve a Ajustes de PHP o Gestor de versiones.
Asegúrate de que la versión de PHP sea compatible con tu PrestaShop (por ejemplo, PrestaShop 1.7 funciona bien con PHP 7.4 u 8.0, pero no con PHP 5.6).
Si es necesario, cambia la versión desde el panel.

[INFO] Si tu PrestaShop es muy antiguo, considera actualizarlo. Las versiones obsoletas pueden tener problemas de seguridad y compatibilidad.

Paso 7: Restaura una copia de seguridad reciente

Si has probado todo y el error persiste, es posible que la base de datos esté corrupta. En ese caso, restaurar una copia de seguridad reciente puede ser la solución más rápida.

Cómo restaurar desde Syspanel (puerto 2106)

Ve a Bases de Datos > Copias de seguridad.
Selecciona la copia de seguridad más reciente (idealmente antes de que apareciera el error).
Haz clic en Restaurar.
Luego, verifica que los datos en parameters.php sigan siendo los mismos que los de la copia.

[WARNING] La restauración borrará todos los cambios realizados después de la fecha de la copia. Si has hecho pedidos nuevos, intenta primero otras soluciones.

FAQ: Preguntas frecuentes sobre el error de conexión en PrestaShop

Aquí tienes las dudas más comunes que resuelvo a diario. Si no encuentras la tuya, ¡pregunta en los comentarios!

1. ¿Por qué aparece el error después de cambiar la contraseña en Syspanel?

Porque el archivo de configuración de PrestaShop sigue usando la contraseña antigua. Simplemente actualiza el valor en parameters.php o settings.inc.php con la nueva contraseña.

2. ¿Qué hago si no encuentro el archivo parameters.php?

En PrestaShop 1.6, el archivo se llama config/settings.inc.php. Si usas una versión muy antigua (1.5 o anterior), el archivo puede estar en config/config.inc.php. Busca siempre en la carpeta raíz de tu instalación.

3. ¿Puede un plugin causar este error?

Sí, algunos módulos mal programados pueden modificar la configuración de la base de datos. Si el error aparece justo después de instalar un módulo, desactívalo desde el back office (si puedes acceder) o elimínalo por FTP.

4. ¿El puerto de la base de datos siempre es 3306?

En la mayoría de los casos, sí. Pero algunos hosting usan puertos diferentes (por ejemplo, 3307 o 3308). Revisa la información de tu hosting en Syspanel (puerto 2106) en la sección de bases de datos.

5. ¿Cómo sé si el error es del hosting o de mi configuración?

Prueba a conectar a la base de datos desde una herramienta como phpMyAdmin (disponible en Syspanel). Si puedes acceder con los mismos datos, el problema está en el archivo de PrestaShop. Si no, el problema es del hosting.

6. ¿Qué hago si después de todo sigue sin funcionar?

Contacta al soporte técnico de tu hosting. Diles que tienes un error de conexión a la base de datos en PrestaShop y que ya verificaste los datos, permisos y estado del servidor. Ellos podrán revisar los logs del servidor para encontrar la causa exacta.

Resumen rápido de pasos

Revisa el archivo de configuración (parameters.php o settings.inc.php).
Verifica el estado del servidor en Syspanel (puerto 2106).
Cambia la contraseña si es necesario.
Comprueba los permisos del usuario de la base de datos.
Prueba renombrando el .htaccess.
Ajusta la versión de PHP si es necesario.
Restaura una copia de seguridad como último recurso.

[TIP] Siempre mantén una copia de seguridad actualizada de tu tienda. ¡Te ahorrará muchos dolores de cabeza!

Espero que esta guía te haya sido útil. Recuerda que el error de conexión a la base de datos en PrestaShop suele tener solución rápida siguiendo estos pasos. Si te quedas atascado, no dudes en pedir ayuda a tu hosting o a un técnico especializado.

¡Buena suerte con tu tienda! 🚀