Error de base de datos en PrestaShop DirectAdmin | Solución

¡Hola! Soy tu asistente técnico. Si estás leyendo esto, seguramente te has topado con el temido mensaje de error base datos PrestaShop DirectAdmin mientras intentabas acceder a tu tienda online. No te preocupes, es un problema más común de lo que parece y, por suerte, tiene solución. En esta guía extensa y detallada, vamos a desglosar paso a paso cómo identificar y solucionar error base datos PrestaShop en un entorno con DirectAdmin.

Este artículo está pensado para que, incluso si no eres un experto en servidores, puedas seguir las instrucciones sin complicaciones. Vamos a empezar desde lo más básico hasta las soluciones más avanzadas.

¿Por qué aparece el error de conexión a la base de datos?

El mensaje típico que ves en tu tienda PrestaShop suele ser algo como: “Error de conexión a la base de datos” o “Cannot connect to database”. Esto significa que tu tienda no puede comunicarse con el motor de base de datos (normalmente MySQL o MariaDB) donde está almacenada toda la información de tu tienda: productos, clientes, pedidos, etc.

Las causas más frecuentes son:

Cambio de contraseña de la base de datos sin actualizar la configuración de PrestaShop.
Error en los archivos de configuración (especialmente app/config/parameters.php).
El servicio de base de datos (MySQL/MariaDB) está detenido o caído.
Problemas de permisos o credenciales incorrectas en DirectAdmin.
Saturación del servidor o límites de conexiones alcanzados.

No te asustes, vamos a revisar cada una de estas causas con soluciones prácticas.

Paso 1: Verifica el estado del servicio de base de datos en DirectAdmin

Antes de tocar nada en PrestaShop, asegurémonos de que el motor de base de datos esté funcionando correctamente en tu servidor.

Accede al panel de control de DirectAdmin

Ingresa a tu panel de DirectAdmin (normalmente en https://tudominio.com:2222).
Ve a la sección "Administración de servicios" o "Servicios del sistema". Dependiendo de la versión, puede estar dentro de "Nivel de administrador" (si eres el administrador del servidor) o en "Cuenta de usuario".
Busca los servicios mysqld o mariadb. Deberían aparecer con un estado "Running" (en ejecución).

[TIP] Si el servicio aparece como "Stopped", simplemente haz clic en el botón "Start" o "Reiniciar". A veces un reinicio simple resuelve el problema.

Si no ves la opción de servicios

Si tu plan de hosting no te permite gestionar servicios, contacta con tu proveedor de hosting y pídeles que verifiquen que MySQL/MariaDB esté activo.

Paso 2: Revisa las credenciales de la base de datos en PrestaShop

El archivo más importante para la conexión es app/config/parameters.php. Aquí es donde PrestaShop guarda el nombre de la base de datos, el usuario, la contraseña y el servidor.

Localiza y edita el archivo `parameters.php`

Accede a tu hosting por FTP (FileZilla, por ejemplo) o mediante el administrador de archivos de DirectAdmin.
Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente public_html o tu-dominio.com).
Abre la carpeta app, luego config y busca el archivo parameters.php.
Ábrelo con un editor de texto (como Notepad++ o el editor integrado de DirectAdmin).

Dentro verás algo similar a esto:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'tu_usuario_db',
'database_user' => 'tu_usuario_db',
'database_password' => 'tu_contraseña',

Verifica estos datos:

database_host: Normalmente es localhost. Si tu base de datos está en otro servidor, debe ser la IP o el nombre del host remoto.
database_name: El nombre exacto de tu base de datos (tal como aparece en DirectAdmin).
database_user: El usuario de la base de datos.
database_password: La contraseña actual de ese usuario.

[WARNING] Si cambiaste la contraseña de la base de datos desde DirectAdmin recientemente, debes actualizar este archivo manualmente. De lo contrario, PrestaShop intentará conectarse con la contraseña antigua y fallará.

¿Cómo obtener las credenciales correctas desde DirectAdmin?

En DirectAdmin, ve a "Administración de bases de datos MySQL" (o "MySQL Management").
Verás una lista de tus bases de datos. Haz clic en el icono de "Administrar" (una especie de engranaje o lápiz).
Ahí podrás ver el nombre de la base de datos, el usuario asociado y la opción de cambiar la contraseña.

Si necesitas cambiar la contraseña, hazlo desde allí y luego actualiza el archivo parameters.php con la nueva contraseña.

Paso 3: Verifica que el usuario tenga permisos sobre la base de datos

A veces, aunque las credenciales sean correctas, el usuario no tiene todos los permisos necesarios. Esto puede ocurrir después de migraciones o restauraciones.

Asignar permisos en DirectAdmin

En "Administración de bases de datos MySQL", busca la base de datos afectada.
Haz clic en "Asignar usuario" o "Editar permisos".
Asegúrate de que el usuario tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Lo más seguro es marcar "ALL PRIVILEGES" (todos los privilegios).
Guarda los cambios.

[INFO] Si no ves la opción de permisos, puedes usar phpMyAdmin (accesible desde DirectAdmin en "phpMyAdmin") para asignarlos manualmente. Dentro de phpMyAdmin, selecciona la base de datos, ve a la pestaña "Privilegios" y edita el usuario.

Paso 4: Comprueba el archivo `settings.inc.php` (versiones antiguas)

Si tu PrestaShop es anterior a la versión 1.7 (por ejemplo, 1.6), la configuración de la base de datos se encuentra en el archivo config/settings.inc.php. El proceso es similar al del parameters.php, pero la estructura es diferente.

Busca líneas como:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_db');
define('_DB_USER_', 'usuario_db');
define('_DB_PASSWD_', 'contraseña');

Actualiza los valores si es necesario.

Paso 5: Soluciona problemas de conexión remota o de puertos

En algunos entornos, especialmente si usas un servidor dedicado o VPS, la base de datos puede no estar en localhost. Por ejemplo, si tienes la base de datos en un servidor separado.

Cambia el host en `parameters.php`

Si tu base de datos está en otro servidor, el valor de database_host debe ser la IP o el nombre de dominio de ese servidor. Además, puede que necesites especificar el puerto (por defecto MySQL usa el 3306).

Ejemplo:

'database_host' => '192.168.1.100',
'database_port' => '3306',

[WARNING] Asegúrate de que el firewall del servidor de base de datos permita conexiones desde la IP de tu servidor web. Si no, aunque los datos sean correctos, la conexión será rechazada.

Si usas Syspanel (antes HestiaCP)

Si tu servidor utiliza Syspanel (el antiguo HestiaCP), el acceso a la base de datos se gestiona de forma similar. Recuerda que el puerto de acceso a Syspanel es el 2106. Para verificar la base de datos desde Syspanel:

Accede a https://tudominio.com:2106.
Ve a "Base de datos" y revisa que el usuario y la base de datos existan.
Asegúrate de que el servicio MySQL esté corriendo (en "Servicios").

Paso 6: Revisa los logs de errores

Si después de todo lo anterior el error persiste, es hora de revisar los registros de errores para obtener más pistas.

Logs de PrestaShop

En la carpeta var/logs/ de tu instalación de PrestaShop (o log/ en versiones antiguas) encontrarás archivos como prod.log o dev.log. Ábrelos y busca errores relacionados con la base de datos.

Logs de MySQL/MariaDB

Si tienes acceso al servidor, puedes revisar los logs de MySQL. En DirectAdmin, a veces están en /var/log/mysql/error.log. Si no, pide a tu proveedor que te los facilite.

Un error común en los logs es: "Access denied for user 'usuario'@'localhost'" (acceso denegado). Esto indica que la contraseña o el usuario son incorrectos.

Paso 7: Soluciones rápidas adicionales

A veces, el problema se resuelve con acciones simples. Prueba estas antes de desesperarte:

Limpia la caché de PrestaShop

Accede a tu servidor por FTP.
Elimina el contenido de la carpeta var/cache/ (o cache/ en versiones antiguas). No borres la carpeta en sí, solo los archivos de su interior.
Vuelve a cargar tu tienda.

Restablece la conexión desde la base de datos

En DirectAdmin, ve a "phpMyAdmin", selecciona tu base de datos y ejecuta la siguiente consulta SQL (esto fuerza a PrestaShop a reconectar):

FLUSH TABLES;

No hace milagros, pero a veces ayuda si había bloqueos.

Verifica el límite de conexiones

Si tu tienda tiene mucho tráfico, puede que el servidor alcance el límite de conexiones simultáneas a MySQL. En DirectAdmin (como administrador), puedes aumentar el límite en "Configuración de MySQL" (opción max_connections). Si no tienes acceso, contacta a tu hosting.

Paso 8: Restaura desde una copia de seguridad

Si nada funciona y tienes una copia de seguridad reciente de tu tienda (archivos y base de datos), restaurarla puede ser la solución más rápida.

Restaurar base de datos en DirectAdmin

Ve a "Administración de bases de datos MySQL".
Haz clic en "Importar" o "Subir archivo SQL".
Selecciona tu archivo de respaldo .sql y ejecuta la importación.
Luego, asegúrate de que el archivo parameters.php o settings.inc.php tenga las credenciales correctas para esta base de datos restaurada.

Preguntas frecuentes (FAQ)

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos común. Si el error aparece después de instalar un módulo o tema, desactívalo temporalmente renombrando la carpeta del módulo en /modules/ (por FTP) y comprueba si el error desaparece.

¿Qué hago si no tengo acceso a DirectAdmin?

Si tu plan de hosting no incluye DirectAdmin, contacta con el soporte de tu proveedor. Ellos pueden verificar la base de datos por ti. Proporciona el mensaje de error exacto.

¿Puedo solucionar esto desde el propio PrestaShop?

No, porque el error impide que PrestaShop se cargue. Debes acceder por FTP o al panel de control del hosting.

¿El error afecta a los pedidos ya realizados?

No, los pedidos ya están almacenados en la base de datos. Una vez solucionado el error, todo volverá a la normalidad y los datos seguirán ahí.

Resumen final

El error base datos PrestaShop DirectAdmin suele deberse a problemas de credenciales, permisos o servicios caídos. Siguiendo esta guía paso a paso, podrás identificar la causa y aplicar la solución correcta. Recuerda:

Verifica que MySQL/MariaDB esté corriendo.
Revisa y actualiza el archivo parameters.php o settings.inc.php.
Asegúrate de que el usuario tenga todos los permisos.
Si usas Syspanel, accede por el puerto 2106 para gestionar la base de datos.
No olvides limpiar la caché después de hacer cambios.

Espero que este artículo te haya sido de gran ayuda. Si el problema persiste, no dudes en contactar con el soporte técnico de tu hosting, ellos tienen herramientas avanzadas para diagnosticar el servidor. ¡Mucho éxito con tu tienda PrestaShop!