Error conexión BD PrestaShop en Plesk | Solución rápida

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

Cuando visitas tu tienda PrestaShop y ves el mensaje "No se pudo conectar a la base de datos", significa que tu sitio web no puede comunicarse con el servidor MySQL donde se almacenan tus productos, pedidos, clientes y configuraciones. Es uno de los errores más comunes en PrestaShop, pero también uno de los más fáciles de solucionar si sabes dónde mirar.

Este error puede aparecer por varias razones: un cambio de contraseña, un fallo en el servidor, archivos de configuración corruptos o incluso un problema con los permisos de acceso. Lo bueno es que, siguiendo esta guía paso a paso, podrás diagnosticarlo y resolverlo en la mayoría de los casos sin necesidad de contactar con soporte técnico.

Diagnóstico inicial: identifica el origen del problema

Antes de tocar nada, es importante que entiendas qué está fallando exactamente. El error error base de datos prestashop plesk puede deberse a:

Credenciales incorrectas: La contraseña o el usuario de la base de datos ha cambiado.
Servidor MySQL caído: El servicio de base de datos no está activo en Plesk.
Archivo de configuración corrupto: El archivo parameters.php de PrestaShop tiene datos erróneos.
Permisos de usuario: El usuario de la base de datos no tiene privilegios suficientes.
Problemas de conexión: El host de la base de datos no es el correcto (por ejemplo, localhost vs 127.0.0.1).

Para empezar, accede a tu panel de control Plesk y verifica que el servicio MySQL esté funcionando. Ve a Herramientas y ajustes → Servicios del servidor y comprueba que MySQL/MariaDB aparece como "Activo". Si no lo está, actívalo y espera un par de minutos antes de volver a probar tu tienda.

Paso 1: Verifica las credenciales en Plesk

El primer lugar donde debes mirar es la sección de bases de datos en Plesk. Sigue estos pasos:

Inicia sesión en tu panel de Plesk.
Ve a Sitios web y dominios y selecciona tu dominio de PrestaShop.
Busca la sección Bases de datos y haz clic en el nombre de la base de datos que usa tu tienda.
Verás el nombre de usuario asociado y la opción de cambiar la contraseña.

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde aquí. Eso sí, luego tendrás que actualizar el archivo de configuración de PrestaShop con la nueva contraseña.

Anota estos tres datos: nombre de la base de datos, usuario y contraseña. Los necesitarás para el siguiente paso.

Paso 2: Localiza y edita el archivo de configuración de PrestaShop

PrestaShop guarda la configuración de conexión a la base de datos en un archivo llamado parameters.php. Este archivo se encuentra en la carpeta app/config/ dentro de la instalación de tu tienda.

Para acceder a él desde Plesk:

Ve a Sitios web y dominios → Administrador de archivos.
Navega hasta httpdocs/app/config/ (o htdocs/app/config/ si tu servidor usa esa estructura).
Busca el archivo parameters.php y haz clic derecho → Editar.

Dentro del archivo, busca una sección que se parece a esto:

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

Comprueba que estos valores coinciden exactamente con los que viste en Plesk. Si has cambiado la contraseña en el paso anterior, este es el lugar donde debes actualizarla.

[WARNING] Haz siempre una copia de seguridad de este archivo antes de editarlo. Si algo sale mal, podrás restaurarlo fácilmente.

Guarda los cambios y prueba de nuevo tu tienda. Si el error persiste, continúa con el siguiente paso.

Paso 3: Comprueba el host de la base de datos

Muchas veces el problema no es la contraseña, sino el valor de database_host. En la mayoría de los servidores compartidos, este valor debe ser localhost. Sin embargo, en algunos entornos Plesk, especialmente si usas una base de datos remota, el host puede ser diferente.

Prueba estas opciones en el archivo parameters.php:

localhost
127.0.0.1
El nombre del servidor MySQL que aparece en Plesk (suele ser algo como mysql.tudominio.com)

[INFO] Si tu proveedor de hosting usa un servidor MySQL externo, el host suele aparecer en la sección de bases de datos de Plesk. No lo adivines, léelo directamente.

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

En Plesk, cada base de datos tiene un usuario asociado. Este usuario debe tener permisos completos sobre la base de datos. Para verificarlo:

En Plesk, ve a Bases de datos y selecciona tu base de datos.
Haz clic en Usuarios (o "Usuarios de base de datos").
Comprueba que el usuario tiene marcada la opción Todos los privilegios o al menos los permisos de SELECT, INSERT, UPDATE y DELETE.

Si no tienen permisos suficientes, edítalos y concede todos los privilegios. Guarda los cambios y prueba de nuevo.

Paso 5: Reinicia los servicios de MySQL y PHP

A veces, el problema no está en la configuración sino en los servicios del servidor. Un reinicio puede solucionar el prestashop error conexion mysql de forma rápida.

Desde Plesk:

Ve a Herramientas y ajustes → Servicios del servidor.
Busca MySQL y haz clic en el botón de reiniciar (icono de flecha circular).
Haz lo mismo con PHP-FPM o Apache (según tu configuración).

Espera unos segundos y vuelve a cargar tu tienda. Esta acción es completamente segura y no afecta a tus datos.

Paso 6: Revisa los logs de error

Si después de todos estos pasos el error persiste, es hora de mirar los registros del servidor. Los logs te dirán exactamente qué está fallando.

En Plesk:

Ve a Sitios web y dominios → tu dominio → Registros (o "Logs").
Busca el archivo de error de PHP o el log de MySQL.
Fíjate en las líneas que contienen "database" o "SQL".

Los mensajes típicos que puedes encontrar:

Access denied for user 'usuario'@'localhost' → El usuario o contraseña no es correcto.
Unknown database 'nombre_db' → El nombre de la base de datos no existe.
Connection refused → El servidor MySQL no está escuchando en el puerto esperado.

Estos mensajes te darán pistas muy concretas sobre qué corregir.

Paso 7: Repara la instalación de PrestaShop

Si todo lo anterior falla, puede que la instalación de PrestaShop esté dañada. Una solución práctica es regenerar el archivo de configuración usando la herramienta de instalación de PrestaShop.

Descarga una copia limpia de PrestaShop de la misma versión que tienes instalada.
Sube el archivo parameters.php que viene en la instalación limpia a tu servidor (reemplazando el actual).
Edítalo con los datos correctos de tu base de datos (los que viste en Plesk).

Este método es más drástico, pero suele funcionar cuando el archivo original está muy dañado.

Paso 8: Comprueba el espacio en disco y los límites del servidor

Un detalle que a menudo se pasa por alto es que la base de datos puede estar llena o el servidor puede tener límites de memoria. Esto también provoca el error de conexión.

En Plesk:

Ve a Sitios web y dominios → Estadísticas para ver el uso de espacio.
Si estás cerca del límite, libera espacio eliminando copias de seguridad antiguas o archivos temporales.

También puedes aumentar el límite de memoria de PHP en Plesk: Herramientas y ajustes → Configuración de PHP → memory_limit. Ponlo al menos en 256M.

Paso 9: Contacta con tu proveedor de hosting

Si has llegado hasta aquí y el error sigue apareciendo, es posible que haya un problema a nivel de servidor que no puedas resolver tú mismo. En ese caso:

Abre un ticket de soporte con tu proveedor.
Explica que tienes un error base de datos prestashop plesk y que has verificado credenciales, permisos y servicios.
Adjunta los mensajes de error que aparecen en los logs.

Los proveedores suelen responder rápido porque este es un problema conocido y fácil de diagnosticar para ellos.

Consejos preventivos para evitar futuros errores

Una vez que hayas resuelto el problema, toma estas precauciones para que no vuelva a ocurrir:

Guarda las contraseñas en un gestor de contraseñas: Así siempre tendrás acceso a las credenciales correctas.
Haz copias de seguridad periódicas: En Plesk puedes programar copias automáticas de la base de datos.
Actualiza PrestaShop regularmente: Las versiones antiguas son más propensas a errores de conexión.
No cambies la contraseña de la base de datos sin actualizar el parameters.php: Es el error más común.

Preguntas frecuentes (FAQ)

¿Puedo arreglar este error sin acceso a Plesk?

Si no tienes acceso a Plesk, necesitarás al menos acceso FTP para editar el archivo parameters.php. Sin embargo, la mayoría de los proveedores te dan acceso a Plesk, ya que es el panel de control estándar.

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

En versiones muy antiguas de PrestaShop, el archivo se llama settings.inc.php y está en la carpeta config/. Busca ambos nombres en tu instalación.

¿El error afecta a mis datos?

No. Este error solo impide que tu tienda se muestre, pero los datos en la base de datos siguen intactos. Una vez solucionado, todo volverá a la normalidad.

¿Cuánto tiempo se tarda en arreglar?

Si el problema es solo de contraseña, menos de 10 minutos. Si es algo más complejo, puede llevar un par de horas. En cualquier caso, es un error que se resuelve el mismo día.

¿Puedo evitar que esto vuelva a pasar?

Sí, siguiendo los consejos preventivos que te he dado. La clave está en no cambiar credenciales sin actualizar el archivo de configuración y mantener todo bien documentado.

Conclusión

El error "No se pudo conectar a la base de datos" en PrestaShop con Plesk es frustrante, pero casi siempre tiene una solución sencilla. Siguiendo estos pasos, desde verificar credenciales hasta revisar los logs, podrás arreglar prestashop plesk en la mayoría de los casos sin ayuda externa. Recuerda siempre hacer copias de seguridad antes de modificar archivos y no dudes en contactar con tu proveedor si el problema persiste. Con un poco de paciencia, tu tienda volverá a estar operativa en poco tiempo.