Cómo arreglar el error de conexión a la base de datos en PrestaShop (Plesk)

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

Cuando tu tienda PrestaShop muestra un mensaje como "Error de conexión a la base de datos", "PrestaShop DB error" o simplemente una página en blanco con un texto críptico, significa que tu tienda no puede comunicarse con el servidor donde se almacenan tus productos, pedidos y clientes.

Este es uno de los problemas más comunes y, afortunadamente, en la mayoría de los casos tiene una solución sencilla. En este artículo te voy a guiar paso a paso para que puedas arreglar el error conexion base datos prestashop cuando tu tienda está alojada en un servidor con Plesk.

---

¿Por qué ocurre este error?

Antes de lanzarnos a solucionarlo, es importante entender las causas más frecuentes. El mensaje de error puede aparecer por varias razones:

• Credenciales incorrectas en el archivo de configuración.
• El servicio de base de datos MySQL o MariaDB está detenido.
• El usuario de la base de datos no tiene permisos suficientes.
• La base de datos ha alcanzado su límite de tamaño o conexiones.
• Cambios recientes en la contraseña del usuario de la BD.
• El archivo parameters.php o settings.inc.php está dañado o mal configurado.

Vamos a revisar cada una de estas causas y cómo solucionarlas desde Plesk.

---

Paso 1: Verifica que el servicio MySQL/MariaDB esté activo

El primer paso es comprobar que el motor de base de datos está funcionando. Si el servicio está caído, prestashop no conecta con la base de datos, aunque todos los datos sean correctos.

Desde Plesk:

1. Inicia sesión en tu panel de Plesk.
2. Ve a Herramientas y configuración (en el menú lateral izquierdo).
3. Busca la sección Servidor y haz clic en Servicios.
4. Localiza el servicio de MySQL o MariaDB y comprueba que su estado sea "en ejecución" (normalmente aparece un punto verde).

Si el servicio está detenido, actívalo haciendo clic en el botón de inicio. Espera unos segundos y vuelve a intentar cargar tu tienda.

[WARNING] Si el servicio no arranca, puede haber un problema más profundo en el servidor. En ese caso, contacta con tu proveedor de hosting o con el administrador del servidor.

---

Paso 2: Comprueba las credenciales en el archivo de configuración

La causa más habitual del prestashop db error es que las credenciales de acceso a la base de datos hayan cambiado o se hayan escrito incorrectamente. PrestaShop guarda estos datos en dos archivos:

• /config/settings.inc.php (versiones antiguas de PrestaShop 1.6 y anteriores).
• /app/config/parameters.php (PrestaShop 1.7 y versiones posteriores).

Cómo revisar el archivo parameters.php:

1. Accede a tu servidor por FTP o mediante el administrador de archivos de Plesk.
2. Navega hasta la carpeta app/config/ dentro de la raíz de tu tienda.
3. Descarga el archivo parameters.php y ábrelo con un editor de texto (como Notepad++ o Sublime Text).
4. Busca las líneas que contienen database_host, database_name, database_user y database_password.

Cómo revisar el archivo settings.inc.php:

Si tu tienda es más antigua, el archivo estará en /config/settings.inc.php. Busca las constantes DB_NAME, DB_USER, DB_PASSWD y DB_SERVER.

¿Qué valores deben aparecer?

• database_host: normalmente es localhost o 127.0.0.1, aunque en algunos servidores gestionados puede ser un hostname específico como localhost:/var/run/mysqld/mysqld.sock.
• database_name: el nombre exacto de tu base de datos (suele tener un prefijo como tuusuario_bd).
• database_user: el usuario de la base de datos (a menudo igual que el nombre de la BD).
• database_password: la contraseña correspondiente.

[TIP] Si no estás seguro de cuáles son los valores correctos, puedes encontrarlos en Plesk entrando en Bases de datos dentro del panel de tu dominio. Ahí verás el nombre de la BD y el usuario asignado.

Si encuentras que la contraseña en el archivo no coincide con la que tienes en Plesk, corrígela y guarda el archivo. Luego súbelo de nuevo al servidor.

---

Paso 3: Genera una nueva contraseña para el usuario de la base de datos

A veces, aunque creas que la contraseña es correcta, puede haber caracteres especiales que se escapen mal en el archivo de configuración. La solución más rápida es generar una contraseña nueva y simple.

Pasos en Plesk:

1. Ve a Bases de datos dentro de tu dominio.
2. Haz clic en el nombre de la base de datos de tu tienda.
3. En la pestaña Usuarios, localiza el usuario asociado.
4. Haz clic en el icono de editar (lápiz) y cambia la contraseña por una nueva. Plesk te permite generar una contraseña segura automáticamente.
5. Guarda los cambios.

Ahora actualiza el archivo parameters.php o settings.inc.php con la nueva contraseña y vuelve a intentar cargar tu tienda.

[INFO] Si después de cambiar la contraseña el error persiste, asegúrate de que el usuario de la base de datos tiene permisos completos sobre la BD. En Plesk, dentro de la edición del usuario, marca la casilla "Todos los privilegios".

---

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

A veces el error conexion base datos prestashop se debe a que el usuario tiene permisos limitados. Por ejemplo, solo de lectura, y PrestaShop necesita escribir para guardar sesiones o actualizar el carrito.

Cómo otorgar todos los permisos:

1. En Plesk, entra en Bases de datos y selecciona tu BD.
2. Ve a la pestaña Usuarios.
3. Haz clic en el usuario correspondiente.
4. En la sección Privilegios, selecciona "Todos los privilegios".
5. Guarda los cambios.

[TIP] Si tu proveedor de hosting tiene una política restrictiva, como mínimo asegúrate de que el usuario tenga permisos de SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX y DROP. Sin estos, PrestaShop fallará al intentar escribir en la base de datos.

---

Paso 5: Comprueba si la base de datos está llena o corrupta

Otra causa común de prestashop db error es que la base de datos haya alcanzado su límite de almacenamiento o que tenga tablas corruptas.

Desde Plesk:

1. Ve a Bases de datos y selecciona tu BD.
2. Haz clic en phpMyAdmin para abrir el gestor de bases de datos.
3. En la pestaña Base de datos, observa el tamaño total. Si está cerca del límite permitido por tu plan, necesitarás liberar espacio o ampliar el plan.
4. Si sospechas de corrupción, selecciona todas las tablas (clic en "Seleccionar todo") y en el menú desplegable elige "Reparar tabla". Esto puede tardar unos minutos.

[WARNING] Antes de reparar tablas, realiza una copia de seguridad de la base de datos. En Plesk puedes hacerlo desde la pestaña "Copias de seguridad" dentro de la propia base de datos.

---

Paso 6: Revisa el archivo .htaccess y los permisos de carpetas

En algunos casos, prestashop no conecta porque el archivo .htaccess tiene reglas que bloquean la conexión, o porque los permisos de las carpetas son incorrectos y PrestaShop no puede generar archivos temporales.

Pasos a seguir:

1. Ve a la raíz de tu tienda por FTP.
2. Localiza el archivo .htaccess y descárgalo.
3. Ábrelo con un editor y busca líneas que redirijan o bloqueen el acceso a archivos .php en la carpeta config. Si encuentras algo así, coméntalo con # y guarda.
4. Revisa los permisos de las carpetas config, cache, log y var. Deben tener permisos 755 para carpetas y 644 para archivos.

[INFO] Si no te sientes cómodo editando el .htaccess, puedes renombrarlo a .htaccess.bak y volver a generar uno desde el panel de administración de PrestaShop (si logras acceder). Pero ojo: esto puede afectar a las URL amigables, así que tendrás que regenerarlas después.

---

Paso 7: Restaura una copia de seguridad reciente

Si has probado todo lo anterior y el error conexion base datos prestashop persiste, puede que la base de datos esté dañada de forma irreversible o que un cambio reciente (como una actualización de módulo) haya roto algo.

En ese caso, la solución más rápida es restaurar una copia de seguridad de tu tienda y/o base de datos.

Cómo restaurar en Plesk:

1. Ve a Bases de datos y selecciona tu BD.
2. Haz clic en Copias de seguridad.
3. Elige una copia reciente (idealmente antes de que empezara el problema).
4. Haz clic en Restaurar.

[WARNING] Ten en cuenta que restaurar una copia de seguridad sobrescribirá todos los datos actuales. Si has hecho pedidos o cambios recientes, los perderás. Asegúrate de que es la última opción.

---

Paso 8: Contacta con tu proveedor de hosting

Si después de seguir todos estos pasos el problema continúa, es posible que el fallo esté en el servidor (por ejemplo, límites de conexión MySQL, firewall o problemas de red interna). En ese caso, contacta con tu proveedor de hosting y explica que tienes un error conexion base datos prestashop en un entorno Plesk. Ellos podrán revisar los logs del servidor y ver si hay algo bloqueando la conexión.

---

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop dice "prestashop db error" pero antes funcionaba?

Normalmente ocurre después de un cambio en la contraseña del usuario de la BD, una actualización de PrestaShop o un movimiento de servidor. Revisa los pasos 2 y 3 de esta guía.

¿Puedo usar el mismo usuario de base de datos para dos tiendas distintas?

Técnicamente sí, pero no es recomendable. Cada tienda debería tener su propia base de datos y usuario. Si compartes usuario, puede haber conflictos de permisos o de escritura.

¿Qué hago si no tengo acceso a Plesk?

Si no tienes acceso al panel de Plesk, contacta con tu proveedor de hosting. Aun así, puedes intentar revisar los archivos de configuración por FTP, pero sin acceso a la gestión de la BD será difícil solucionarlo.

¿El error puede deberse a un plugin o módulo mal configurado?

Sí, aunque es menos común. Si el error aparece tras instalar un módulo nuevo, desactívalo desde la base de datos (cambiando el estado en la tabla ps_module) o restaura una copia de seguridad anterior.

¿Cómo sé si mi base de datos está en el puerto correcto?

En Plesk, el puerto por defecto es el 3306. Si tu servidor usa otro puerto, deberás indicarlo en el parámetro database_port del archivo parameters.php. En la mayoría de los casos, no necesitas especificarlo porque usa el predeterminado.

---

Conclusión

El error conexion base datos prestashop en Plesk puede parecer aterrador, pero en la gran mayoría de los casos se resuelve revisando las credenciales, los permisos y el estado del servicio MySQL. Te recomiendo seguir los pasos en orden, porque van de lo más simple a lo más complejo.

Recuerda siempre hacer una copia de seguridad antes de modificar cualquier archivo o base de datos. Y si te quedas atascado, no dudes en contactar con tu proveedor de hosting: para eso están.

[TIP] Para evitar futuros sustos, configura un sistema de alertas que te avise cuando tu tienda esté caída. Muchos servicios de monitorización ofrecen planes gratuitos muy útiles para tiendas online.

Espero que esta guía te haya sido de ayuda. Si tienes alguna duda, déjala en los comentarios y estaré encantado de ayudarte a resolverla. ¡Buena suerte con tu tienda!