Solución al error de conexión a la base de datos en PrestaShop (DirectAdmin)

¿Tu tienda PrestaShop muestra el temido mensaje de "Error de conexión a la base de datos" y no sabes qué hacer? No te preocupes, es uno de los fallos más comunes, pero también de los que tienen solución más rápida si sabes dónde mirar.

Este error suele aparecer de repente, incluso sin haber tocado nada. Las causas pueden variar desde un cambio de contraseña hasta un problema con el servidor MySQL en tu panel de control.

En esta guía, pensada para usuarios sin experiencia técnica, vamos a desglosar paso a paso cómo solucionar el error base de datos prestashop cuando tu hosting utiliza DirectAdmin.

Vamos a ello.

¿Por qué aparece el error "PrestaShop no conecta BD"?

Antes de lanzarnos a arreglar nada, es fundamental entender por qué ocurre. Cuando PrestaShop intenta cargar, necesita "hablar" con la base de datos (MySQL) para traer productos, clientes y configuraciones.

Si esa comunicación falla, la tienda se bloquea y muestra el mensaje genérico. Las razones más habituales son:

• Credenciales incorrectas: El archivo de configuración tiene un usuario, contraseña o nombre de base de datos desactualizado.
• Servidor MySQL caído: El servicio de bases de datos se ha detenido en el servidor.
• Cuota de disco superada: Si tu cuenta de hosting está llena, MySQL no puede escribir datos temporales.
• Archivo de configuración corrupto: El famoso parameters.php ha perdido datos o ha sido modificado por error.

Vamos a diagnosticar y solucionar cada punto.

Primeros pasos: Diagnóstico rápido en DirectAdmin

Lo primero es comprobar si el problema es global o solo de tu tienda.

1. Revisa si otros sitios web funcionan

Si tienes otros dominios en el mismo panel de DirectAdmin, intenta cargarlos.

• Si fallan todos: El problema es del servidor MySQL. Contacta con tu proveedor de hosting, pero antes, mira el siguiente punto.
• Si solo falla PrestaShop: El problema está en la configuración de tu tienda o en la base de datos específica.

2. Verifica el estado del servicio MySQL en DirectAdmin

DirectAdmin tiene un gestor de procesos muy visual.

• Accede a tu panel de DirectAdmin.
• Busca la sección "Servicios del sistema" o "Estado del sistema" (a veces está en el menú lateral o en "Administración del sistema").
• Busca "MySQL" o "MariaDB" en la lista.

[WARNING]
Si el estado aparece como "Detenido" o "Abajo", intenta pulsar el botón de "Reiniciar" o "Iniciar". Si no tienes permiso para hacerlo, llama a tu hosting inmediatamente y diles que el servicio MySQL está caído en tu cuenta.

3. Comprueba el espacio en disco

Un disco duro lleno es un asesino silencioso de bases de datos.

• En DirectAdmin, busca la sección "Estadísticas de cuenta" o "Uso de disco".
• Mira el porcentaje de uso de tu cuenta.

[INFO]
Si superas el 95% de uso, MySQL puede entrar en "modo solo lectura" o fallar directamente. Libera espacio o contacta con tu proveedor.

Solución paso a paso: El archivo parameters.php

Si los servicios están bien y tienes espacio, el siguiente paso es revisar el archivo que guarda las llaves de acceso a la base de datos. Es la causa más común del directadmin prestashop error.

Este archivo se llama parameters.php y se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Acceso por FTP o Administrador de Archivos

1. Entra en DirectAdmin y abre el "Administrador de Archivos".
2. Navega a la carpeta de tu tienda: public_html o public_html/nombre_de_tu_tienda.
3. Entra en la carpeta app y luego en config.
4. Busca el archivo parameters.php.

Edición segura del archivo

Haz clic derecho sobre el archivo y selecciona "Editar".

Dentro verás un código similar a este:

'database_host' => 'localhost',
'database_name' => 'tu_usuario_bd',
'database_user' => 'tu_usuario_bd',
'database_password' => 'tu_contraseña_secreta',
'database_prefix' => 'ps_',

Aquí está la clave. Estos datos deben coincidir EXACTAMENTE con los que creaste en la sección "MySQL Management" de DirectAdmin.

• database_host: Normalmente es localhost, pero a veces tu hosting usa un host remoto como mysql.tudominio.com. Revisa el correo de bienvenida de tu hosting.
• database_name: Es el nombre de tu base de datos.
• database_user: Es el usuario asignado.
• database_password: La contraseña correspondiente.

[TIP]
Si no recuerdas tu contraseña, ve a "MySQL Management" en DirectAdmin, y junto a tu usuario, pulsa "Cambiar contraseña". Luego, copia esa nueva contraseña en el archivo parameters.php.

Guarda el archivo y recarga tu tienda.

Solucionar error de conexión a base de datos PrestaShop con herramientas de mantenimiento

Si el problema persiste, vamos a forzar a PrestaShop a usar una configuración limpia. Esto se hace a través del instalador, que puede "reparar" la conexión.

Paso 1: Renombra la carpeta config

• Ve al Administrador de Archivos.
• Dentro de app/config/, busca el archivo parameters.php.
• NO lo borres, pero renómbralo a parameters.php.bak. Esto hará que PrestaShop crea que no está instalado.

[WARNING]
Este paso es seguro, pero no borres el archivo original. Si algo sale mal, puedes revertir el cambio.

Paso 2: Ejecuta el instalador

• Abre tu navegador y ve a tudominio.com/install.
• PrestaShop detectará que no hay configuración y te preguntará si quieres "Instalar" o "Reparar".
• Elige la opción "Reparar" (si está disponible) o simplemente continúa con la instalación.
• Cuando llegue al paso de la base de datos, introduce los datos correctos que verificaste antes.

[INFO]
Al hacer esto, PrestaShop regenerará el archivo parameters.php con los datos correctos. No te preocupes, no borrarás tus productos ni clientes, solo se reescribe el archivo de conexión.

Paso 3: Elimina la carpeta install

Una vez completado, borra la carpeta install de tu servidor por seguridad, ya que es un riesgo de seguridad tenerla accesible.

Errores comunes y soluciones específicas

Aquí tienes un mini-FAQ para problemas concretos que suelen aparecer.

"PrestaShop no conecta BD" pero los datos son correctos

Esto es frustrante. Si los datos en parameters.php son correctos y MySQL está activo, el problema puede ser de privilegios.

• Ve a "MySQL Management" en DirectAdmin.
• Asegúrate de que el usuario que usas está asignado a la base de datos correcta.
• Si no, asígnalo y otorga "TODOS LOS PRIVILEGIOS".

Error de "Host 'localhost' no permitido"

A veces, el servidor MySQL está configurado para aceptar solo conexiones desde un host específico.

• Prueba a cambiar el database_host en parameters.php de localhost a 127.0.0.1.
• Guarda y prueba de nuevo.

El error ocurre solo en el panel de administración

Si el front-office (la tienda) funciona pero el back-office (admin) falla, suele ser un problema de caché o de permisos de archivos.

• Ve a app/cache/ y borra el contenido de las carpetas dev y prod (no borres las carpetas, solo lo de dentro).
• También puedes renombrar la carpeta cache a cache_old y crear una nueva vacía llamada cache. Esto forzará la regeneración.

Consejos finales para evitar el error en el futuro

La prevención es la mejor cura. Sigue estos hábitos para no volver a ver el error base de datos prestashop.

1. Copia de seguridad periódica: DirectAdmin permite crear copias de seguridad completas. Hazlo al menos una vez a la semana.
2. No uses el mismo usuario para todo: Crea un usuario de base de datos específico para PrestaShop.
3. Mantén PrestaShop actualizado: Las versiones antiguas tienen fallos de conexión conocidos.
4. Revisa tus cuotas: Vigila el espacio en disco mensualmente.

[TIP]
Si tu hosting es de los que usan Syspanel (antes conocido como HestiaCP), el proceso es ligeramente diferente. Para acceder a la gestión de bases de datos en Syspanel, deberás entrar por el puerto 2106 (ejemplo: tudominio.com:2106) y buscar la sección "Base de Datos". La lógica de editar el archivo parameters.php es exactamente la misma, pero la interfaz cambia.

Conclusión: No entres en pánico, es cuestión de lógica

Hemos visto que el directadmin prestashop error se soluciona revisando tres puntos clave: el estado del servidor, el espacio en disco y, sobre todo, el archivo parameters.php.

Con esta guía, ya tienes el conocimiento para solucionar conexión mysql prestashop tu mismo, sin esperar horas al soporte técnico.

Recuerda siempre trabajar con copias de seguridad y ser meticuloso al editar archivos de configuración. Si has seguido todos los pasos y el error persiste, el problema puede estar en el firewall del servidor o en un bloqueo de IP, pero eso ya es menos común y requeriría la intervención de tu proveedor de hosting.

Espero que tu tienda vuelva a estar operativa. ¡Mucha suerte!