Error de base de datos en PrestaShop con Plesk: causas y soluciones

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí, probablemente te ha aparecido un mensaje de error como "No se puede conectar a la base de datos" en tu tienda PrestaShop alojada en un servidor Plesk. No te preocupes, es uno de los problemas más comunes y, por lo general, tiene una solución sencilla. En esta guía te voy a explicar paso a paso cómo resolver el error de conexión a base de datos en PrestaShop con Plesk, desde lo más básico hasta soluciones más avanzadas. Vamos a asegurarnos de que tu tienda vuelva a funcionar sin perder datos.

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

Cuando ves el mensaje "Error de conexión a la base de datos" en PrestaShop, significa que tu tienda no puede comunicarse con el servidor MySQL o MariaDB donde se almacena toda la información (productos, pedidos, clientes, etc.). Esto puede deberse a varias razones, como cambios en la contraseña, problemas con el servidor de bases de datos o archivos de configuración dañados. No entres en pánico: la mayoría de las veces se arregla en minutos.

Causas comunes del error PrestaShop Plesk conexión

Antes de lanzarnos a solucionarlo, es útil entender qué lo causa. Estas son las razones más frecuentes:

Contraseña incorrecta: Has cambiado la contraseña de la base de datos en Plesk pero no has actualizado el archivo de configuración de PrestaShop.
Usuario o nombre de base de datos incorrecto: Al migrar o restaurar, los datos pueden no coincidir.
Servidor MySQL caído: El servicio de base de datos puede estar detenido en el servidor.
Archivo settings.inc.php corrupto: Este archivo contiene las credenciales de conexión y puede dañarse.
Permisos de usuario insuficientes: El usuario de la base de datos no tiene acceso a la base de datos correcta.
Problemas de conexión remota: Si la base de datos está en otro servidor (lo cual es raro en Plesk compartido), puede haber problemas de firewall.

Paso 1: Verifica el estado del servicio MySQL en Plesk

Lo primero es asegurarnos de que el servidor de bases de datos esté funcionando. En Plesk, esto es muy sencillo.

Accede a Plesk y revisa los servicios

Inicia sesión en tu panel de Plesk (normalmente en https://tudominio.com:8443).
Ve a Herramientas y Configuración (en la barra lateral izquierda).
Busca la sección Servicios y haz clic en Administración de servicios.
Busca el servicio MySQL o MariaDB. Su estado debe ser "Ejecutando". Si está detenido, haz clic en el botón de inicio (icono de play).

[INFO] Si no ves esta opción, es posible que tu plan de hosting no te permita gestionar servicios. En ese caso, contacta con tu proveedor de hosting y pídeles que verifiquen que MySQL esté activo.

Paso 2: Revisa las credenciales en el archivo settings.inc.php

El archivo settings.inc.php es el corazón de la conexión a la base de datos en PrestaShop. Está ubicado en la carpeta config/ de tu instalación. Si los datos no coinciden con los de Plesk, tendrás el error.

Cómo localizar y editar el archivo

Accede a tu servidor mediante FTP o el Administrador de Archivos de Plesk.
- En Plesk, ve a Sitios web y dominios, selecciona tu dominio y haz clic en Administrador de archivos.
Navega hasta la carpeta config/ dentro de la raíz de tu PrestaShop (normalmente httpdocs/ o public_html/).
Busca el archivo settings.inc.php. Si no lo ves, asegúrate de que estás viendo archivos ocultos (en el Administrador de archivos, hay un botón para mostrar archivos ocultos).
Haz clic derecho sobre el archivo y selecciona Editar (o descárgalo, edítalo con un editor de texto como Notepad++ y súbelo de nuevo).

Verifica los valores correctos

Dentro del archivo, busca estas líneas (al principio):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base');
define('_DB_USER_', 'usuario_de_tu_base');
define('_DB_PASSWD_', 'contraseña');

DB_SERVER: Normalmente es localhost, a menos que tu base de datos esté en un servidor remoto.
DB_NAME: Debe coincidir exactamente con el nombre de la base de datos en Plesk.
DB_USER: El usuario debe tener acceso a esa base de datos.
DB_PASSWD: La contraseña debe ser la correcta.

[WARNING] Ten mucho cuidado al editar este archivo. Un error tipográfico (como una coma o una comilla mal puesta) puede romper toda la tienda. Si no estás seguro, haz una copia de seguridad antes de modificar.

Cómo obtener los datos correctos desde Plesk

En Plesk, ve a Sitios web y dominios y haz clic en Bases de datos.
Verás una lista de tus bases de datos. Haz clic en el nombre de la base de datos que usa tu PrestaShop.
Verás el nombre de la base de datos, el usuario asociado y la opción de Cambiar contraseña. Si no recuerdas la contraseña, puedes cambiarla aquí (pero luego tendrás que actualizarla en el archivo settings.inc.php).

Paso 3: Prueba la conexión manualmente

Para asegurarte de que las credenciales son correctas, puedes probar la conexión desde el propio panel de Plesk o usando una herramienta como phpMyAdmin.

Usa phpMyAdmin desde Plesk

En la misma sección de Bases de datos, haz clic en phpMyAdmin (icono de base de datos).
Se abrirá una ventana de inicio de sesión. Introduce el usuario y la contraseña que tienes en settings.inc.php.
Si puedes acceder y ver las tablas de PrestaShop, la conexión es correcta. Si no, el problema está en las credenciales.

[TIP] Si no recuerdas la contraseña, en Plesk puedes cambiarla fácilmente: ve a la base de datos, haz clic en Cambiar contraseña, establece una nueva y luego actualiza settings.inc.php con esa misma contraseña.

Paso 4: Repara la base de datos si está corrupta

A veces la base de datos puede dañarse (por ejemplo, tras una migración o un corte de energía). Esto también puede provocar el error de conexión.

Reparar desde phpMyAdmin

Accede a phpMyAdmin como en el paso anterior.
En el panel izquierdo, selecciona tu base de datos.
Marca todas las tablas (puedes usar el checkbox superior).
En el menú desplegable de Con seleccionados, elige Reparar tabla.
Espera a que termine. Verás un mensaje de éxito o error.

Reparar desde la línea de comandos (si tienes acceso SSH)

Si tu hosting te permite SSH, puedes usar este comando (reemplaza nombre_base por el tuyo):

mysqlcheck -u usuario -p --auto-repair nombre_base

Te pedirá la contraseña y luego reparará las tablas automáticamente.

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

Un error común es que el usuario tenga permisos insuficientes. En Plesk, los usuarios suelen tener todos los permisos sobre su base de datos, pero a veces se pierden.

En Plesk, ve a Bases de datos y haz clic en el nombre de tu base.
Busca la sección Usuarios.
Asegúrate de que el usuario que usas en settings.inc.php esté listado y tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, edítalo y concede todos.
Guarda los cambios.

Paso 6: Revisa el archivo .htaccess y la configuración de PHP

A veces, un archivo .htaccess corrupto o una configuración de PHP incorrecta pueden interferir con la conexión.

Restaura el .htaccess por defecto de PrestaShop

Conéctate por FTP o al Administrador de archivos.
En la raíz de tu PrestaShop, localiza el archivo .htaccess.
Renómbralo a .htaccess_old (como respaldo).
Ve al panel de administración de PrestaShop (si puedes acceder) y regenera el .htaccess desde Parámetros de la tienda > Tráfico y SEO > URL amigables. Si no puedes acceder, puedes descargar un .htaccess de una instalación limpia de PrestaShop y subirlo, ajustando el nombre de la carpeta si es necesario.

Aumenta el límite de memoria PHP

A veces, un error de conexión puede deberse a que PHP se queda sin memoria. En Plesk, puedes ajustar esto:

Ve a Sitios web y dominios > selecciona tu dominio > Configuración de PHP.
Busca memory_limit y cámbialo a al menos 256M (o 512M si tu tienda es grande).
Guarda los cambios.

Paso 7: Solución avanzada: Reinstalar PrestaShop conservando los datos

Si nada de lo anterior funciona, puedes reinstalar PrestaShop sin perder tus datos. Esto reescribirá los archivos de configuración.

[WARNING] Este método es más drástico. Asegúrate de tener una copia de seguridad completa de los archivos y la base de datos antes de continuar.

Pasos para reinstalar conservando la base de datos

Haz una copia de seguridad de tu base de datos desde phpMyAdmin (exportar como SQL).
Descarga una copia de todos los archivos de tu tienda (por FTP o el Administrador de archivos).
Elimina todos los archivos de la carpeta raíz de PrestaShop (excepto la carpeta img y themes si quieres conservar imágenes y plantillas).
Sube una instalación limpia de PrestaShop de la misma versión que tenías.
Ejecuta la instalación desde el navegador (tudominio.com/install). Cuando te pida la base de datos, introduce los datos de tu base de datos existente (no crees una nueva). PrestaShop detectará que ya hay tablas y te preguntará si quieres conservarlas. Selecciona Sí.
Una vez terminada la instalación, elimina la carpeta install y renombra admin (si cambió).

Preguntas frecuentes (FAQ)

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

Porque el archivo settings.inc.php aún tiene la contraseña antigua. Cámbiala en el archivo como te expliqué en el Paso 2.

¿Puedo usar una base de datos remota en Plesk?

Sí, pero es raro. Si lo haces, en DB_SERVER debes poner la IP del servidor remoto y asegurarte de que el firewall permita la conexión (puerto 3306).

¿Qué hago si no puedo acceder al panel de administración de PrestaShop?

Si el error de conexión te impide entrar, edita el archivo settings.inc.php directamente por FTP. Si no tienes acceso FTP, contacta con tu proveedor de hosting.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos común. Si el error apareció después de instalar un módulo, desactívalo renombrando su carpeta en /modules/. Si el error desaparece, ese módulo es el culpable.

Consejos finales para evitar futuros errores

Haz copias de seguridad periódicas: Tanto de archivos como de la base de datos. Plesk tiene herramientas automáticas para ello.
Actualiza PrestaShop y los módulos: Las versiones antiguas pueden tener bugs que causen errores de conexión.
No modifiques el archivo settings.inc.php manualmente si no es necesario: Si usas un gestor de bases de datos, asegúrate de que los cambios se reflejen en el archivo.
Monitorea el estado del servidor: Si el error se repite, puede ser un problema de recursos del servidor. Considera actualizar tu plan de hosting.

Espero que esta guía te haya ayudado a resolver el error de conexión a base de datos en PrestaShop con Plesk. Recuerda que la paciencia es clave: ve paso a paso y no dudes en pedir ayuda a tu proveedor de hosting si algo se complica. ¡Tu tienda volverá a funcionar en poco tiempo!

[TIP] Si después de seguir todos los pasos el error persiste, verifica que no haya un problema de firewall en el servidor bloqueando el puerto 3306. En Plesk, puedes revisar las reglas de firewall en Herramientas y Configuración > Firewall.