Error conexión base de datos PrestaShop Plesk: Solución rápida

Antes de Empezar: ¿Qué es el Error de Conexión a la Base de Datos en PrestaShop?

Cuando visitas tu tienda PrestaShop y ves un mensaje como "Error de conexión a la base de datos", "Link to database cannot be established" o simplemente una pantalla en blanco con un texto similar, no te asustes. Es uno de los errores más comunes, pero también uno de los más fáciles de solucionar si sabes por dónde empezar.

Este error indica que PrestaShop no puede comunicarse con la base de datos MySQL donde se almacenan tus productos, clientes, pedidos y configuraciones. Las causas pueden ser varias: desde un cambio de contraseña hasta un servidor sobrecargado. Vamos a ver paso a paso cómo diagnosticarlo y solucionarlo, especialmente si usas Plesk como panel de control de hosting.

Paso 1: Identificar el Origen del Error

Antes de tocar nada, es importante saber si el problema es temporal o permanente.

¿El error aparece en toda la tienda o solo en algunas páginas?

Toda la tienda caída: El problema es general. Revisa los pasos de conexión.
Solo en el backoffice (admin): Puede ser un problema de permisos o de la configuración de la tienda.
Aparece al instalar un módulo o tema: El nuevo código puede estar mal escrito o pedir una versión de PHP incompatible.

¿Has hecho algún cambio reciente?

Pregúntate: ¿cambiaste la contraseña de la base de datos? ¿Actualizaste PrestaShop? ¿Modificaste archivos de configuración? ¿Instalaste un plugin de seguridad? Cualquier cambio puede desencadenar el error.

Paso 2: Acceder a Plesk y Verificar el Estado de la Base de Datos

Plesk es el panel de control de tu hosting. Aquí gestionas bases de datos, usuarios y archivos.

2.1. Inicia sesión en Plesk

Accede a tu panel de Plesk con las credenciales que te proporcionó tu proveedor de hosting. Normalmente es algo como https://tudominio.com:8443 o una URL específica.

2.2. Busca la sección "Bases de Datos"

En el menú lateral, busca "Bases de Datos" o "Databases". Verás una lista con todas las bases de datos de tu cuenta.

2.3. Comprueba que la base de datos existe y está activa

Localiza la base de datos que usa tu PrestaShop. El nombre suele ser algo como tudominio_prestashop o similar. Haz clic en el nombre para ver sus detalles.

[TIP] Si no ves la base de datos, puede que se haya eliminado accidentalmente o que estés en el plan de hosting equivocado. Contacta con tu soporte.

2.4. Verifica el usuario y la contraseña

Dentro de la base de datos, verás un apartado de "Usuarios". Debe haber al menos un usuario asociado. Anota el nombre del usuario y asegúrate de que tenga permisos suficientes (normalmente ALL PRIVILEGES).

Paso 3: Revisar el Archivo de Configuración de PrestaShop (app/config/parameters.php)

PrestaShop guarda los datos de conexión en un archivo llamado parameters.php. Si los datos de la base de datos han cambiado (por ejemplo, al restaurar una copia de seguridad), este archivo debe actualizarse.

3.1. Accede al administrador de archivos de Plesk

En Plesk, ve a "Archivos" o "File Manager". Navega hasta la carpeta raíz de tu tienda (normalmente httpdocs o public_html).

3.2. Localiza el archivo `parameters.php`

La ruta completa es: app/config/parameters.php. Si no lo ves, puede que esté en config/parameters.php en versiones antiguas de PrestaShop.

3.3. Abre el archivo y revisa los valores

Busca las líneas que empiezan con:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_de_tu_base',
'database_user' => 'usuario_de_tu_base',
'database_password' => 'contraseña_de_tu_base',

Comprueba que coincidan exactamente con los datos de tu base de datos en Plesk. Si no, edítalos.

[WARNING] Ten cuidado al editar este archivo. Un error de sintaxis (como una coma mal puesta) puede romper toda la tienda. Haz siempre una copia de seguridad antes.

3.4. Guarda los cambios y prueba

Guarda el archivo y recarga tu tienda. Si el error persiste, pasa al siguiente paso.

Paso 4: Probar la Conexión desde PHPMyAdmin

PHPMyAdmin es una herramienta que viene con Plesk para gestionar bases de datos desde el navegador. También puedes usarla para probar si la conexión funciona.

4.1. Abre PHPMyAdmin desde Plesk

En Plesk, busca "phpMyAdmin" en el menú de la base de datos. Haz clic y se abrirá una nueva pestaña.

4.2. Inicia sesión con los mismos datos

Usa el mismo usuario y contraseña que pusiste en parameters.php. Si no puedes iniciar sesión, el problema está en la contraseña o en los permisos del usuario.

4.3. Si no puedes iniciar sesión, restablece la contraseña

Vuelve a Plesk, entra en la base de datos, busca el usuario y haz clic en "Cambiar contraseña". Pon una nueva contraseña segura (usa mayúsculas, minúsculas, números y símbolos). Luego, actualiza el archivo parameters.php con esta nueva contraseña.

[INFO] Si cambias la contraseña, recuerda que cualquier otro servicio que use esa base de datos (como un ERP o una app móvil) también deberá actualizarse.

Paso 5: Verificar el Servidor MySQL

A veces el problema no está en tu configuración, sino en el servidor de bases de datos.

5.1. Comprueba si MySQL está funcionando

En Plesk, ve a "Herramientas y Ajustes" > "Servicios" o "Services". Busca "MySQL" y asegúrate de que esté en estado "Running" o "Activo".

5.2. Si está detenido, reinícialo

Haz clic en el icono de reinicio (suele ser un círculo con una flecha). Espera unos segundos y vuelve a probar tu tienda.

5.3. Si no puedes reiniciarlo, contacta con soporte

Si no tienes permisos para reiniciar servicios, es probable que estés en un plan de hosting compartido. Contacta con tu proveedor y diles que el servicio MySQL está caído.

Paso 6: Revisar los Logs de Error

Los logs son como el "diario de a bordo" de tu servidor. Allí se registran todos los errores, incluidos los de base de datos.

6.1. Accede a los logs en Plesk

En Plesk, ve a "Sitios web y dominios" > selecciona tu dominio > "Logs" o "Logs de errores". Busca archivos como error.log o php_error.log.

6.2. Busca mensajes relacionados con MySQL

Usa el buscador del navegador (Ctrl+F) y escribe palabras como "database", "MySQL", "connection" o "PDO". Verás líneas como:

PHP Fatal error: Uncaught PDOException: SQLSTATE[HY000] [2002] Connection refused

Eso indica que el servidor MySQL está rechazando la conexión. Puede ser por un firewall, un límite de conexiones o un reinicio reciente.

6.3. Interpreta el mensaje

"Connection refused": El servidor MySQL no acepta conexiones. Revisa el paso 5.
"Access denied for user": Usuario o contraseña incorrectos. Revisa los pasos 3 y 4.
"Unknown database": El nombre de la base de datos no existe. Verifica que el nombre en parameters.php sea exactamente el mismo que en Plesk.

Paso 7: Soluciones Avanzadas (Para Usuarios con Más Experiencia)

Si los pasos anteriores no funcionan, prueba estas opciones.

7.1. Forzar la conexión desde la línea de comandos (SSH)

Si tu hosting permite acceso SSH, puedes probar la conexión manualmente:

mysql -u usuario -p -h localhost nombre_base

Te pedirá la contraseña. Si accedes, el problema está en PrestaShop. Si no, el problema está en la configuración del servidor.

7.2. Verificar el archivo `.my.cnf`

A veces hay un archivo de configuración global de MySQL que puede estar corrupto. En Plesk, puedes revisarlo desde "Herramientas y Ajustes" > "Configuración de MySQL". No modifiques nada si no estás seguro.

7.3. Comprobar los límites de conexión

Si tienes muchas visitas, puede que el servidor haya alcanzado el límite de conexiones simultáneas. Plesk muestra el número de conexiones activas en la sección de bases de datos. Si ves un número alto, contacta con tu hosting para aumentar el límite.

7.4. Restaurar una copia de seguridad

Si todo falla, restaura una copia de seguridad de tu tienda de antes de que apareciera el error. En Plesk, ve a "Copias de seguridad" y selecciona una fecha anterior. Esto sobrescribirá los archivos y la base de datos.

[WARNING] Restaurar una copia de seguridad borrará cualquier cambio realizado después de esa fecha. Asegúrate de tener una copia de seguridad reciente de tus pedidos y productos.

Preguntas Frecuentes (FAQ)

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

Porque PrestaShop sigue usando la contraseña antigua en el archivo parameters.php. Debes actualizarla manualmente.

¿Puedo solucionar el error sin acceder a Plesk?

No, necesitas al menos acceso a Plesk o al administrador de archivos para modificar parameters.php. Si no tienes acceso, contacta con tu hosting.

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

Sí, algunos módulos mal codificados pueden sobrescribir la configuración de la base de datos. Desactiva todos los módulos no esenciales desde el backoffice (si puedes acceder) o renombra la carpeta modules desde el administrador de archivos.

¿Qué hago si el error aparece solo en el móvil?

Puede ser un problema de caché. Limpia la caché de PrestaShop desde el backoffice (si puedes acceder) o desde Plesk eliminando la carpeta var/cache.

¿Cuánto tiempo tarda en solucionarse?

Si el problema es simple (contraseña incorrecta), en 5 minutos lo tienes. Si es un problema del servidor, puede tardar horas hasta que tu hosting lo resuelva.

Conclusión

El error de conexión base de datos PrestaShop es frustrante, pero casi siempre tiene solución. Siguiendo estos pasos, podrás diagnosticar si el problema está en la configuración de PrestaShop, en los datos de acceso, en el servidor MySQL o en los permisos. Recuerda:

Revisa siempre el archivo parameters.php.
Verifica que la base de datos y el usuario existan en Plesk.
Comprueba que MySQL esté funcionando.
Lee los logs para obtener pistas.

Si después de todo esto el error persiste, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo al servidor y pueden detectar problemas que tú no ves desde el panel.

¡Esperamos que tu tienda vuelva a funcionar en pocos minutos!