Solucionar 'No se puede conectar a la base de datos' en PrestaShop (DirectAdmin)

¡Vaya! Esa pantalla de error es de las que más sustos dan. Ves el mensaje "No se puede conectar a la base de datos" en tu PrestaShop y piensas que has perdido tu tienda. Pero tranquilo, respira hondo.

En el 90% de los casos, este error tiene una solución sencilla que puedes aplicar tú mismo en pocos minutos, incluso sin ser un experto en informática. Como tu panel de control es DirectAdmin, voy a guiarte paso a paso para que diagnostiques y resuelvas este problema de raíz, explicándolo todo de forma clara y sin tecnicismos innecesarios.

Vamos a ello.

Primeros Pasos: Entender el Error de Conexión a la Base de Datos

Antes de tocar nada, es importante entender qué significa exactamente este mensaje. No te asustes, es más simple de lo que parece.

Cuando tu tienda PrestaShop intenta cargar, necesita "hablar" con su base de datos, que es donde guarda todos tus productos, clientes y pedidos. El error "No se puede conectar a la base de datos" aparece cuando esa comunicación falla. Es como si intentaras hacer una llamada telefónica y no hubiera tono.

Las causas más comunes de este fallo son:

Credenciales incorrectas: El "usuario" y la "contraseña" que usa PrestaShop para entrar a la base de datos ya no son válidos.
Servidor de base de datos caído: El servicio que gestiona las bases de datos (normalmente MySQL o MariaDB) se ha detenido en tu servidor.
Base de datos eliminada o corrupta: La base de datos en sí ha sido borrada por error o está dañada.
Espacio en disco agotado: Si el disco duro del servidor está lleno, la base de datos no puede funcionar correctamente.

Vamos a comprobar cada una de estas causas, de la más simple a la más compleja.

Solución Rápida: Comprobar el Estado del Servidor MySQL

Empecemos por lo más fácil. A veces, el servicio de base de datos simplemente se ha detenido o está reiniciándose. Es como si el "centralita telefónica" se hubiera apagado.

Para comprobarlo en DirectAdmin, sigue estos pasos:

Accede a tu panel de DirectAdmin (normalmente en tudominio.com:2222).
Busca la sección "Administración de Servicios" o "System Info". La ubicación exacta puede variar ligeramente según la versión de DirectAdmin, pero suele estar en la parte inferior o en el menú principal.
Busca en la lista los servicios MySQL y MariaDB.
Comprueba que su estado sea "Running" o "Up". Si pone "Stopped" o "Down", es el problema.

[TIP]
Si ves que MySQL o MariaDB está detenido, intenta iniciarlo desde el mismo panel. Busca un botón de "Start" o "Iniciar" junto al servicio. Si se inicia correctamente, tu tienda debería volver a funcionar en unos segundos.

La Causa Más Frecuente: Revisar las Credenciales de la Base de Datos

Si el servicio está activo, el siguiente paso es verificar que las credenciales que usa PrestaShop son correctas. Esto es lo que más falla, normalmente después de un cambio de contraseña o una migración.

PrestaShop guarda esta información en un archivo llamado parameters.php, que se encuentra en la carpeta app/config/ de tu instalación.

Paso 1: Localizar y Abrir el Archivo de Configuración

Para acceder a este archivo, necesitas un administrador de archivos. DirectAdmin incluye uno muy bueno.

En tu panel de DirectAdmin, busca la sección "Administrador de Archivos" (File Manager).
Navega hasta la carpeta donde está instalada tu tienda. Normalmente es domains/tudominio.com/public_html.
Dentro de public_html, entra en la carpeta app.
Después, entra en la carpeta config.
Busca el archivo llamado parameters.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit".

[WARNING]
Ten mucho cuidado al editar este archivo. Un solo carácter mal puesto puede causar más errores. Si no te sientes seguro, haz una copia de seguridad del archivo antes de editarlo (puedes usar la opción "Copy" del administrador de archivos).

Paso 2: Identificar los Parámetros Clave

Una vez abierto el archivo, verás un montón de código. No te preocupes, solo nos interesan unas líneas concretas. Busca las que empiezan con 'database_host', 'database_name', 'database_user' y 'database_password'.

Se verán más o menos así:

'database_host' => 'localhost',
'database_name' => 'tu_usuario_tienda',
'database_user' => 'tu_usuario_tienda',
'database_password' => 'tu_contraseña_secreta',

Estos son los datos que PrestaShop está usando para conectarse. Ahora, vamos a comprobar que son correctos.

Paso 3: Verificar las Credenciales en DirectAdmin

Ahora, vamos a la sección de bases de datos de tu panel de DirectAdmin.

Busca la sección "Administrador de MySQL" o "Bases de Datos MySQL".
Verás una lista de tus bases de datos y los usuarios asociados a ellas.
Compara el database_name y el database_user del archivo parameters.php con los que ves en DirectAdmin. Deben coincidir exactamente (a menudo tienen un prefijo con tu nombre de usuario, como usuario_bd).

Si el nombre de la base de datos o el usuario no coinciden, ese es el problema. Si coinciden, pero no estás seguro de la contraseña, es hora de cambiarla.

Paso 4: Cambiar la Contraseña (Si es Necesario)

Esta es la solución más efectiva cuando dudas de la contraseña. Vamos a crear una nueva.

En la misma sección "Administrador de MySQL" de DirectAdmin, busca la opción para "Cambiar contraseña" junto al usuario de tu base de datos.
Introduce una contraseña nueva y segura. Guárdala bien, la necesitarás en el siguiente paso.
Ahora, vuelve al archivo parameters.php que tienes abierto en el editor.
Reemplaza el valor de 'database_password' por la nueva contraseña que acabas de crear.
Guarda el archivo (normalmente con el icono de disquete o Ctrl+S).

[INFO]
No es necesario que cambies el nombre de la base de datos ni el usuario, solo la contraseña. Este método es infalible para descartar errores de tipeo.

Solucionar el Error de Base de Datos PrestaShop Verificando el Host

Otro punto que a veces se pasa por alto es el database_host. En la mayoría de los casos, en un hosting compartido con DirectAdmin, este valor debe ser localhost.

Si en tu archivo parameters.php aparece otra cosa (como una IP o un nombre de servidor), puede que esté mal configurado.

Asegúrate de que 'database_host' => 'localhost'.
Si no es así, cámbialo a 'localhost' y guarda el archivo.

Qué Hacer si Nada de lo Anterior Funciona: Espacio en Disco y Más

Si has seguido todos los pasos y el error persiste, el problema puede ser más profundo. Vamos a revisar dos cosas más.

Comprobar el Espacio en Disco

Una base de datos llena o un disco duro saturado puede causar este error. Es como intentar escribir en una libreta que no tiene hojas en blanco.

En DirectAdmin, busca la sección "Uso de Disco" o "Disk Usage".
Comprueba si tu cuenta está cerca del límite de espacio permitido.
Si está al 100% o muy cerca, tendrás que liberar espacio. Elimina copias de seguridad antiguas, archivos temporales o logs que ya no necesites.

Revisar la Base de Datos en sí

Si todo lo demás está bien, puede que la base de datos esté dañada. Para ello, necesitas acceder a phpMyAdmin.

En DirectAdmin, busca el icono de phpMyAdmin.
Selecciona tu base de datos en el menú de la izquierda.
Haz clic en la pestaña "Operaciones" (Operations).
Busca la sección "Mantenimiento" y haz clic en "Reparar tabla" o "Repair Table".

[WARNING]
Si no te sientes cómodo usando phpMyAdmin, este paso puede ser arriesgado. Si no sabes lo que estás haciendo, es mejor que contactes con tu proveedor de hosting para que lo hagan por ti. Es un proceso delicado.

PrestaShop No Conecta Base de Datos DirectAdmin: La Solución Definitiva

Si después de todo esto el error "No se puede conectar a la base de datos" continúa, puede que la base de datos se haya corrompido de forma grave o el servidor tenga un problema mayor.

En este punto, la opción más segura es contactar con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso directo al servidor y podrán diagnosticar el problema en profundidad.

Cuando les escribas, facilítales toda la información que has recopilado:

El mensaje de error exacto que ves.
Los pasos que ya has intentado (cambio de contraseña, comprobación de servicios, etc.).
Cualquier mensaje de error adicional que aparezca en el archivo parameters.php o en los logs.

Preguntas Frecuentes (FAQ) sobre el Error de Conexión a la Base de Datos

Aquí tienes las dudas más comunes que nos suelen llegar, con sus respuestas rápidas.

P: ¿Este error significa que he perdido todos mis productos y clientes?
R: No, en absoluto. El error es de conexión, no de pérdida de datos. Tus datos están en la base de datos, solo que PrestaShop no puede acceder a ellos. Una vez solucionado el problema de conexión, todo volverá a estar en su sitio.

P: ¿Puedo evitar que esto vuelva a pasar?
R: Sí, te recomiendo que anotes tus credenciales de base de datos en un lugar seguro. Además, realiza copias de seguridad periódicas de tu base de datos. DirectAdmin tiene herramientas para programarlas.

P: He cambiado la contraseña de mi base de datos pero ahora el error es peor. ¿Qué hago?
R: Respira. Esto es normal si has cambiado la contraseña en DirectAdmin pero no has actualizado el archivo parameters.php. Vuelve a revisar el Paso 2 y el Paso 3 de la sección anterior para asegurarte de que has guardado la nueva contraseña en el archivo correctamente.

P: ¿Es lo mismo si mi panel es Syspanel en lugar de DirectAdmin?
R: No, no es lo mismo. Este artículo está específicamente enfocado en el panel DirectAdmin. Si tu hosting usa Syspanel (el antiguo HestiaCP), los pasos serán diferentes. En ese caso, el acceso a tu panel suele ser en el puerto 2106 (por ejemplo, tudominio.com:2106). La estructura de menús y las rutas de los archivos cambiarán, así que busca una guía específica para tu panel.

P: ¿Qué significa el prefijo en el nombre de mi base de datos y usuario?
R: Es una medida de seguridad de tu hosting. Añaden tu nombre de usuario como prefijo para que las bases de datos de todos los clientes estén separadas y no puedan acceder a las de otros. Es completamente normal y debes respetarlo al copiar los nombres en el archivo parameters.php.

Espero que esta guía te haya sido de gran ayuda. Como has visto, solucionar el error de base de datos en PrestaShop con DirectAdmin es un proceso de eliminación. Siguiendo estos pasos, en la mayoría de los casos podrás recuperar tu tienda en menos de lo que piensas. ¡Mucha suerte!