Solucionar error conexión base de datos PrestaShop en Plesk

¡Entendido! Aquí tienes el artículo completo, siguiendo al pie de la letra todas las reglas de formato, tono y contenido solicitado.

¿Te has encontrado con el temido mensaje «Error de conexión a la base de datos» en tu tienda PrestaShop? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía completa, te explicaré paso a paso cómo solucionar el error conexión PrestaShop Plesk, incluso si no eres un experto en tecnología.

Este error suele aparecer de repente y puede deberse a varias causas: un cambio de contraseña, un problema con el servidor MySQL, un archivo de configuración dañado o incluso un exceso de conexiones. Vamos a desglosar cada posible causa y te daré las herramientas para resolverla usando Plesk, el panel de control de hosting más popular.

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

Cuando PrestaShop no puede conectar con su base de datos, la tienda se vuelve inaccesible. El mensaje típico es: «Error de conexión a la base de datos» o «Link to database cannot be established». Esto ocurre porque el archivo app/config/parameters.php (en PrestaShop 1.7 y 8) o config/settings.inc.php (en versiones antiguas) contiene datos incorrectos o el servidor MySQL no está respondiendo.

Las causas más frecuentes son:

Cambio de contraseña de la base de datos (el más común).
El usuario de la base de datos ha sido eliminado o modificado.
El servidor MySQL se ha detenido o está sobrecargado.
El archivo de configuración está dañado o tiene permisos incorrectos.
Problemas con el prefijo de las tablas o el nombre de la base de datos.

Primeros pasos: diagnósticos básicos desde Plesk

Antes de tocar nada, vamos a hacer una comprobación rápida desde Plesk para descartar lo más obvio.

1. Verifica que el servidor MySQL esté funcionando

Accede a tu panel de Plesk y busca la sección Herramientas y configuraciones (o Tools & Settings). Luego, haz clic en Servicios del sistema o Services Management. Busca «MySQL» y asegúrate de que aparezca como Activo o Running.

[TIP] Si ves que MySQL está detenido, simplemente haz clic en el botón de inicio. A veces, tras una actualización del servidor, el servicio se queda apagado.

2. Comprueba las credenciales de la base de datos

En Plesk, ve a Sitios web y dominios y selecciona tu dominio de PrestaShop. Busca la sección Bases de datos (o Databases). Ahí verás el nombre de tu base de datos y el usuario asociado.

Apunta estos datos:

Nombre de la base de datos (ej: mydomain_prestashop).
Nombre de usuario (ej: mydomain_user).
Contraseña (si no la recuerdas, puedes cambiarla desde aquí).

[WARNING] Si cambias la contraseña de la base de datos desde Plesk, deberás actualizarla también en el archivo de configuración de PrestaShop. Si no lo haces, el error seguirá apareciendo.

Solución paso a paso para el error conexión PrestaShop Plesk

Ahora que ya has hecho las comprobaciones básicas, vamos a las soluciones efectivas. Te recomiendo seguir este orden.

Paso 1: Actualizar la contraseña en el archivo de configuración

Este es el paso más común y suele resolver el 90% de los casos. Vamos a editar el archivo parameters.php.

Desde Plesk, entra en Sitios web y dominios > selecciona tu dominio > haz clic en Administrador de archivos (File Manager).
Navega hasta la carpeta httpdocs (o public_html) y luego a app/config/.
Busca el archivo parameters.php. Haz clic derecho sobre él y selecciona Editar (o Edit in Text Editor).
Dentro del archivo, busca la línea que contiene 'database_password' => 'tu_contraseña_antigua'. Cambia esa contraseña por la nueva que has establecido en Plesk.
Guarda los cambios y cierra el editor.
Ahora, intenta acceder a tu tienda. Si el error persiste, vamos al siguiente paso.

[INFO] En versiones antiguas de PrestaShop (1.6 o anteriores), el archivo es config/settings.inc.php y la línea es _DB_PASSWD_. El proceso es idéntico.

Paso 2: Verificar el nombre de la base de datos y el host

A veces, el error no está en la contraseña, sino en el nombre de la base de datos o en el servidor host. En el mismo archivo parameters.php, busca estas líneas:

'database_name' => 'el_nombre_de_tu_bd'
'database_host' => 'localhost' (o una IP como 127.0.0.1)

Asegúrate de que el nombre coincida exactamente con el que ves en Plesk. En cuanto al host, en la mayoría de los casos debe ser localhost. Sin embargo, algunos proveedores de hosting usan un host remoto (ej: mysql.midominio.com). Si no estás seguro, contacta a tu soporte de hosting.

[TIP] Si tu base de datos está en un servidor externo (como Amazon RDS), el host será una IP o un nombre de dominio largo. No lo cambies a localhost a menos que estés seguro.

Paso 3: Reparar la base de datos desde Plesk

Si las credenciales son correctas pero el error persiste, la base de datos puede estar corrupta. Plesk tiene una herramienta para repararla.

Ve a Sitios web y dominios > selecciona tu dominio > haz clic en Bases de datos.
Haz clic en el nombre de tu base de datos (ej: mydomain_prestashop).
Busca el botón Reparar (o Repair Database). Plesk ejecutará una comprobación y reparará las tablas dañadas automáticamente.
Después de la reparación, vuelve a cargar tu tienda.

[WARNING] Este proceso es seguro, pero si tienes una base de datos muy grande, puede tardar unos minutos. No interrumpas el proceso.

Paso 4: Revisar los permisos del usuario de la base de datos

A veces, el usuario de la base de datos ha perdido los permisos para acceder a las tablas. Esto puede pasar después de una restauración o migración.

En Plesk, ve a Bases de datos y haz clic sobre el nombre de tu base de datos.
Busca la sección Usuarios o User Management.
Verás el usuario asociado. Haz clic en el icono de editar (lápiz) junto a él.
Asegúrate de que tenga marcados todos los permisos, especialmente SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.
Guarda los cambios.

Paso 5: Comprobar el límite de conexiones simultáneas

Si tu tienda recibe mucho tráfico, es posible que el servidor MySQL esté alcanzando su límite de conexiones. Esto también genera un error de conexión.

Desde Plesk, no siempre puedes cambiar esto directamente, pero puedes consultar el límite actual.
Ve a Herramientas y configuraciones > Configuración de MySQL (o MySQL Configuration).
Busca el parámetro max_connections. Si ves que es muy bajo (ej: 30), puedes aumentarlo a 100 o 150, dependiendo de los recursos de tu plan de hosting.
Guarda los cambios y reinicia el servicio MySQL desde Servicios del sistema.

[INFO] Si tu plan de hosting no te permite modificar este parámetro, contacta a tu proveedor y solicita un aumento temporal.

Paso 6: Restaurar un backup reciente

Si nada de lo anterior funciona, es posible que el archivo de configuración esté tan dañado que sea mejor restaurar una copia de seguridad de tu tienda.

En Plesk, ve a Sitios web y dominios > selecciona tu dominio > haz clic en Copias de seguridad (Backup Manager).
Busca un backup reciente (de antes de que apareciera el error).
Restaura solo los archivos de PrestaShop (no la base de datos, a menos que estés seguro de que la base de datos también está corrupta).
Después de la restauración, vuelve a verificar el archivo parameters.php.

[WARNING] Restaurar un backup sobrescribirá los cambios recientes en tu tienda. Asegúrate de tener una copia de seguridad de los archivos actuales por si acaso.

Plesk PrestaShop problemas base de datos: Preguntas frecuentes (FAQ)

Aquí respondo las dudas más habituales de los usuarios que enfrentan este problema.

¿Por qué aparece el error después de cambiar la contraseña en Plesk?

Porque PrestaShop guarda la contraseña en su archivo de configuración. Si cambias la contraseña desde Plesk, debes actualizarla también en parameters.php. Es un paso que muchos olvidan.

¿Puedo usar phpMyAdmin para solucionar el error?

Sí, pero con cuidado. Desde Plesk puedes acceder a phpMyAdmin para verificar que las tablas existen y no están corruptas. Sin embargo, editar directamente la base de datos sin conocimiento puede empeorar las cosas. Úsalo solo para consultas simples.

¿Qué hago si el error aparece después de una migración de hosting?

Es muy común. Asegúrate de que el archivo parameters.php tenga los datos correctos del nuevo servidor (host, nombre de BD, usuario y contraseña). Además, verifica que la base de datos se haya importado completamente.

¿El error puede deberse a un plugin o módulo de PrestaShop?

Rara vez, pero es posible. Si instalaste un módulo justo antes del error, intenta desactivarlo manualmente desde la base de datos (cambiando la columna active a 0 en la tabla ps_module). Si no sabes hacerlo, mejor restaura un backup anterior.

¿Cómo evito este error en el futuro?

Anota las contraseñas cada vez que las cambies.
Haz backups periódicos de tu tienda y base de datos.
Mantén PrestaShop actualizado a la última versión.
No compartas las credenciales de la base de datos.

¿Qué pasa si uso otro panel como Syspanel (HestiaCP)?

Aunque este artículo se centra en Plesk, si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar. Accede a tu panel a través del puerto 2106 (ej: https://tudominio.com:2106). Dentro de Syspanel, busca la sección Bases de datos y sigue los mismos pasos: verifica credenciales, repara la base de datos y edita el archivo de configuración de PrestaShop. La lógica es idéntica.

[TIP] Si tu proveedor usa Syspanel, el acceso al administrador de archivos está en la pestaña Web > Editar archivos. Allí podrás modificar parameters.php sin problemas.

Conclusión: No entres en pánico

El error conexión PrestaShop Plesk es frustrante, pero rara vez significa que hayas perdido tu tienda. Siguiendo esta guía paso a paso, podrás solucionar error MySQL PrestaShop en la mayoría de los casos. Recuerda:

Empieza por lo básico: verifica que MySQL esté activo.
Actualiza la contraseña en el archivo de configuración.
Repara la base de datos desde Plesk.
Revisa los permisos del usuario.
Si todo falla, restaura un backup.

Si después de intentarlo todo el error persiste, contacta a tu proveedor de hosting. Ellos pueden revisar los logs del servidor y detectar problemas más profundos, como un fallo en el disco o una configuración incorrecta de MySQL.

¡Espero que esta guía te haya sido de ayuda! Ahora ya sabes cómo enfrentarte a este problema con confianza.