Error 'Can't connect to MySQL' en PrestaShop Plesk: Solución definitiva

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

Cuando tu tienda PrestaShop muestra el mensaje "Can't connect to MySQL server" (No se puede conectar al servidor MySQL), significa que la aplicación no está logrando comunicarse con la base de datos donde se guardan tus productos, pedidos y clientes.

Este es uno de los errores más comunes en PrestaShop y puede aparecer por varias razones, desde un cambio de contraseña hasta un problema con el servidor. La buena noticia es que en la mayoría de los casos tiene solución rápida, y aquí te voy a explicar paso a paso cómo resolverlo en un entorno con Plesk.

Diagnóstico inicial: ¿qué está pasando exactamente?

Antes de tocar nada, es importante identificar el origen del problema. El error error MySQL PrestaShop Plesk puede deberse a:

Contraseña incorrecta de la base de datos.
Usuario de base de datos eliminado o sin permisos.
El servicio MySQL/MariaDB está caído.
La configuración en el archivo parameters.php tiene datos erróneos.
El servidor se quedó sin espacio en disco.
Problemas con el puerto de conexión (normalmente 3306).

Para empezar, accede a tu panel de Plesk y revisa si el servicio de base de datos está activo. Ve a Herramientas y configuración > Servicios del servidor y comprueba que MySQL o MariaDB aparezca en verde.

Solución 1: Verificar las credenciales de la base de datos

La causa más frecuente de este error es que las credenciales almacenadas en PrestaShop no coinciden con las reales. Esto suele pasar tras un cambio de contraseña en Plesk o una restauración de copia de seguridad.

Paso 1: Accede a Plesk y localiza tu base de datos

Entra en tu panel de Plesk y busca la sección Bases de datos. Ahí deberías ver la base de datos asociada a tu PrestaShop. Anota el nombre exacto, el usuario y asegúrate de tener la contraseña correcta.

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

PrestaShop guarda los datos de conexión en el archivo app/config/parameters.php. Puedes acceder a él mediante el administrador de archivos de Plesk o por FTP.

Busca estas líneas:

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

Verifica que los datos sean exactamente los mismos que tienes en Plesk. Si algo no coincide, corrígelo y guarda el archivo.

[WARNING]: Antes de editar este archivo, haz una copia de seguridad del mismo por si algo sale mal.

Paso 3: Prueba la conexión manualmente

Puedes probar si las credenciales funcionan usando phpMyAdmin desde Plesk. Si puedes entrar con esos datos, el problema está en la configuración de PrestaShop. Si no puedes entrar, entonces las credenciales están mal y debes restablecerlas.

Solución 2: El servicio MySQL está caído

Si las credenciales son correctas pero el error persiste, puede que el servicio de base de datos esté detenido. Esto ocurre a veces tras un reinicio del servidor o por falta de recursos.

Cómo reiniciar MySQL en Plesk

Ve a Herramientas y configuración.
Busca Administración de servicios.
Localiza mysql o mariadb.
Si está detenido, haz clic en Iniciar.
También puedes hacer clic en Reiniciar para asegurarte de que carga correctamente.

[TIP]: Si el servicio no arranca, revisa el log de errores en Registros > Base de datos para ver el motivo exacto.

Solución 3: El usuario de la base de datos perdió permisos

En Plesk, cuando creas una base de datos, también se crea un usuario con permisos completos. Pero a veces estos permisos se pierden o se modifican accidentalmente.

Verificar y otorgar permisos

En Plesk, entra en tu base de datos.
Ve a la pestaña Usuarios.
Comprueba que el usuario aparece y tiene marcados los privilegios ALL PRIVILEGES.

Si no es así, edita al usuario y marca todas las casillas de permisos. Guarda los cambios y prueba de nuevo.

Solución 4: El archivo parameters.php tiene caché

A veces PrestaShop guarda una copia en caché de la configuración y aunque edites el archivo, sigue usando la anterior.

Limpiar la caché de PrestaShop

Accede a tu servidor por FTP o al administrador de archivos de Plesk y elimina el contenido de la carpeta var/cache/. No borres la carpeta en sí, solo su contenido.

Si no puedes acceder al panel de administración, borra estos archivos manualmente:

var/cache/prod/*
var/cache/dev/*

Después de limpiar la caché, recarga tu tienda. Es probable que el error base datos PrestaShop desaparezca.

Solución 5: Problemas con el puerto de conexión

Aunque lo más común es que PrestaShop use localhost como host, en algunos servidores la conexión se hace mediante un puerto específico o un host distinto (como una IP).

Revisa el host de conexión

En tu parameters.php, database_host debería ser normalmente localhost. Si tu servidor usa conexiones remotas o un socket específico, puede que necesites cambiarlo.

Consulta con tu proveedor de hosting si debes usar un host diferente o un puerto distinto al 3306.

[INFO]: En la mayoría de los casos con Plesk, localhost es suficiente, pero si tienes dudas, contacta con soporte.

Solución 6: Espacio en disco lleno

Un servidor sin espacio libre puede provocar que MySQL no pueda escribir archivos temporales y falle la conexión.

Comprobar espacio en disco

En Plesk, ve a Herramientas y configuración > Información del servidor y revisa el uso del disco. Si está al 100%, libera espacio eliminando copias de seguridad antiguas o logs innecesarios.

Solución 7: Restaurar desde una copia de seguridad

Si nada de lo anterior funciona, puede que la base de datos esté corrupta. En ese caso, la solución más segura es restaurar una copia de seguridad reciente.

Pasos para restaurar

En Plesk, ve a Bases de datos.
Selecciona tu base de datos.
Haz clic en Copias de seguridad.
Elige la copia más reciente y restáurala.

[WARNING]: Esto sobrescribirá los datos actuales, así que asegúrate de que la copia sea de antes de que apareciera el error.

Solución 8: Revisar el archivo settings.inc.php (versiones antiguas)

Si tu PrestaShop es anterior a la versión 1.7, la configuración está en config/settings.inc.php en lugar de parameters.php. El proceso es el mismo: verifica las credenciales y guarda.

Solución 9: Problemas con el certificado SSL o conexiones seguras

En algunos casos, si cambiaste la URL de tu tienda o activaste SSL, PrestaShop intenta conectar a la base de datos usando una ruta distinta. Asegúrate de que en parameters.php no haya valores extraños como 'server' => 'https://...'.

Solución 10: Contactar con el soporte del hosting

Si has probado todos estos pasos y el error persiste, es momento de contactar con tu proveedor de hosting. Ellos pueden revisar los logs del servidor y verificar si hay algún bloqueo a nivel de red o firewall.

Preguntas frecuentes (FAQ)

¿Por qué me sale este error después de cambiar la contraseña de MySQL en Plesk?

Porque PrestaShop sigue usando la contraseña antigua. Debes actualizar el archivo parameters.php con la nueva contraseña.

¿Puedo usar phpMyAdmin para arreglar el error?

Sí, phpMyAdmin te permite verificar si las credenciales funcionan y también puedes exportar/importar la base de datos si necesitas restaurarla.

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

Si usas PrestaShop 1.7 o superior, el archivo está en app/config/parameters.php. Si usas una versión anterior, busca config/settings.inc.php.

¿El error afecta al panel de administración?

Sí, normalmente no podrás acceder ni a la tienda ni al panel de administración hasta resolverlo.

¿Puedo prevenir este error en el futuro?

Realiza copias de seguridad periódicas, anota los cambios de contraseña y evita editar la base de datos directamente sin necesidad.

Resumen final

El error "Can't connect to MySQL server" en PrestaShop con Plesk es frustrante, pero solucionable. La mayoría de las veces se debe a un problema de credenciales o a un servicio detenido. Sigue estos pasos en orden y en pocos minutos tu tienda debería volver a funcionar.

Recuerda siempre trabajar con copias de seguridad y no modificar archivos sin saber lo que haces. Si tienes dudas, no dudes en consultar con tu soporte técnico.

[TIP]: Guarda las contraseñas de tus bases de datos en un gestor seguro y documenta cualquier cambio que hagas en la configuración. Esto te ahorrará muchos dolores de cabeza en el futuro.