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

¡Vaya, qué frustrante es ese mensaje! Justo cuando necesitas actualizar tu tienda o consultar un pedido, te encuentras con el temido "Error de conexión a la base de datos" en PrestaShop. Es uno de los fallos más comunes, pero también uno de los más fáciles de solucionar si sabes dónde mirar.

En esta guía completa, vamos a desglosar, paso a paso y con un lenguaje muy claro, cómo arreglar este problema cuando tu tienda está alojada en un servidor con Plesk. No necesitas ser un experto en programación; solo sigue estas instrucciones y, en la mayoría de los casos, tu tienda volverá a la vida en cuestión de minutos.

Vamos a ello. Respira hondo, porque esto tiene solución.

¿Qué significa exactamente "Error de conexión a la base de datos"?

Antes de ponernos manos a la obra, es importante entender qué está pasando. PrestaShop es una aplicación que necesita guardar y leer información constantemente: productos, precios, clientes, pedidos... Toda esa información se almacena en una base de datos MySQL. Cuando ves el error base datos prestashop plesk, significa que tu tienda (el código PHP) no puede comunicarse con esa base de datos.

Imagina que tu tienda es una biblioteca (PrestaShop) y la base de datos es el almacén donde están todos los libros (tus productos). El error ocurre cuando el bibliotecario intenta abrir la puerta del almacén y no puede porque la llave no funciona, la puerta está bloqueada o, simplemente, el almacén se ha mudado.

Las causas más habituales de este fallo suelen ser:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos en el archivo de configuración de PrestaShop no coinciden con los reales en Plesk.
El servidor MySQL está caído: El servicio de base de datos no está corriendo en el servidor.
Host de la base de datos erróneo: A veces, el archivo de configuración apunta a "localhost" cuando debería apuntar a una dirección IP específica o un nombre de host, o viceversa.
Espacio en disco lleno: Si el disco del servidor está lleno, MySQL puede fallar al intentar escribir o leer datos, lo que provoca errores de conexión.
Permisos de usuario revocados: El usuario de la base de datos ya no tiene permisos para acceder a ella.
Archivos corruptos: Algún archivo de configuración de PrestaShop se ha dañado o está incompleto.

Ahora que sabemos qué buscar, vamos a la acción. Sigue estos pasos en orden, ya que van de lo más sencillo a lo más complejo.

Paso 1: Verifica que el servidor MySQL está activo (y el disco lleno)

El primer paso es asegurarte de que el motor de base de datos está funcionando. Si MySQL está caído, nada de lo que hagas en la configuración funcionará.

Accede a tu panel de control Plesk. Normalmente es algo como https://tu-dominio.com:8443 o https://IP-de-tu-servidor:8443.
En el menú lateral izquierdo, busca la sección "Herramientas y ajustes" (o "Tools & Settings").
Dentro de esta sección, busca el apartado "Servidor" o "Gestión de servidor" y haz clic en "Servicios" o "Services Management".
Busca el servicio llamado "MySQL" o "MariaDB" (es el mismo motor, pero con otro nombre). Al lado verás un icono de play (verde) o de stop (rojo).
Si está en rojo o parado, haz clic en el icono de play para iniciarlo.

[TIP] Mientras estás en esta sección, también puedes comprobar el espacio en disco. En el menú principal de Plesk, busca "Información del sistema" o "System Overview". Si el disco está al 90% o más de su capacidad, este podría ser el problema. Si es así, libera espacio (borra copias de seguridad antiguas, logs, etc.) y reinicia el servicio MySQL.

Si el servicio ya estaba activo y el disco tiene espacio, continúa con el siguiente paso.

Paso 2: Revisa el archivo de configuración de PrestaShop (parameters.php)

Este es el corazón del problema en la mayoría de los casos. PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php. Si este archivo tiene información incorrecta, tu tienda no podrá conectarse.

Conecta a tu servidor por FTP (usando FileZilla, por ejemplo) o a través del Administrador de archivos que viene integrado en Plesk.
Navega hasta la carpeta raíz de tu tienda PrestaShop. Normalmente es httpdocs o public_html.
Dentro, busca la carpeta app/config.
Ahí encontrarás el archivo parameters.php. Descárgalo y ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text). No uses Word.
Busca una sección que se llama 'database_params' o 'database'. Verás algo como esto (los valores exactos variarán):

'database_host' => 'localhost',
'database_name' => 'tu_usuario_bd',
'database_user' => 'tu_usuario_bd',
'database_password' => 'TuContraseñaSecreta',
'database_prefix' => 'ps_',

Ahora, aquí viene la parte clave: estos valores deben coincidir EXACTAMENTE con los que tienes en Plesk.

Cómo obtener los datos correctos desde Plesk

Ve a tu panel de Plesk.
En el menú lateral, busca "Bases de datos" (o "Databases").
Verás una lista de las bases de datos asociadas a tu dominio. Anota el nombre exacto de la base de datos que usa tu PrestaShop (suele ser algo como tu_dominio_bd).
Haz clic en el nombre de la base de datos para entrar. Ahí verás la lista de usuarios que tienen acceso a ella. Anota el nombre de usuario.
Si no recuerdas la contraseña, tendrás que cambiarla. En la parte de usuarios, haz clic en el icono de "cambiar contraseña" (normalmente un candado o un lápiz). Establece una nueva y guárdala bien.

[WARNING] Si cambias la contraseña en Plesk, debes actualizarla también en el archivo parameters.php. Si no, tu tienda seguirá sin conectar.

Ahora, compara los datos de Plesk con los del archivo parameters.php:

database_host: En el 99% de los casos en Plesk, este valor debe ser localhost. Si tu hosting usa un servidor de base de datos externo, te lo habrán proporcionado en un correo. Si no estás seguro, pon localhost.
database_name: Debe ser idéntico al nombre que ves en Plesk.
database_user: Debe ser idéntico al nombre de usuario que ves en Plesk.
database_password: Debe ser la contraseña que has verificado o cambiado en Plesk.

Si algún valor era incorrecto, corrígelo, guarda el archivo y súbelo de vuelta al servidor (reemplazando el antiguo) vía FTP.

[INFO] A veces, el archivo parameters.php puede tener una sintaxis rota. Si al abrirlo ves caracteres extraños o no parece un archivo PHP válido (empieza con <?php), es posible que esté corrupto. En ese caso, lo más seguro es restaurar este archivo desde una copia de seguridad reciente de tu tienda.

Paso 3: Prueba la conexión manualmente (para ver el error exacto)

Si después de revisar el archivo de configuración sigues sin suerte, vamos a comprobar si el problema es de PrestaShop o del servidor. Para ello, vamos a crear un pequeño archivo de prueba.

Crea un archivo de texto en tu ordenador y nómbralo testdb.php.
Ábrelo con el Bloc de notas y pega este código (reemplaza los datos con los tuyos):

<?php
$link = mysqli_connect("localhost", "TU_USUARIO", "TU_CONTRASEÑA", "TU_NOMBRE_BD");

if (!$link) {
    echo "Error: No se pudo conectar a MySQL." . PHP_EOL;
    echo "Error número: " . mysqli_connect_errno() . PHP_EOL;
    echo "Error detalle: " . mysqli_connect_error() . PHP_EOL;
} else {
    echo "¡Conexión exitosa! La base de datos está accesible.";
    mysqli_close($link);
}
?>

[WARNING] Cambia localhost, TU_USUARIO, TU_CONTRASEÑA y TU_NOMBRE_BD por los datos reales que has verificado en el Paso 2. No lo subas sin cambiar los datos o no servirá de nada.

Sube este archivo testdb.php a la carpeta raíz de tu tienda (la misma donde están las carpetas app, bin, config, etc.) mediante FTP o el Administrador de archivos de Plesk.
Ahora, abre tu navegador y ve a https://tu-dominio.com/testdb.php.

Interpretando los resultados:

"¡Conexión exitosa!": Esto es genial. Significa que los datos de conexión son correctos y que MySQL funciona. El problema está dentro de la configuración de PrestaShop. Revisa que el archivo parameters.php esté correctamente subido y que no haya errores de sintaxis. También revisa que el archivo .htaccess de la raíz no esté redirigiendo algo raro.
"Error número: 2002": Este es el famoso error 2002 prestashop. Este código significa que MySQL no puede ser encontrado en el host especificado. Si tu database_host es localhost, prueba a cambiarlo por 127.0.0.1 en el archivo testdb.php y en parameters.php. A veces, el servidor no resuelve "localhost" correctamente.
"Error número: 1045": Este error significa "Acceso denegado para el usuario". Es decir, el usuario o la contraseña son incorrectos. Revisa que no hayas copiado espacios en blanco y que la contraseña sea exactamente la que pusiste en Plesk.
"Error número: 1044": Este error indica que el usuario no tiene permisos para acceder a la base de datos. Vuelve a Plesk, entra en la base de datos y asegúrate de que el usuario que estás usando está en la lista de usuarios con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

Una vez hayas terminado la prueba, ¡BORRA el archivo testdb.php! Dejar un archivo con credenciales en tu servidor es un grave riesgo de seguridad.

Paso 4: Revisa los permisos de los archivos (si todo lo demás falla)

A veces, el error no es de conexión, sino de permisos. PrestaShop necesita poder leer y escribir en ciertos archivos y carpetas. Si los permisos son demasiado restrictivos, puede dar errores extraños.

Ve al Administrador de archivos de Plesk para tu dominio.
Navega a la raíz de tu PrestaShop.
Selecciona todos los archivos y carpetas y haz clic en "Permisos" o "Change Permissions".
Asegúrate de que los permisos sean 755 para las carpetas y 644 para los archivos. En Plesk, puedes marcar las casillas correspondientes.
Aplica los cambios.

[INFO] La carpeta var/cache (o app/cache en versiones antiguas) a veces necesita permisos más permisivos, como 775. Si después de este paso sigues con problemas, prueba a darle permisos 777 a esa carpeta temporalmente, borra su contenido y vuelve a poner 755. Esto fuerza a PrestaShop a regenerar la caché.

Paso 5: Contacta con tu proveedor de hosting (si nada funciona)

Si has llegado hasta aquí y el problema persiste, es muy probable que el problema esté en el servidor y no en tu tienda. Puede ser un problema de red, un firewall bloqueando las conexiones a MySQL, o un fallo de configuración del servidor que solo ellos pueden ver.

Antes de contactarles, ten a mano esta información:

El código de error exacto que te aparece (por ejemplo, 2002, 1045, 1044).
El mensaje de error completo.
Los pasos que ya has realizado (verificado servicio, cambiado contraseña, probado con testdb.php).
La fecha y hora en que empezó el problema.

Con esta información, el soporte técnico podrá diagnosticar el problema mucho más rápido.

Preguntas Frecuentes (FAQ) sobre el Error de Conexión a BD

¿Por qué mi PrestaShop no conecta con MySQL si antes funcionaba?

Esto suele pasar después de un cambio en el servidor. Puede ser que tu proveedor de hosting haya actualizado la contraseña de la base de datos, haya movido el servidor de MySQL a otra IP, o haya habido un fallo temporal que corrompió el archivo parameters.php. Revisar el Paso 2 es el mejor punto de partida.

¿Qué significa exactamente el código de error 2002 en PrestaShop?

El error 2002 prestashop es un código de MySQL que indica que el cliente (tu tienda) no puede encontrar el servidor de base de datos. Es un problema de red o de host. Como mencionamos, la solución más común es cambiar localhost por 127.0.0.1 o verificar que el nombre del host proporcionado por tu hosting sea correcto.

¿Puedo usar la misma base de datos para dos instalaciones de PrestaShop?

Técnicamente puedes, pero es una pésima idea. Cada instalación usa un prefijo de tabla (ej. ps_). Si usas la misma base de datos con diferentes prefijos, funcionará, pero es mucho más complicado de gestionar, las copias de seguridad son más grandes y hay riesgo de colisión de datos. Es mucho mejor crear una base de datos separada para cada tienda.

¿Qué hago si he olvidado la contraseña de la base de datos en Plesk?

No hay problema. Puedes cambiarla fácilmente. Ve a Plesk > Bases de datos, haz clic en el nombre de tu base de datos, busca el usuario en la lista y utiliza la opción de "Cambiar contraseña". Después, actualiza el archivo parameters.php con la nueva contraseña. Es un proceso de 5 minutos.

¿El error de conexión puede estar causado por un plugin o módulo de PrestaShop?

Es poco probable, pero no imposible. Un módulo mal codificado podría estar haciendo llamadas directas a la base de datos con credenciales incorrectas. Sin embargo, el error de conexión general que ves en toda la tienda casi siempre se debe a los archivos de configuración principales o al estado del servidor MySQL.

Esperamos que esta guía te haya sido de gran ayuda. Como has visto, el error base datos prestashop plesk no es un monstruo de siete cabezas. Con paciencia y siguiendo estos pasos lógicos, podrás identificar y solucionar el problema. ¡Buena suerte con tu tienda!