🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solucionar problemas de conexión a base de datos en PrestaShop (Plesk)

Actualizado el 3 de febrero de 2026

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí, es porque seguramente te has topado con el temido error de conexión base datos PrestaShop y estás usando un panel Plesk. No te preocupes, es uno de los problemas más comunes, pero también de los más fáciles de solucionar si sigues los pasos adecuados.

En esta guía extensa, te voy a explicar paso a paso cómo solucionar error PrestaShop relacionado con la base de datos, especialmente cuando trabajas con Plesk. Cubriremos desde los síntomas más típicos hasta las soluciones más efectivas, incluyendo cómo verificar credenciales, permisos y archivos de configuración.

Vamos a ponernos manos a la obra. Recuerda, si en algún momento te sientes perdido, respira hondo y vuelve al inicio. Todo tiene solución.

[INFO] Esta guía está diseñada para usuarios sin experiencia técnica. Si ves términos complejos, los explicaré de forma sencilla.

¿Por qué ocurre el error de conexión a la base de datos en PrestaShop?

Antes de lanzarnos a las soluciones, es importante entender qué está pasando. El error de conexión base datos PrestaShop suele aparecer cuando tu tienda no puede comunicarse con la base de datos donde guarda toda la información (productos, clientes, pedidos, etc.). Piensa en la base de datos como el cerebro de tu tienda: si no hay conexión, la tienda no funciona.

Los síntomas más comunes son:

  • Pantalla en blanco al cargar la tienda.
  • Mensaje de error como "Error de conexión a la base de datos" o "Link to database cannot be established".
  • Página de instalación de PrestaShop que se muestra de repente (como si la tienda se hubiera reiniciado).
  • Errores 500 (Internal Server Error) en el front-end o back-end.

Las causas principales suelen ser:

  1. Credenciales incorrectas en el archivo de configuración de PrestaShop (settings.inc.php).
  2. La base de datos ha sido eliminada o movida (por error, al migrar o al restaurar una copia de seguridad).
  3. Permisos incorrectos del usuario de la base de datos en Plesk.
  4. El servidor de base de datos (MySQL/MariaDB) está caído o no responde.
  5. Problemas con el archivo .htaccess (menos común, pero posible).

Paso 1: Lo primero, verifica el estado del servidor de base de datos en Plesk

A veces, el problema no está en tu tienda, sino en el propio servidor. Si el servicio de MySQL está detenido, ninguna aplicación podrá conectarse.

Cómo verificar MySQL en Plesk

  1. Accede a tu panel de Plesk (normalmente https://tudominio.com:8443 o la URL que te hayan proporcionado).
  2. En el menú de la izquierda, busca "Herramientas y configuraciones" (o "Tools & Settings").
  3. Dentro, busca la sección "Servicios" o "Administración de servicios". Allí verás una lista de servicios.
  4. Localiza "MySQL" o "MariaDB" (según lo que use tu hosting). Debería aparecer con un icono verde y el estado "En ejecución" (Running).
  5. Si aparece en rojo o con estado "Detenido", haz clic en el botón "Iniciar" o "Reiniciar".

[TIP] Si no ves la opción de servicios, tu hosting puede tenerlo restringido. En ese caso, contacta con tu proveedor de hosting y diles: "Por favor, verifica que el servicio MySQL esté activo en mi cuenta".

Si el servicio está activo pero el error persiste

Prueba a reiniciar el servicio. A veces, un simple reinicio soluciona problemas temporales de conexión. En Plesk, suele haber un botón de "Reiniciar" junto al servicio.

Paso 2: Revisa las credenciales de conexión en el archivo settings.inc.php

Este es el paso más común cuando aparece el error base datos Plesk. PrestaShop guarda los datos de conexión en un archivo llamado settings.inc.php. Si este archivo tiene información incorrecta (por ejemplo, después de migrar o cambiar la contraseña de la base de datos), la conexión fallará.

Ubicación del archivo

El archivo se encuentra en la raíz de tu instalación de PrestaShop, dentro de la carpeta config/. La ruta completa suele ser:
/var/www/vhosts/tudominio.com/httpdocs/config/settings.inc.php

Si usas un plan de hosting compartido con Plesk, la ruta puede variar ligeramente (por ejemplo, dentro de httpdocs o htdocs). Lo mejor es usar el Administrador de archivos de Plesk para localizarlo.

Cómo editar el archivo de forma segura

  1. En Plesk, ve a "Sitios web y dominios" y selecciona tu dominio.
  2. Busca el botón "Administrador de archivos" (File Manager).
  3. Navega hasta la carpeta config/ y haz clic derecho sobre settings.inc.php. Selecciona "Editar en el editor de texto".
  4. Verás un contenido similar a este (no te asustes, solo nos interesan unas líneas):
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario_bd');
define('_DB_PASSWD_', 'tu_contraseña_bd');
define('_DB_PREFIX_', 'ps_');

  1. Verifica cada línea:

    • _DB_SERVER_: Normalmente es localhost, pero si tu base de datos está en un servidor remoto, debe ser la IP o el nombre del servidor. En Plesk, lo más común es localhost.
    • _DB_NAME_: Debe coincidir exactamente con el nombre de la base de datos que ves en Plesk (en "Bases de datos").
    • _DB_USER_: El nombre de usuario asignado a esa base de datos.
    • _DB_PASSWD_: La contraseña de ese usuario. Ojo: las contraseñas en Plesk a veces se generan automáticamente y pueden contener caracteres especiales. Asegúrate de copiarla exactamente.
    • _DB_PREFIX_: Es el prefijo de las tablas (por ejemplo, ps_). No suele causar problemas, pero si lo cambiaste, debe coincidir.

  2. Si encuentras algún error, corrígelo y guarda los cambios (Ctrl+S o botón "Guardar").

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una comilla mal puesta) puede romper tu tienda. Si no estás seguro, haz una copia de seguridad del archivo antes de editarlo. Puedes descargarlo a tu PC o renombrarlo a settings.inc.php.bak.

¿Cómo obtener las credenciales correctas desde Plesk?

  1. En Plesk, ve a "Bases de datos" (dentro de tu dominio).
  2. Verás una lista de bases de datos. Busca la que usa tu PrestaShop (normalmente tiene un nombre como tuusuario_tienda).
  3. Haz clic en el nombre de la base de datos. Allí verás:
    • Nombre de la base de datos (cópialo).
    • Usuario de la base de datos (cópialo).
    • Contraseña: Si no la recuerdas, puedes hacer clic en "Cambiar contraseña" y establecer una nueva. Importante: Si cambias la contraseña, también debes actualizarla en el archivo settings.inc.php.

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

A veces, el usuario de la base de datos tiene permisos insuficientes. En Plesk, es fácil asignar todos los privilegios necesarios.

Cómo asignar todos los privilegios

  1. En "Bases de datos", haz clic en el nombre de la base de datos.
  2. Busca la sección "Usuarios de bases de datos" o "Usuarios".
  3. Allí verás el usuario asociado. Haz clic en el icono de "Editar" (normalmente un lápiz).
  4. Marca la casilla "Todos los privilegios" (o selecciona manualmente opciones como SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.).
  5. Guarda los cambios.

[INFO] Para PrestaShop, el usuario necesita al menos permisos de lectura, escritura y modificación de tablas. Si tienes dudas, simplemente selecciona "Todos los privilegios".

Paso 4: Comprueba que la base de datos existe y no está corrupta

A veces, por error, se elimina la base de datos o se daña. En Plesk puedes verificarlo fácilmente.

Verificar existencia

  1. Ve a "Bases de datos" y asegúrate de que la base de datos que usa tu PrestaShop aparece en la lista.
  2. Si no aparece, tendrás que crearla de nuevo y luego restaurar una copia de seguridad (si tienes). Si no tienes copia, lo siento, pero la tienda se habrá perdido.

Comprobar si hay corrupción (opcional)

Si la base de datos existe pero el error persiste, puede estar corrupta. Puedes intentar repararla desde phpMyAdmin (que suele estar integrado en Plesk).

  1. En "Bases de datos", haz clic en el nombre de la base de datos y luego en "phpMyAdmin".
  2. En phpMyAdmin, selecciona todas las tablas (marcando la casilla superior).
  3. En el menú desplegable "Con seleccionados", elige "Reparar tabla" (Repair table).
  4. Espera a que termine. Si hay errores, te los mostrará.

Paso 5: Soluciona problemas de caché y archivos temporales

A veces, PrestaShop guarda en caché información de conexión obsoleta. Limpiar la caché puede ayudar.

Cómo limpiar la caché de PrestaShop (si puedes acceder al back-end)

  1. Ve a "Parámetros de la tienda" > "Rendimiento".
  2. En la sección "Caché", selecciona "No" y guarda.
  3. Luego, vuelve a activarla si quieres (o déjala desactivada para pruebas).

Si no puedes acceder al back-end (método manual)

  1. Conéctate por FTP o usa el Administrador de archivos de Plesk.
  2. Elimina el contenido de la carpeta var/cache/ (en PrestaShop 1.7) o cache/ (en versiones anteriores). No elimines la carpeta en sí, solo su contenido.
  3. También puedes eliminar el archivo config/xml/ (a veces se regenera solo).

[WARNING] Si eliminas la carpeta cache por completo, PrestaShop la recreará automáticamente al cargar la página. No te preocupes.

Paso 6: Revisa el archivo .htaccess (si el error persiste)

Aunque menos común, un .htaccess corrupto puede causar errores de conexión (por redirecciones mal configuradas).

Cómo regenerar el .htaccess

  1. Conéctate por FTP o Administrador de archivos.
  2. Busca el archivo .htaccess en la raíz de tu tienda (carpeta httpdocs o similar).
  3. Renómbralo a .htaccess.old (esto lo desactiva).
  4. Intenta cargar tu tienda. Si funciona, el problema era el .htaccess.
  5. Para regenerarlo, ve al back-end de PrestaShop (si puedes acceder) a "Configuración" > "SEO y URLs" y haz clic en "Guardar" (esto regenera el archivo).
  6. Si no puedes acceder al back-end, puedes crear un .htaccess básico desde cero (consulta la documentación de PrestaShop).

Paso 7: ¿Usas Syspanel (HestiaCP)? Aquí tienes lo que necesitas

Si en lugar de Plesk estás usando Syspanel (que es el nombre que le damos a HestiaCP), el proceso es similar pero con algunas diferencias clave.

[INFO] Syspanel (HestiaCP) se accede normalmente a través del puerto 2106 (ejemplo: https://tudominio.com:2106).

Diferencias clave con Plesk

  • Archivo settings.inc.php: La ubicación es la misma (dentro de config/), pero la ruta del dominio puede ser /home/nombreusuario/web/tudominio/public_html/config/.
  • Gestión de bases de datos: En Syspanel, ve a "Bases de datos" en el menú principal. Allí podrás ver, crear y administrar usuarios y contraseñas.
  • Permisos: En Syspanel, al crear un usuario de base de datos, se le asignan automáticamente todos los privilegios. Si no, puedes editarlos desde "Editar base de datos".
  • phpMyAdmin: En Syspanel, suele estar en la URL https://tudominio.com:2106/phpmyadmin o desde el enlace en la sección de bases de datos.

El resto de pasos (verificar credenciales, permisos, etc.) son exactamente los mismos.

Preguntas frecuentes (FAQ) para solucionar error PrestaShop

Aquí tienes las dudas más comunes que resuelvo a diario:

1. "He cambiado la contraseña de la base de datos en Plesk y ahora la tienda no funciona"

Solución: Actualiza la contraseña en el archivo settings.inc.php (Paso 2). Guarda y recarga la tienda.

2. "Veo el error 'Link to database cannot be established' incluso después de verificar todo"

Solución: Prueba a reiniciar el servicio MySQL desde Plesk (Paso 1). Si no funciona, verifica que el usuario de la base de datos tenga todos los privilegios (Paso 3). A veces, el hosting tiene un cortafuegos que bloquea la conexión local; contacta con soporte.

3. "Mi tienda muestra una página de instalación, como si nunca se hubiera instalado"

Solución: Esto suele ocurrir cuando el archivo settings.inc.php está vacío o corrupto. Revisa que exista y tenga las líneas correctas. Si lo borraste por error, puedes restaurarlo desde una copia de seguridad.

4. "Uso Syspanel (HestiaCP) y no encuentro la base de datos"

Solución: En Syspanel, ve a "Bases de datos" en el menú principal. Si no ves ninguna, puede que no se haya creado. Crea una nueva y luego actualiza el archivo settings.inc.php con los nuevos datos.

5. "El error aparece después de migrar mi tienda a un nuevo servidor"

Solución: Es muy común. Asegúrate de que:

  • Los nombres de la base de datos y usuario sean correctos (en el nuevo servidor pueden ser diferentes).
  • La contraseña se haya copiado exactamente.
  • El servidor de base de datos no sea remoto (a veces en migraciones se cambia de localhost a una IP).

6. "¿Puedo usar un plugin o herramienta para solucionarlo?"

Solución: Existen herramientas como "PrestaShop Database Repair Tool", pero no las recomiendo para usuarios sin experiencia. Es mejor seguir los pasos manuales. Si no te sientes seguro, contrata a un técnico.

Resumen final: checklist rápido para solucionar el error

Si no quieres leer todo el artículo, aquí tienes una lista de verificación rápida:

  1. [ ] ¿El servicio MySQL está activo en Plesk? (Paso 1)
  2. [ ] ¿Las credenciales en settings.inc.php son correctas? (Paso 2)
  3. [ ] ¿El usuario de la base de datos tiene todos los privilegios? (Paso 3)
  4. [ ] ¿La base de datos existe y no está corrupta? (Paso 4)
  5. [ ] ¿Has limpiado la caché de PrestaShop? (Paso 5)
  6. [ ] ¿Has probado a renombrar el .htaccess

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel