Error de conexión a base de datos en PrestaShop: Solución definitiva

¿Qué significa el error "No se pudo conectar a la base de datos" en PrestaShop?

Si ves el mensaje "No se pudo conectar a la base de datos" (o su versión en inglés, "Error connecting to the database"), significa que tu tienda PrestaShop no puede comunicarse con el servidor donde se almacenan todos tus productos, pedidos y clientes. Es uno de los errores más comunes y, aunque parece grave, en la mayoría de los casos tiene una solución sencilla.

Este error puede aparecer en dos momentos concretos: durante la instalación de PrestaShop o, de repente, en una tienda que ya estaba funcionando. Las causas pueden ir desde un cambio de contraseña de la base de datos hasta un archivo de configuración corrupto, pasando por problemas con el servidor o los permisos de los archivos.

En esta guía completa, te explicamos paso a paso cómo diagnosticar y solucionar el error base de datos prestashop, incluso si no tienes experiencia técnica. Vamos a ello.

Primero: entiende qué son los datos de conexión

Antes de empezar a tocar nada, es fundamental que entiendas qué necesita PrestaShop para conectarse a su base de datos. Es como una llave que abre una puerta: si la llave no encaja, no puedes entrar.

Los datos que PrestaShop necesita son:

Servidor de base de datos (normalmente localhost o una IP como 127.0.0.1)
Nombre de la base de datos (ejemplo: prestashop_db)
Usuario de la base de datos (ejemplo: admin_tienda)
Contraseña del usuario (la contraseña asociada a ese usuario)
Prefijo de las tablas (normalmente ps_, pero puede variar)

Todos estos datos están guardados en un archivo llamado parameters.php que se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Si este archivo tiene datos incorrectos, tu tienda no podrá conectar.

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

El error prestashop no conecta base datos puede deberse simplemente a que el servidor de bases de datos (MySQL o MariaDB) está caído o en mantenimiento. Esto puede pasar si tu proveedor de hosting está realizando tareas de mantenimiento o si el servidor ha excedido su límite de conexiones.

Para comprobarlo, puedes hacer lo siguiente:

Entra en el panel de control de tu hosting (cPanel, Plesk, Syspanel o el que uses).
Busca la sección de "Bases de datos" o "MySQL".
Verifica que el servicio aparece como "Activo" o "Running".
Si aparece como "Detenido", intenta reiniciarlo desde el mismo panel.

[TIP] Si tu hosting usa Syspanel, recuerda que el acceso se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Allí encontrarás todas las opciones de gestión de bases de datos.

Si el servidor está activo y el error persiste, continúa con el siguiente paso.

Paso 2: Comprueba el archivo parameters.php

Como mencionamos antes, el archivo parameters.php contiene los datos de conexión. A veces, tras una actualización de PrestaShop, un cambio de contraseña en el hosting o una migración, estos datos quedan desactualizados.

¿Cómo acceder al archivo?

Conéctate a tu servidor mediante FTP o el administrador de archivos de tu hosting.
Navega a la carpeta app/config/ en la raíz de tu instalación de PrestaShop.
Busca el archivo parameters.php y descárgalo a tu ordenador.
Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text).

¿Qué debo buscar?

Dentro del archivo, verás una línea similar a esta:

'database_host' => 'localhost',
'database_name' => 'mi_base_de_datos',
'database_user' => 'mi_usuario',
'database_password' => 'mi_contraseña',

Comprueba que estos valores coinciden exactamente con los datos de tu base de datos. Un error típico es que la contraseña contenga caracteres especiales (como @, #, $) que no se han escapado correctamente.

[WARNING] Si la contraseña contiene caracteres especiales, debes escaparlos con una barra invertida (\). Por ejemplo, si tu contraseña es p@ssw0rd, en el archivo debe aparecer como p\@ssw0rd. Si no lo haces, PrestaShop no podrá conectarse.

Si has encontrado algún error y lo has corregido, guarda el archivo y súbelo de nuevo al servidor. Luego, prueba a cargar tu tienda.

Paso 3: Verifica los permisos de los archivos

Otra causa común del solucion error conexion prestashop son los permisos incorrectos en archivos y carpetas. Si los permisos son demasiado restrictivos, PrestaShop no puede leer el archivo de configuración.

Los permisos recomendados son:

Archivos: 644 (lectura y escritura para el propietario, lectura para el grupo y el resto)
Carpetas: 755 (lectura, escritura y ejecución para el propietario, lectura y ejecución para el resto)

Para cambiarlos:

Usa tu cliente FTP (por ejemplo, FileZilla).
Selecciona todos los archivos y carpetas de tu instalación de PrestaShop.
Haz clic derecho y elige "Permisos de archivos" o "Atributos".
Introduce el valor correcto (644 para archivos, 755 para carpetas).
Asegúrate de marcar la opción "Aplicar a todos los archivos y carpetas subordinados".

[TIP] Si no sabes qué permisos tiene cada archivo, en FileZilla puedes verlo en la columna "Permisos". Un valor como -rw-r--r-- significa 644, y drwxr-xr-x significa 755.

Paso 4: Revisa si el problema es solo de caché

A veces, el error aparece porque PrestaShop guarda en caché datos antiguos de conexión. Esto ocurre especialmente después de actualizar la versión o cambiar los datos de la base de datos.

Para limpiar la caché:

Accede a tu servidor por FTP.
Navega a la carpeta var/cache (en versiones antiguas, cache).
Elimina todos los archivos y carpetas que encuentres dentro (pero no la carpeta en sí).
Vuelve a cargar tu tienda.

Si no puedes acceder por FTP, también puedes hacerlo desde el panel de administración de PrestaShop, pero como el error impide la conexión, lo más probable es que tengas que hacerlo por FTP.

[INFO] Si después de borrar la caché el error persiste, es posible que el problema no sea de caché sino de configuración. Sigue leyendo.

Paso 5: Comprueba el usuario y los privilegios de la base de datos

Es posible que los datos de conexión sean correctos, pero el usuario de la base de datos no tenga los permisos necesarios para acceder a ella. Esto es más común de lo que parece, sobre todo tras migraciones.

Para verificarlo:

Entra en Syspanel (puerto 2106) o en el gestor de bases de datos de tu hosting (phpMyAdmin, por ejemplo).
Busca la base de datos que usa PrestaShop.
Revisa que el usuario que aparece en parameters.php tiene asignados todos los privilegios sobre esa base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Si no los tiene, edítalos y concede todos los permisos.

[WARNING] Si estás usando un hosting compartido, es habitual que el usuario de la base de datos tenga un prefijo (por ejemplo, usuario123_bd). Asegúrate de que en el archivo parameters.php estás usando el nombre completo con el prefijo, no solo la parte final.

Paso 6: Verifica que el servidor de base de datos es correcto

En la mayoría de los casos, el servidor de base de datos es localhost. Sin embargo, algunos proveedores de hosting utilizan un servidor externo (por ejemplo, mysql.tudominio.com o una IP).

Si has cambiado recientemente de hosting o de plan, es posible que el servidor haya cambiado. Consulta la documentación de tu proveedor o el panel de control para confirmar cuál es el servidor correcto.

Si el servidor es externo, puedes probar a conectarte desde tu ordenador usando un cliente MySQL como HeidiSQL o MySQL Workbench. Si no puedes conectar desde tu ordenador, es probable que el puerto 3306 esté bloqueado por el firewall, y deberías contactar con el soporte de tu hosting.

Paso 7: Revisa los logs de errores

PrestaShop guarda registros de errores que pueden darte pistas sobre la causa exacta del problema. Para acceder a ellos:

Ve a la carpeta var/logs de tu instalación.
Busca archivos con nombres como prod.log o dev.log.
Ábrelos con un editor de texto y busca la línea que menciona "database" o "connection".

Los mensajes típicos suelen incluir:

SQLSTATE[HY000] [1045] Access denied for user → Problema de credenciales.
SQLSTATE[HY000] [2002] Connection refused → El servidor no acepta conexiones.
SQLSTATE[HY000] [2003] Can't connect to MySQL server → El servidor no está accesible.

[TIP] Si no encuentras los logs, puedes activar el modo de depuración temporalmente editando el archivo config/defines.inc.php y cambiando _PS_MODE_DEV_ de false a true. Luego, carga tu tienda y verás el error detallado en pantalla. Recuerda volver a ponerlo en false al terminar.

Paso 8: Reinstala los archivos de configuración (último recurso)

Si ningún paso anterior ha funcionado, puede que la instalación de PrestaShop esté dañada. En este caso, la solución más segura es restaurar una copia de seguridad reciente de los archivos y la base de datos.

Haz una copia de seguridad de tu base de datos actual (por si acaso).
Descarga una copia de seguridad de tus archivos (de antes de que empezara el error).
Restaura los archivos en tu servidor.
Importa la copia de seguridad de la base de datos.
Prueba a cargar tu tienda.

Si no tienes copias de seguridad, puedes intentar reinstalar PrestaShop sin borrar la base de datos. Para ello:

Descarga la misma versión de PrestaShop que tienes instalada.
Descomprime los archivos y sube solo la carpeta app y config (sobrescribiendo los existentes).
No subas la carpeta install (para evitar que se reinstale desde cero).

Preguntas frecuentes (FAQ)

¿El error "No se pudo conectar a la base de datos" puede estar causado por un plugin?

Sí, aunque es poco frecuente. Algunos módulos mal codificados pueden sobrescribir la configuración de conexión. Si el error apareció tras instalar un módulo, desactívalo eliminando su carpeta en /modules.

¿Puedo solucionar el error si no tengo acceso por FTP?

Si no tienes acceso por FTP, contacta con tu proveedor de hosting. Ellos pueden verificar los archivos y la base de datos por ti. Si usas Syspanel, puedes acceder al administrador de archivos desde el propio panel para editar el parameters.php sin necesidad de FTP.

¿Es peligroso cambiar los permisos de los archivos a 755/644?

No, son los permisos estándar en la mayoría de servidores. Solo asegúrate de no usar permisos 777 (todos pueden escribir), ya que supone un riesgo de seguridad.

¿Cuánto tiempo tarda en solucionarse este error?

Depende de la causa. Si es un problema de credenciales, lo solucionas en 5 minutos. Si es un problema del servidor, puede tardar más. En general, la mayoría de casos se resuelven en menos de 30 minutos siguiendo esta guía.

Conclusión

El error base de datos prestashop es uno de los más temidos por los propietarios de tiendas online, pero rara vez es un problema grave. Siguiendo estos pasos, en el 90% de los casos podrás recuperar tu tienda sin necesidad de contactar con un técnico.

Recuerda: la clave está en la paciencia y en revisar los datos de conexión. Empieza por lo más simple (comprobar que el servidor está activo) y ve subiendo en complejidad hasta llegar a la revisión de los archivos de configuración.

Si después de todo esto el error persiste, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso directo a los servidores y podrán diagnosticar el problema en minutos.

[INFO] En la mayoría de los casos, el error se debe a un cambio de contraseña en el hosting que no se ha reflejado en el archivo parameters.php. Revisa siempre este archivo primero.

Esperamos que esta guía te haya sido de ayuda. Si tienes más dudas sobre prestashop error db o necesitas ayuda con otros aspectos de tu tienda, deja un comentario o consulta nuestras otras guías. ¡Buena suerte con tu tienda!