Error de conexión a base de datos en PrestaShop | Solución

¿Qué significa exactamente el error de conexión a la base de datos en PrestaShop?

Cuando visitas tu tienda online y te encuentras con un mensaje similar a "Error de conexión a la base de datos", "Link to database cannot be established" o directamente una página en blanco, significa que tu PrestaShop no puede comunicarse con el servidor MySQL o MariaDB donde se almacenan tus productos, pedidos, clientes y configuraciones.

Este es uno de los errores más comunes en PrestaShop, pero también uno de los más fáciles de solucionar si sigues los pasos adecuados. No te preocupes, no necesitas ser un experto en programación para resolverlo. En esta guía te explicamos, paso a paso, cómo diagnosticar y solucionar el error mysql prestashop tanto si tu hosting usa cPanel como si usa Plesk.

Primero: identifica el tipo de error que te aparece

Antes de empezar a tocar nada, es importante que sepas qué tipo de error estás viendo exactamente. Esto te dará pistas sobre la causa.

Error de conexión general: "Error de conexión a la base de datos" o "Link to database cannot be established". Indica que PrestaShop no encuentra o no puede autenticarse contra la base de datos.
Error de tabla inexistente: "Table 'ps_shop_url' doesn't exist". Suele significar que la base de datos está vacía o corrupta.
Error de acceso denegado: "Access denied for user 'usuario'@'localhost'". Indica que las credenciales son incorrectas o el usuario no tiene permisos.
Error de servidor no encontrado: "Unknown MySQL server host". Indica que el servidor de base de datos indicado no existe o está mal escrito.

Causas más comunes del error de conexión a la base de datos en PrestaShop

Las causas pueden ser muy variadas, pero estas son las más habituales:

Credenciales incorrectas en el archivo de configuración parameters.php.
El servidor de base de datos está caído o saturado.
El usuario de la base de datos ha perdido permisos o ha sido eliminado.
La base de datos ha superado el límite de tamaño o de conexiones simultáneas.
Cambios recientes en el hosting (migraciones, cambios de contraseña, renovaciones de dominio).
Archivos corruptos después de una actualización o instalación de módulos.
Problemas con la caché de PrestaShop o con la configuración de PHP (memoria insuficiente).

Solución paso a paso para cPanel

Si tu hosting utiliza cPanel, estos son los pasos que debes seguir en orden. No saltes ninguno sin antes verificar si el problema se resolvió.

1. Accede a cPanel y verifica que la base de datos existe

Lo primero es comprobar que tu base de datos sigue ahí y que no ha sido eliminada por error.

Entra en cPanel (normalmente en tudominio.com/cpanel).
Busca la sección Bases de datos MySQL.
Verifica que aparece la base de datos que usa tu PrestaShop. Si no aparece, tendrás que restaurarla desde una copia de seguridad.

2. Verifica el usuario y los permisos

A veces el usuario existe pero ha perdido los permisos sobre la base de datos.

En la misma sección de Bases de datos MySQL, localiza la base de datos y el usuario asociado.
Asegúrate de que el usuario tenga TODOS LOS PRIVILEGIOS (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc.).
Si no los tiene, añádelos seleccionando "Todos los privilegios" y guarda los cambios.

3. Comprueba el archivo de configuración `parameters.php`

Este es el archivo donde PrestaShop guarda los datos de conexión. Está en la ruta:

/config/parameters.php

Dentro de tu carpeta de PrestaShop (por ejemplo, public_html/config/parameters.php).

Ábrelo con un editor de texto (desde el Administrador de archivos de cPanel).
Busca las líneas que empiezan por 'database_host', 'database_name', 'database_user' y 'database_password'.
Compara estos valores con los que aparecen en cPanel. El nombre de la base de datos y el usuario suelen tener un prefijo (por ejemplo, usuario_prestashop).
Si la contraseña es incorrecta, cámbiala desde cPanel (sección "Cambiar contraseña de MySQL") y actualiza el archivo.

[WARNING]
Ten mucho cuidado al editar este archivo. Un error de sintaxis (una comilla mal puesta) puede dejar tu tienda completamente inaccesible. Si no te sientes seguro, haz una copia de seguridad del archivo antes de tocarlo.

4. Reinicia los servicios de MySQL desde cPanel

En algunos hostings, puedes reiniciar los servicios desde la sección "Estado de servicios" o "Reiniciar servicios". Si no tienes esta opción, contacta con tu proveedor.

5. Comprueba el espacio en disco y los límites de conexión

Un disco lleno o un límite de conexiones agotado puede provocar el error conexión prestashop.

En cPanel, revisa el Administrador de archivos o la sección Uso de espacio para ver si el disco está al 100%.
Si el problema es por límite de conexiones, suele ser un tema del servidor. Contacta con tu proveedor de hosting.

Solución paso a paso para Plesk

Si tu hosting usa Plesk, el proceso es similar pero con algunas diferencias en la interfaz.

1. Accede a Plesk y localiza la base de datos

Entra en tu panel de Plesk (normalmente en tudominio.com:8443).
Ve a la sección Bases de datos dentro de tu dominio o suscripción.
Verifica que la base de datos de PrestaShop esté presente y activa.

2. Comprueba el usuario y la contraseña

Haz clic en el nombre de la base de datos.
Revisa que el usuario asociado existe y tiene permisos completos.
Si no recuerdas la contraseña, puedes cambiarla desde el propio panel. Después, actualiza el archivo parameters.php de PrestaShop.

3. Verifica el estado del servidor MySQL

Plesk te permite ver el estado de los servicios:

Ve a Herramientas y utilidades > Monitor de servicios.
Busca MySQL o MariaDB. Si está detenido, inícialo.

[TIP]
Si tu hosting usa el panel Syspanel (antes conocido como HestiaCP), recuerda que el acceso se realiza por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Los pasos internos son muy similares: busca la sección de bases de datos, verifica credenciales y reinicia el servicio MySQL si es necesario.

Soluciones avanzadas si el problema persiste

Si has seguido todos los pasos anteriores y el error mysql prestashop continúa, prueba estas soluciones más avanzadas.

1. Regenera el archivo `parameters.php`

A veces el archivo está corrupto o incompleto. Puedes regenerarlo desde la instalación de PrestaShop:

Ve a tudominio.com/install y ejecuta el asistente de instalación.
Selecciona "Actualizar parámetros de conexión" (si está disponible).
Introduce los datos correctos de la base de datos y PrestaShop regenerará el archivo.

2. Limpia la caché de PrestaShop

Una caché corrupta puede provocar errores extraños. Puedes limpiarla manualmente:

Borra el contenido de las carpetas /var/cache y /cache dentro de tu instalación de PrestaShop (excepto el archivo .htaccess si existe).
También puedes borrar el contenido de /var/logs (deja un archivo llamado index.php si es necesario).

3. Aumenta la memoria PHP

A veces el error es causado por falta de memoria. Edita el archivo /config/defines.inc.php y busca la línea:

define('_PS_MEMORY_LIMIT_', '128M');

Cámbiala a '256M' o '512M'.

[INFO]
Si no encuentras esa línea, puedes añadirla justo después de la línea define('_PS_MEMORY_LIMIT_', '128M'); o crearla si no existe.

4. Revisa los logs de error de MySQL

Pide a tu proveedor de hosting los logs de MySQL del último día. Busca errores como "Too many connections", "Out of memory" o "Table is marked as crashed". Esto te dará pistas muy valiosas.

5. Restaura la base de datos desde una copia de seguridad

Si todo lo demás falla, restaura la base de datos desde una copia de seguridad reciente. En cPanel puedes hacerlo desde "Copias de seguridad" y en Plesk desde "Administrador de copias de seguridad".

[WARNING]
Restaurar una copia de seguridad sobrescribirá los datos actuales. Asegúrate de que la copia sea reciente y de que entiendes las consecuencias.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop no conecta después de cambiar la contraseña de MySQL?

Es muy probable que el archivo parameters.php no se haya actualizado. Cambia la contraseña en el panel y luego edita el archivo de configuración con la nueva clave.

¿Qué hago si no tengo acceso a cPanel ni a Plesk?

Si no tienes acceso al panel de control, contacta con tu proveedor de hosting. Ellos podrán verificar si el servidor MySQL está activo y si las credenciales son correctas. También pueden revisar los logs por ti.

¿Puedo solucionar el error desde el modo seguro de PrestaShop?

El modo seguro no te ayudará directamente con la conexión a la base de datos, pero si puedes acceder al back office, puedes intentar desactivar módulos o limpiar la caché. Para activarlo, añade define('_PS_MODE_DEV_', true); en el archivo config/defines.inc.php y observa si aparece algún error más específico.

¿Cómo sé si el problema es del servidor o de mi instalación?

Si el error aparece en todas las páginas y no solo en algunas, y si además otros sitios en el mismo hosting funcionan bien, es probable que el problema sea de tu instalación. Si el servidor MySQL está caído, otros sitios también fallarán.

¿Debo reinstalar PrestaShop para solucionar el error de conexión?

No, no es recomendable reinstalar PrestaShop a menos que tengas una copia de seguridad completa de la base de datos y los archivos. Reinstalar sin restaurar los datos hará que pierdas toda tu información. Siempre intenta primero las soluciones anteriores.

Consejos finales para evitar futuros errores de conexión

Realiza copias de seguridad periódicas de tu base de datos y archivos. Puedes programarlas desde cPanel o Plesk.
Anota en un lugar seguro las credenciales de la base de datos: nombre, usuario y contraseña.
No compartas tus credenciales ni las publiques en foros o chats.
Mantén PrestaShop y sus módulos actualizados a las últimas versiones estables.
Si cambias de hosting, asegúrate de migrar correctamente la base de datos y de actualizar el archivo parameters.php.

Resumen en 5 pasos rápidos

Verifica que la base de datos existe en tu panel de control (cPanel o Plesk).
Comprueba que el usuario tiene todos los permisos sobre esa base de datos.
Revisa el archivo config/parameters.php y compara las credenciales con las del panel.
Reinicia el servicio MySQL si es posible.
Si nada funciona, restaura una copia de seguridad o contacta con tu proveedor.

El error conexión prestashop puede parecer grave, pero en la mayoría de los casos se soluciona en pocos minutos revisando las credenciales y los permisos. Con esta guía ya tienes todas las herramientas para diagnosticar y solucionar prestashop por ti mismo. Y recuerda: si tu panel de control es Syspanel, accede siempre por el puerto 2106 para gestionar tus bases de datos y servicios.

Si después de seguir todos los pasos el problema continúa, no dudes en contactar con el soporte de tu hosting. Ellos tienen acceso directo a los servidores y podrán ayudarte a identificar la causa raíz. ¡Buena suerte y que tu tienda vuelva a funcionar pronto!