Error de base de datos en PrestaShop Plesk: soluciones fáciles

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los problemas más comunes y frustrantes que puedes encontrar al gestionar tu tienda PrestaShop alojada en un servidor Plesk: el temido error de conexión a la base de datos.

No te preocupes, que aunque el mensaje de error parezca muy técnico, casi siempre la solución es sencilla y la puedes aplicar tú mismo. En esta guía extensa y paso a paso, te explicaré qué significa exactamente el error, por qué ocurre y, lo más importante, cómo solucionarlo para que tu tienda vuelva a funcionar en minutos.

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

Cuando ves un mensaje como "Link to database cannot be established" o "Error de conexión a la base de datos", significa que tu tienda PrestaShop no puede comunicarse con la base de datos donde guarda toda la información: productos, clientes, pedidos, configuraciones, etc.

Imagina que tu tienda es un edificio y la base de datos es el sótano donde guardas todos los archivos. Si la puerta del sótano está cerrada o la llave no funciona, no puedes acceder a nada. Eso es exactamente lo que le pasa a PrestaShop.

Síntomas comunes del error

La tienda muestra una página en blanco o un mensaje de error directo.
No puedes acceder al panel de administración (back office).
Aparecen errores como Error de conexión a la base de datos o Cannot connect to database.
Los cambios que haces en el catálogo no se guardan.
El sitio carga muy lento o se cae repentinamente.

Causas principales del error base datos PrestaShop Plesk

Antes de lanzarnos a solucionarlo, es importante entender qué lo provoca. Las causas más frecuentes son:

Credenciales incorrectas en el archivo de configuración de PrestaShop (el famoso settings.inc.php o parameters.php).
La base de datos ha sido eliminada o renombrada desde Plesk.
El usuario de la base de datos ha sido eliminado o se le ha cambiado la contraseña.
El servidor MySQL/MariaDB está caído o sobrecargado.
Problemas de permisos del usuario de la base de datos en Plesk.
Archivos de configuración dañados después de una migración o actualización fallida.

Preparación antes de empezar

Para solucionar el error PrestaShop conexión base datos, necesitarás acceso a dos lugares:

Plesk: El panel de control de tu hosting (normalmente accedes a través de https://tudominio.com:8443 o la URL que te haya dado tu proveedor).
Administrador de archivos de Plesk o acceso FTP para editar archivos de configuración.

[INFO] Si no recuerdas cómo acceder a Plesk, contacta con tu proveedor de hosting. Normalmente las credenciales te las dieron al contratar el servicio.

Paso 1: Identificar el tipo de error

Primero, vamos a ver si el error es de conexión o de base de datos en sí. Cuando entres a tu tienda, fíjate bien en el mensaje:

Error de conexión: "Link to database cannot be established" → El problema está en las credenciales o en que el servidor de base de datos no responde.
Error de base de datos: "Table 'ps_product' doesn't exist" → La base de datos existe pero está corrupta o le faltan tablas.

Para este artículo nos centraremos en el error de conexión, que es el más común en Plesk PrestaShop error DB.

Paso 2: Verificar que la base de datos y el usuario existen en Plesk

Vamos a lo primero: asegurarnos de que la base de datos que usa PrestaShop sigue existiendo en Plesk.

Inicia sesión en Plesk.
Ve a la sección Bases de datos (normalmente en el menú izquierdo, bajo "Sitios web y dominios" o directamente en "Bases de datos").
Busca tu base de datos. Normalmente se llama algo como tudominio_prestashop o similar.
Si no ves la base de datos, es posible que la hayan borrado por error. En ese caso, deberías restaurar una copia de seguridad (hablaremos de eso más adelante).

Si la base de datos sí aparece, haz clic en su nombre para ver los detalles. Deberías ver:

El nombre exacto de la base de datos.
El nombre del usuario asociado.
La contraseña (no la verás directamente, pero puedes cambiarla).

[WARNING] Si el usuario de la base de datos no aparece, o ves que está vacío, tendrás que crearlo de nuevo y asignarlo a la base de datos. Te explico cómo hacerlo en el Paso 4.

Paso 3: Localizar y revisar el archivo de configuración de PrestaShop

PrestaShop guarda las credenciales de la base de datos en un archivo de configuración. Dependiendo de la versión de PrestaShop, el archivo se llama:

PrestaShop 1.6 y anteriores: config/settings.inc.php
PrestaShop 1.7 y 8.x: app/config/parameters.php

Vamos a acceder a él mediante el Administrador de archivos de Plesk:

En Plesk, ve a Sitios web y dominios.
Busca tu dominio y haz clic en Administrador de archivos (o File Manager).
Navega hasta la carpeta de tu tienda (normalmente httpdocs o public_html).
Busca la carpeta config (para 1.6) o app/config (para 1.7+).
Abre el archivo correspondiente con el editor de texto integrado.

¿Qué debes buscar?

En settings.inc.php (1.6):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña');
define('_DB_PREFIX_', 'ps_');

En parameters.php (1.7+):

'database_host' => 'localhost',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'contraseña',
'database_prefix' => 'ps_',

[TIP] Si ves que el database_host dice localhost, está bien. Pero si tu base de datos está en un servidor remoto (algo raro en Plesk compartido), debería tener una dirección IP o un nombre de host.

Ahora, compara estos valores con los que viste en Plesk en el Paso 2. ¿Coinciden el nombre de la base de datos, el usuario y la contraseña? Si no es así, aquí está el problema.

Paso 4: Corregir las credenciales en Plesk o en el archivo de PrestaShop

Tienes dos opciones:

Opción A: Cambiar la contraseña en Plesk y actualizar PrestaShop

En Plesk, ve a Bases de datos > haz clic en tu base de datos.
Busca la opción Cambiar contraseña (o Change password).
Establece una contraseña nueva y segura (puedes usar el generador de Plesk).
Importante: Escribe la nueva contraseña en un bloc de notas.
Ahora, vuelve al archivo de configuración de PrestaShop (Paso 3) y actualiza la contraseña con la nueva.
Guarda los cambios.

Opción B: Crear un nuevo usuario de base de datos en Plesk

Si el usuario actual ha sido eliminado o no funciona:

En Plesk, ve a Bases de datos > haz clic en tu base de datos.
Busca Añadir nuevo usuario (o Add user).
Crea un usuario (por ejemplo, tuweb_user) y una contraseña segura.
Asigna todos los permisos (SELECT, INSERT, UPDATE, DELETE, etc.). Marca Todos los privilegios si es posible.
Anota el nombre de usuario y contraseña.
Actualiza el archivo de configuración de PrestaShop con estos nuevos datos.

[WARNING] Asegúrate de que el nombre de la base de datos en el archivo de configuración coincida exactamente con el que ves en Plesk. A veces Plesk añade prefijos como tudominio_ antes del nombre.

Paso 5: Verificar que el servidor de base de datos está funcionando

A veces el error no es culpa de PrestaShop, sino del servidor MySQL. Para comprobarlo:

En Plesk, ve a Herramientas y ajustes > Servicios (o Services).
Busca MySQL o MariaDB.
Verifica que el estado sea En ejecución (Running). Si está detenido, haz clic en Iniciar.

Si no tienes acceso a esta opción (en planes compartidos no siempre está disponible), contacta con tu proveedor de hosting y pregúntales: "¿El servidor MySQL está funcionando correctamente?"

Paso 6: Probar la conexión manualmente (para usuarios avanzados)

Si después de los pasos anteriores el error persiste, puedes probar la conexión directamente desde un script PHP temporal. Esto te ayudará a saber si el problema es de PrestaShop o de la base de datos.

Crea un archivo nuevo en el Administrador de archivos de Plesk, dentro de la carpeta de tu tienda, llamado test_db.php.
Pega este código (reemplaza los valores con los tuyos):

<?php
$host = 'localhost';
$db = 'nombre_base_datos';
$user = 'usuario_base_datos';
$pass = 'contraseña';

$conn = new mysqli($host, $user, $pass, $db);
if ($conn->connect_error) {
    die("Error de conexión: " . $conn->connect_error);
} else {
    echo "¡Conexión exitosa!";
}
$conn->close();
?>

Guarda el archivo y accede a él desde tu navegador: https://tudominio.com/test_db.php.
Si ves "¡Conexión exitosa!", el problema está en PrestaShop (archivos corruptos, caché, etc.). Si ves un error, entonces las credenciales o la base de datos siguen siendo el problema.

[TIP] No olvides eliminar el archivo test_db.php después de la prueba por seguridad.

Paso 7: Restaurar desde una copia de seguridad (si todo falla)

Si después de todo lo anterior el error solucionar PrestaShop Plesk no se resuelve, es posible que la base de datos esté corrupta o que los archivos de PrestaShop estén dañados. En ese caso, la solución más rápida es restaurar una copia de seguridad reciente.

Cómo restaurar en Plesk:

Ve a Sitios web y dominios > haz clic en tu dominio.
Busca Copias de seguridad (o Backup Manager).
Selecciona una copia de seguridad anterior al error.
Elige Restaurar todo (o solo la base de datos y los archivos de configuración).
Confirma la restauración.

[WARNING] La restauración borrará cualquier cambio que hayas hecho después de la fecha de la copia. Asegúrate de tener un backup reciente.

Preguntas Frecuentes (FAQ)

¿Por qué mi base de datos aparece vacía en Plesk?

Puede que la hayas eliminado sin querer, o que el hosting haya hecho una limpieza. Si tienes una copia de seguridad, restáurala. Si no, contacta con soporte técnico.

¿Puedo cambiar el nombre de la base de datos en Plesk sin romper PrestaShop?

Sí, pero luego debes actualizar el archivo parameters.php o settings.inc.php con el nuevo nombre. Hazlo con cuidado.

¿Qué hago si el archivo `settings.inc.php` no existe?

En PrestaShop 1.7+ se llama parameters.php. Si no aparece ninguno, es posible que tu instalación esté corrupta. Reinstala PrestaShop desde cero (pero antes guarda la base de datos).

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

Sí, algunos módulos mal programados pueden sobrescribir la configuración de la base de datos. Si el error apareció después de instalar un módulo, desactívalo desde el Administrador de archivos renombrando su carpeta en /modules.

¿Cómo evito este error en el futuro?

Realiza copias de seguridad periódicas (Plesk lo permite automáticamente).
No cambies contraseñas de base de datos sin actualizar PrestaShop.
Mantén PrestaShop y sus módulos actualizados.
Usa contraseñas seguras y no compartas las credenciales.

Resumen final

El error de conexión a base de datos en PrestaShop alojado en Plesk suele deberse a credenciales incorrectas o a que la base de datos o el usuario han sido eliminados. Siguiendo estos pasos:

Verifica que la base de datos y el usuario existen en Plesk.
Revisa el archivo de configuración de PrestaShop (settings.inc.php o parameters.php).
Corrige las credenciales (cambiando la contraseña o creando un nuevo usuario).
Asegúrate de que el servidor MySQL está funcionando.
Prueba la conexión con un script PHP.
Si nada funciona, restaura una copia de seguridad.

¡Y listo! Con esto tu tienda debería volver a la vida. Recuerda que si en algún momento te sientes perdido, siempre puedes contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo a Plesk y pueden ayudarte en minutos.

[TIP] Guarda esta guía en tus favoritos. Te será útil cada vez que veas el temido error de base de datos. ¡Buena suerte con tu tienda PrestaShop!