Errores de conexión a BD en PrestaShop | Soluciones

Introducción: Cuando PrestaShop pierde la conexión con su base de datos

Si estás leyendo esto, probablemente te hayas encontrado con una pantalla en blanco, un mensaje de error crítico o un aviso de "Error de conexión a la base de datos" al intentar abrir tu tienda online. No te preocupes, es uno de los problemas más comunes en el mundo del ecommerce y, en la gran mayoría de los casos, tiene una solución sencilla.

El prestashop error base de datos puede aparecer en diferentes momentos: durante la instalación, después de una migración, al cambiar de servidor o incluso de repente, sin haber tocado nada. La base de datos es el corazón de tu tienda: guarda productos, pedidos, clientes y configuración. Si no se conecta correctamente, PrestaShop no puede funcionar.

En esta guía extensa, vamos a desglosar los errores más frecuentes al conectar PrestaShop a una base de datos, explicando las causas y, lo más importante, cómo solucionarlos paso a paso. No necesitas ser un experto en servidores para seguir estas instrucciones, solo paciencia y un poco de método.

¿Qué significa realmente "conexión bd prestashop"?

Antes de entrar en materia, es importante entender qué ocurre entre bastidores. PrestaShop es una aplicación PHP que necesita almacenar y recuperar información constantemente. Para ello, se comunica con un sistema de gestión de bases de datos, normalmente MySQL o MariaDB. La conexión bd prestashop se realiza mediante un archivo de configuración llamado parameters.php, ubicado en la carpeta app/config/ de tu instalación.

Ese archivo contiene cuatro datos esenciales:

El nombre de la base de datos
El usuario de la base de datos
La contraseña del usuario
El servidor de la base de datos (normalmente localhost o 127.0.0.1)

Si cualquiera de estos datos es incorrecto, o si el servidor de bases de datos no está accesible, obtendrás un error. También puede ocurrir que la estructura de la base de datos esté dañada o que los permisos del usuario no sean los adecuados.

Error 1: "Link to database cannot be established" o "Error de conexión con la base de datos"

Este es, con diferencia, el prestashop mysql error más habitual. Aparece una pantalla con un mensaje similar a "Link to database cannot be established: SQLSTATE[HY000] [1045] Access denied for user".

Causas principales:

Contraseña incorrecta en el archivo parameters.php.
Usuario de base de datos no existe o no tiene permisos sobre la base de datos.
El nombre de la base de datos está mal escrito.

Cómo solucionarlo:

Accede a tu panel de control de hosting o a Syspanel (el panel de gestión de tu servidor, cuyo puerto de acceso es el 2106).
Busca la sección de "Bases de datos" o "MySQL".
Verifica que la base de datos existe y anota su nombre exacto (suele tener un prefijo como usuario_bd).
Comprueba que el usuario asociado a esa base de datos existe y que la contraseña es correcta. Si no la recuerdas, cámbiala desde el panel.
Abre el archivo app/config/parameters.php de tu instalación de PrestaShop mediante el administrador de archivos o FTP.
Asegúrate de que los valores database_name, database_user, database_password y database_host coinciden exactamente con los datos de tu panel.

[TIP] Si cambias la contraseña desde el panel, recuerda actualizarla también en el archivo parameters.php. Un error típico es cambiarla en un sitio y no en el otro.

Error 2: "The server is not responding" o timeout de conexión

Este error indica que PrestaShop no puede llegar al servidor de bases de datos. El mensaje suele ser algo como "SQLSTATE[HY000] [2002] Connection refused" o "Connection timed out".

Causas principales:

El servidor de bases de datos está caído o en mantenimiento.
El servidor MySQL no escucha en el puerto esperado (normalmente 3306).
Un firewall está bloqueando la conexión.
Estás usando un host remoto incorrecto (por ejemplo, una IP en lugar de localhost).

Cómo solucionarlo:

Verifica que el servicio MySQL/MariaDB está activo. Si tienes acceso a Syspanel (puerto 2106), revisa el estado de los servicios. También puedes usar la terminal con el comando systemctl status mysql o service mysql status.
Si el servicio está caído, reinícialo con systemctl restart mysql o desde el panel.
Comprueba si tu hosting usa localhost o un host remoto. En la mayoría de los casos, si la base de datos está en el mismo servidor, deberías usar localhost o 127.0.0.1.
Si estás en un hosting compartido, revisa la documentación del proveedor para conocer el host correcto (a veces es algo como mysql.tudominio.com).
Si tienes un firewall activo, asegúrate de que el puerto 3306 está abierto para las conexiones locales.

[WARNING] No uses una IP pública para conectarte a tu propia base de datos si está en el mismo servidor. Esto puede ralentizar la conexión y exponer tu base de datos a ataques externos.

Error 3: "Table doesn't exist" o tablas faltantes

Este error ocurre cuando PrestaShop intenta acceder a una tabla que no existe en la base de datos. El mensaje suele ser algo como "Table 'ps_shop_url' doesn't exist".

Causas principales:

Instalación incompleta o fallida.
Migración incorrecta de la base de datos.
Restauración parcial de un backup.
Módulos que crean tablas y no se instalaron correctamente.

Cómo solucionarlo:

Haz una copia de seguridad de tu base de datos actual (por si acaso).
Accede a phpMyAdmin o a la herramienta de gestión de bases de datos de tu panel.
Compara las tablas existentes con las que debería tener PrestaShop. Una instalación estándar tiene más de 200 tablas con prefijo ps_ (o el prefijo que hayas configurado).
Si faltan muchas tablas, lo más rápido es restaurar un backup completo de la base de datos.
Si solo faltan unas pocas, puedes intentar regenerarlas ejecutando el instalador de PrestaShop en modo "mantenimiento" o usando un módulo de reparación.

[INFO] Si tienes acceso a Syspanel (puerto 2106), puedes hacer una restauración de la base de datos desde la sección de backups, siempre que tengas una copia reciente guardada.

Error 4: "Access denied for user" con privilegios insuficientes

En este caso, el usuario existe y la contraseña es correcta, pero el usuario no tiene permisos suficientes sobre la base de datos. El mensaje suele ser "SQLSTATE[HY000] [1044] Access denied for user to database".

Causas principales:

El usuario no tiene todos los privilegios sobre la base de datos.
El usuario está asociado a otra base de datos con el mismo nombre.
Los privilegios se revocaron accidentalmente.

Cómo solucionarlo:

Entra en tu panel de control o en Syspanel (puerto 2106).
Localiza la sección de bases de datos y busca el usuario que utiliza PrestaShop.
Asegúrate de que el usuario está vinculado a la base de datos correcta.
Otorga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, etc.) sobre la base de datos.
Si usas phpMyAdmin, puedes hacerlo desde la pestaña "Privilegios" marcando todas las casillas.

[TIP] En Syspanel, al crear un usuario, la opción "Otorgar todos los privilegios" suele estar marcada por defecto. Si la desmarcaste en algún momento, vuelve a activarla y guarda los cambios.

Error 5: Problemas con el prefijo de las tablas

PrestaShop permite usar un prefijo personalizado para las tablas (por ejemplo, ps_, shop_, prestashop_). Si has cambiado el prefijo o has importado una base de datos con un prefijo diferente, obtendrás errores de tablas no encontradas.

Cómo solucionarlo:

Revisa el archivo parameters.php y busca el parámetro database_prefix.
Comprueba en phpMyAdmin cuál es el prefijo real de tus tablas.
Si no coinciden, edita el archivo parameters.php con el prefijo correcto.
Si prefieres cambiar el prefijo de las tablas, puedes hacerlo con una consulta SQL compleja, pero es más seguro ajustar el archivo de configuración.

[WARNING] Cambiar el prefijo de las tablas manualmente puede romper tu tienda si no sabes lo que haces. Es mucho más seguro modificar el valor en parameters.php.

Error 6: "MySQL server has gone away" o conexión perdida

Este error suele aparecer en tiendas con muchos productos o durante procesos pesados como la importación de catálogos. El servidor de bases de datos cierra la conexión porque ha superado el tiempo máximo de espera o el tamaño máximo de paquete.

Causas principales:

Tiempo de espera (wait_timeout) demasiado bajo en MySQL.
Tamaño máximo de paquete (max_allowed_packet) demasiado pequeño.
El servidor se queda sin memoria.

Cómo solucionarlo:

Accede a la configuración de MySQL. Si tienes acceso a Syspanel (puerto 2106), puedes editar el archivo my.cnf o my.ini.
Aumenta los valores de wait_timeout (por ejemplo, a 300 segundos) y max_allowed_packet (por ejemplo, a 64M).
Si no puedes editar la configuración del servidor, intenta aumentar el tiempo de ejecución de PHP en el archivo php.ini o mediante .htaccess.
Para importaciones grandes, usa herramientas como MySQL Workbench o realiza la importación por partes.

[INFO] En Syspanel, la gestión de MySQL suele estar en la sección "Servicios" o "Bases de datos". Si no encuentras la opción, contacta con tu proveedor de hosting.

Error 7: Archivo parameters.php corrupto o con permisos incorrectos

A veces el problema no está en la base de datos, sino en el archivo de configuración de PrestaShop. Si está dañado, incompleto o no se puede leer, la conexión fallará.

Cómo solucionarlo:

Accede a tu servidor por FTP o mediante el administrador de archivos de Syspanel.
Ve a la ruta app/config/ y descarga el archivo parameters.php a tu ordenador.
Ábrelo con un editor de texto plano (nunca con Word o similar).
Verifica que todas las comillas y puntos y comas están bien colocados. Un error de sintaxis rompe todo.
Comprueba los permisos del archivo. Debe tener permisos de lectura para el usuario de PHP (normalmente 644 o 640).
Si el archivo está corrupto, restaura una copia de seguridad o regenera el archivo desde el instalador de PrestaShop.

[WARNING] Si modificas el archivo parameters.php, asegúrate de guardarlo con codificación UTF-8 sin BOM. Una codificación incorrecta puede provocar errores extraños.

Error 8: Confusión entre MySQL y MariaDB

PrestaShop funciona perfectamente con MySQL y MariaDB, pero a veces hay problemas de compatibilidad con versiones muy antiguas o muy nuevas.

Causas principales:

Versión de MySQL demasiado antigua (anterior a 5.6).
Versión de MariaDB incompatible con la versión de PrestaShop.
Módulos que requieren funciones específicas de MySQL.

Cómo solucionarlo:

Verifica la versión de tu servidor de bases de datos en phpMyAdmin o desde Syspanel.
Consulta los requisitos de tu versión de PrestaShop. Las versiones modernas requieren MySQL 5.7 o superior, o MariaDB 10.2 o superior.
Si tu versión es antigua, contacta con tu proveedor para actualizarla.
Si usas funciones incompatibles, revisa los módulos instalados y actualízalos.

[TIP] MariaDB es un reemplazo directo de MySQL y, en la mayoría de los casos, funciona mejor. Si tu hosting lo ofrece, no dudes en usarlo.

Error 9: Base de datos dañada o corrupta

A veces la base de datos se corrompe por cortes de energía, fallos del disco o cierres incorrectos del servidor. Los síntomas incluyen errores de tabla, consultas lentas o fallos intermitentes.

Cómo solucionarlo:

Accede a phpMyAdmin o a la herramienta de gestión de bases de datos.
Selecciona todas las tablas de tu base de datos.
En el menú desplegable, elige "Reparar tabla" o "Optimizar tabla".
Si el error persiste, usa el comando mysqlcheck desde la terminal: mysqlcheck -u usuario -p --repair --databases nombre_bd.
Si no puedes repararlas, restaura un backup reciente.

[INFO] En Syspanel (puerto 2106), puedes acceder a phpMyAdmin directamente desde el panel, sin necesidad de instalar nada adicional.

Error 10: El instalador de PrestaShop no se conecta a la base de datos

Si estás instalando PrestaShop desde cero y te da error al conectar, el problema puede estar en los datos introducidos durante la instalación.

Cómo solucionarlo:

Verifica que has creado la base de datos previamente en tu panel de hosting.
Asegúrate de que el usuario tiene permisos sobre la base de datos (no solo sobre el servidor).
Comprueba que el host es correcto. En la mayoría de los casos, es localhost.
Si usas Syspanel, el puerto de acceso al panel es el 2106, pero la base de datos usará el puerto 3306. No confundas ambos.
Prueba a usar 127.0.0.1 en lugar de localhost si el primero no funciona.

[WARNING] Algunos proveedores de hosting usan un host específico para bases de datos, como mysql.tudominio.com. Si localhost no funciona, revisa la documentación de tu proveedor.

Cómo prevenir futuros errores de conexión

La mejor solución es la prevención. Aquí tienes una lista de buenas prácticas para evitar el prestashop error base de datos en el futuro:

Haz backups regulares de tu base de datos y de los archivos de configuración.
Anota los cambios que realices en el servidor (contraseñas, usuarios, versiones).
Mantén PrestaShop actualizado a la última versión estable.
Revisa los logs de error del servidor periódicamente.
Usa un prefijo de tabla personalizado para mayor seguridad, pero anótalo en un lugar seguro.
No compartas las credenciales de la base de datos con terceros.
Configura alertas en tu panel de control para detectar caídas del servicio.

Preguntas frecuentes (FAQ)

¿Cuánto tiempo se tarda en solucionar un error de conexión a la base de datos?

Depende del error. Los problemas de contraseña o permisos se solucionan en minutos. Los problemas de corrupción o configuración del servidor pueden llevar más tiempo, incluso horas.

¿Puedo perder datos si intento reparar la base de datos?

Siempre existe un riesgo. Por eso es fundamental hacer un backup antes de cualquier operación. La reparación de tablas no debería eliminar datos, pero una restauración incorrecta sí puede hacerlo.

¿Qué hago si no tengo acceso a Syspanel o al panel de control?

Contacta con tu proveedor de hosting. Ellos deberían poder ayudarte a acceder a la base de datos o a restaurar un backup.

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

Sí, es relativamente común. Las actualizaciones pueden cambiar la estructura de la base de datos o los requisitos del servidor. Si ocurre, verifica que tu servidor cumple con los nuevos requisitos.

¿Puedo usar una base de datos remota para PrestaShop?

Sí, es posible, pero no recomendado para tiendas pequeñas por la latencia. Si lo haces, asegúrate de que la conexión sea segura y que el host rem