Error 'Unable to connect to MySQL' en PrestaShop: Soluciones

¿Qué significa el error "Unable to connect to MySQL" en PrestaShop?

Si estás leyendo esto, probablemente te has encontrado con un mensaje de error bastante frustrante al intentar acceder a tu tienda online. No te preocupes, es uno de los problemas más comunes en PrestaShop y, en la gran mayoría de los casos, tiene solución en pocos minutos.

El error "Unable to connect to MySQL" (o "No se puede conectar a MySQL") indica que tu instalación de PrestaShop no puede comunicarse con la base de datos donde se almacenan todos tus productos, pedidos y clientes. Sin esa conexión, la tienda no puede funcionar.

Las causas pueden ser varias: desde un cambio de contraseña, un servidor caído, hasta un archivo de configuración con datos incorrectos. Vamos a desglosar las soluciones paso a paso, de la más sencilla a la más avanzada, para que puedas resolverlo aunque no tengas experiencia técnica.

Primero: identifica el alcance del problema

Antes de tocar nada, necesitas saber si el error afecta a toda tu tienda o solo al panel de administración. Esto te dará pistas sobre dónde está el fallo.

¿Aparece el error en la tienda y en el admin?

Si tanto la parte pública de tu web como el panel de administración muestran el error error mysql prestashop, el problema es general. Esto suele indicar que la base de datos no está accesible o que las credenciales son incorrectas.

¿Solo en la tienda, pero el admin funciona?

Si puedes entrar al panel de administración pero la tienda da error, puede que el problema esté en la caché o en un archivo de configuración dañado en la parte pública.

¿Solo en el admin?

Si la tienda carga bien pero el admin da error, puede ser un problema de permisos de archivos o de sesión.

En cualquier caso, los pasos que te doy a continuación cubren todas las situaciones.

Solución 1: Verifica que el servidor de base de datos está activo

El primer paso es comprobar que MySQL o MariaDB (el motor de base de datos) está funcionando en tu servidor. Si el servicio está caído, ninguna aplicación podrá conectarse.

Cómo comprobarlo desde Syspanel

Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el acceso al panel se realiza a través del puerto 2106. Una vez dentro:

Ve a la sección "Servicios" o "Servidor".
Busca el servicio MySQL o MariaDB.
Comprueba que su estado sea "Activo" o "Running".

Si está detenido, haz clic en "Iniciar" o "Reiniciar". Espera unos segundos y vuelve a intentar cargar tu tienda.

[TIP] Si no tienes acceso a Syspanel, puedes preguntar a tu proveedor de hosting si el servicio MySQL está operativo. Ellos pueden reiniciarlo por ti si es necesario.

Solución 2: Revisa el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php o settings.inc.php, dependiendo de la versión. Si estos datos son incorrectos, obtendrás el error conexion mysql prestashop.

Dónde encontrar el archivo

Para PrestaShop 1.7 y versiones posteriores: config/parameters.php
Para PrestaShop 1.6 y anteriores: config/settings.inc.php

Cómo editarlo

Necesitas un editor de texto (como el Bloc de notas o Visual Studio Code) y acceso a los archivos de tu hosting. Puedes usar el administrador de archivos de Syspanel o un cliente FTP como FileZilla.

Abre el archivo y busca las líneas que contienen:

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

Comprueba que estos datos coinciden con los de tu base de datos. Especialmente:

database_host: normalmente es localhost, pero algunos servidores usan una dirección IP o un nombre de host específico.
database_name: el nombre exacto de tu base de datos.
database_user y database_password: el usuario y contraseña de la base de datos.

[WARNING] Si no recuerdas la contraseña de la base de datos, puedes cambiarla desde Syspanel, pero tendrás que actualizar también este archivo con la nueva contraseña.

Solución 3: Cambia la contraseña de la base de datos desde Syspanel

Si sospechas que la contraseña es incorrecta, la forma más segura de solucionarlo es cambiarla desde tu panel de control.

Pasos en Syspanel

Accede a Syspanel usando el puerto 2106 (por ejemplo: https://tu-dominio.com:2106).
Ve a la sección "Base de datos" o "Bases de datos MySQL".
Localiza la base de datos asociada a tu PrestaShop.
Haz clic en "Cambiar contraseña" o "Editar".
Introduce una contraseña nueva y segura.
Guarda los cambios.

Ahora, actualiza el archivo parameters.php (o settings.inc.php) con la nueva contraseña que acabas de crear.

[INFO] Al cambiar la contraseña desde Syspanel, el sistema actualiza automáticamente los permisos del usuario para esa base de datos. No necesitas hacer nada más en ese sentido.

Solución 4: Verifica los permisos del usuario de la base de datos

A veces el error no es por la contraseña, sino porque el usuario no tiene permisos suficientes sobre la base de datos. Esto puede pasar tras una migración o restauración.

Cómo comprobarlo en Syspanel

En la sección de bases de datos, selecciona la base de datos de tu PrestaShop.
Revisa que el usuario vinculado tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
Si ves alguna opción para "Editar privilegios", asegúrate de que todos los permisos están marcados.

Si no estás seguro, puedes eliminar el usuario y volver a crearlo con permisos completos. Luego actualiza el archivo de configuración con las nuevas credenciales.

Solución 5: Comprueba que el host de la base de datos es correcto

Aunque la mayoría de los servidores usan localhost, algunos entornos de hosting compartido utilizan un host remoto como mysql.tudominio.com o una IP específica.

Cómo saber cuál es el host correcto

Revisa la documentación de tu proveedor de hosting.
En Syspanel, ve a la sección de bases de datos y busca el campo "Host" o "Servidor". Algunos paneles lo muestran explícitamente.
Si usas hosting compartido, es probable que el host sea localhost, pero no siempre.

Si has cambiado el host en el archivo de configuración, asegúrate de que no hay espacios ni caracteres extraños.

Solución 6: Limpia la caché de PrestaShop

A veces el error persiste aunque la conexión sea correcta porque PrestaShop guarda en caché los datos de conexión antiguos.

Cómo limpiar la caché manualmente

Accede a tu servidor por FTP o al administrador de archivos de Syspanel.
Navega hasta la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones antiguas).
Elimina todos los archivos y carpetas dentro de esa carpeta (no la carpeta en sí).
Vuelve a cargar tu tienda.

[TIP] Si no puedes acceder por FTP, también puedes probar a renombrar la carpeta cache a cache_old. PrestaShop creará una nueva automáticamente.

Solución 7: Revisa los logs del servidor

Si ninguna de las soluciones anteriores funciona, necesitas ver los registros del servidor para obtener más información sobre el error.

Dónde encontrar los logs

En Syspanel, ve a la sección "Logs" o "Registros".
Busca los logs de error de PHP o de MySQL.
También puedes revisar el archivo logs dentro de la carpeta de PrestaShop.

Los mensajes típicos que puedes ver son:

Access denied for user 'usuario'@'localhost' → problema de credenciales.
Unknown database 'nombre_db' → la base de datos no existe.
Can't connect to MySQL server on 'localhost' → el servidor MySQL no está activo.

Con esta información, puedes afinar la solución.

Solución 8: Restaura una copia de seguridad reciente

Si has hecho cambios recientes (como instalar un módulo o mover archivos) y el error apareció después, puede que hayas corrompido algo. Restaurar una copia de seguridad anterior puede ser la solución más rápida.

Cómo restaurar desde Syspanel

Ve a la sección "Copias de seguridad" o "Backups".
Localiza la copia más reciente anterior al inicio del problema.
Restaura tanto la base de datos como los archivos.

[WARNING] Esta opción sobrescribirá cualquier cambio que hayas hecho desde esa copia. Asegúrate de que es lo que quieres antes de continuar.

Solución 9: Contacta con tu proveedor de hosting

Si has probado todo lo anterior y el error prestashop error base datos persiste, es hora de contactar con tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden:

Verificar si hay problemas de firewall o de IP bloqueada.
Comprobar si el servicio MySQL está sobrecargado.
Revisar si hay límites de conexiones activas.

[INFO] Cuando contactes con ellos, ten a mano el error exacto, los pasos que has seguido y capturas de pantalla si es posible. Esto acelerará el diagnóstico.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si cambio la contraseña de la base de datos?

No. Cambiar la contraseña no elimina datos. Solo afecta a la forma en que PrestaShop se conecta a la base de datos.

¿Qué hago si no tengo acceso a Syspanel?

Si no puedes acceder al panel de control, contacta con tu proveedor de hosting y pídeles que verifiquen el estado de MySQL y las credenciales de tu base de datos.

¿El error puede deberse a un ataque informático?

En casos raros, sí. Si sospechas que alguien ha modificado tu archivo de configuración, revisa los permisos de los archivos y cambia todas las contraseñas (panel de administración, base de datos y FTP).

¿Cuánto tiempo se tarda en solucionar este error?

Depende de la causa. Si es solo una contraseña incorrecta, puedes resolverlo en 5 minutos. Si es un problema del servidor, puede tardar unas horas hasta que tu proveedor lo solucione.

Conclusión

El error "Unable to connect to MySQL" en PrestaShop puede parecer grave, pero en la mayoría de los casos es un problema de configuración fácil de corregir. Siguiendo estos pasos, podrás identificar la causa y restaurar el funcionamiento de tu tienda sin necesidad de ser un experto en servidores.

Recuerda: empieza por lo más simple (verificar que MySQL está activo), revisa las credenciales en el archivo de configuración, y si nada funciona, no dudes en pedir ayuda a tu proveedor de hosting. Con un poco de paciencia, tu tienda volverá a estar operativa en poco tiempo.

[TIP] Para evitar futuros problemas, anota las credenciales de tu base de datos en un lugar seguro y realiza copias de seguridad periódicas. Así, si vuelve a ocurrir, podrás restaurar rápidamente.