Error conexión base datos PrestaShop DirectAdmin: solución

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque probablemente te has encontrado con el temido error base datos PrestaShop DirectAdmin, y tu tienda online se ha quedado en blanco o muestra un mensaje de error. No te preocupes, es uno de los problemas más comunes, y en esta guía te voy a explicar paso a paso cómo solucionar la PrestaShop conexión base datos cuando tu servidor usa DirectAdmin PrestaShop solución. Vamos a resolverlo juntos.

¿Qué significa este error y por qué ocurre?

Cuando tu tienda PrestaShop no puede conectarse a su base de datos (MySQL o MariaDB), el sistema no puede cargar productos, clientes ni pedidos. El error típico que verás es algo como: "Error de conexión a la base de datos" o "Link to database cannot be established". Las causas más habituales son:

Credenciales incorrectas: El usuario, contraseña o nombre de la base de datos han cambiado.
Servidor MySQL caído o sobrecargado.
Archivo de configuración dañado: El archivo parameters.php o settings.inc.php tiene datos erróneos.
Cambios en el hosting: Por ejemplo, al migrar de servidor o restaurar una copia de seguridad.
Permisos incorrectos: El usuario de la base de datos no tiene acceso a la base de datos correcta.

Vamos a ver cómo diagnosticar y arreglar cada caso.

Paso 1: Verificar el estado del servidor MySQL en DirectAdmin

Lo primero es asegurarte de que el servicio de bases de datos esté funcionando. DirectAdmin tiene herramientas propias.

Accede a tu panel de DirectAdmin (normalmente tudominio.com:2222).
Ve a Administración de servidor -> Servicios del sistema.
Busca mysqld o mariadb en la lista. Debe aparecer como "Running" (en ejecución).

[WARNING] Si ves que el servicio está detenido, intenta reiniciarlo desde el mismo panel. Si no tienes permisos para hacerlo, contacta con tu proveedor de hosting. Un servidor MySQL detenido es la causa más rápida de error.

Paso 2: Localizar y revisar el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en dos archivos clave. Debes revisarlos.

Para PrestaShop 1.7 y versiones superiores

El archivo es app/config/parameters.php. Conéctate por FTP o desde el administrador de archivos de DirectAdmin.

Navega hasta la carpeta raíz de tu tienda (normalmente public_html o domains/tudominio.com/public_html).
Abre la carpeta app y luego config.
Descarga o edita el archivo parameters.php.

Dentro verás algo así:

<?php
return array(
    'parameters' => array(
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'tu_basededatos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        // ... más parámetros
    ),
);

Para PrestaShop 1.6 y versiones anteriores

El archivo es config/settings.inc.php. En la misma raíz, busca la carpeta config.

Dentro tendrás:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_basededatos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASS_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');

¿Qué debes comprobar aquí? Que estos datos coincidan exactamente con los que tienes en tu hosting. Si no los recuerdas, ve al paso siguiente.

Paso 3: Obtener las credenciales correctas desde DirectAdmin

DirectAdmin te permite gestionar tus bases de datos fácilmente.

En DirectAdmin, ve a Gestión de cuentas -> Gestión de bases de datos MySQL.
Verás una lista de todas las bases de datos y usuarios asociados.
Anota exactamente el nombre de la base de datos, el usuario y (si no lo recuerdas) puedes restablecer la contraseña desde el mismo panel (solo para el usuario de esa base de datos).

[TIP] El nombre de la base de datos suele tener un prefijo con tu nombre de usuario de DirectAdmin, por ejemplo: usuario_bd_tienda. El usuario también suele incluir el prefijo.

Paso 4: Corregir el archivo de configuración con los datos correctos

Ahora que tienes las credenciales correctas, edita el archivo parameters.php o settings.inc.php con los valores que anotaste.

Asegúrate de que database_host sea localhost (a menos que tu hosting te indique otro servidor).
Si usas un puerto diferente al estándar (3306), especifícalo en database_port.
Guarda los cambios y sube el archivo si lo editaste localmente.

[INFO] Después de modificar el archivo, es recomendable borrar la caché de PrestaShop. Puedes hacerlo desde el panel de administración (si accedes) o eliminando manualmente la carpeta var/cache (en PrestaShop 1.7) o cache (en 1.6) dentro de la raíz. Esto obliga a PrestaShop a leer la nueva configuración.

Paso 5: Probar la conexión manualmente con una herramienta

Si después de corregir los datos el error persiste, podemos probar la conexión directamente desde el servidor.

En DirectAdmin, ve a Gestión de cuentas -> phpMyAdmin (o MySQL Manager).
Intenta iniciar sesión con el usuario y contraseña que has puesto en el archivo.
- Si no puedes acceder, significa que la contraseña es incorrecta o el usuario no tiene permisos sobre esa base de datos.
- Si accedes, la conexión funciona y el problema está en otra parte (por ejemplo, en el archivo de configuración o en la caché).

[WARNING] Si phpMyAdmin te da error de acceso, restablece la contraseña desde DirectAdmin y actualiza también el archivo de configuración de PrestaShop.

Paso 6: Verificar los permisos del usuario de la base de datos

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos sobre la base de datos.

En DirectAdmin, ve a Gestión de bases de datos MySQL.
Busca la base de datos en cuestión y haz clic en Editar o Permisos.
Asegúrate de que el usuario correcto esté asignado a esa base de datos con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Marca la opción "Todos los privilegios" si está disponible.

Paso 7: Comprobar si hay un firewall o límite de conexiones

Algunos hosting tienen reglas de firewall que bloquean conexiones externas a MySQL. Si tu database_host no es localhost, sino una IP remota, puede que el puerto 3306 esté bloqueado.

Si tu hosting te proporciona un servidor de bases de datos separado, asegúrate de que tu IP actual esté en la lista blanca.
En DirectAdmin, no suele haber este problema si usas localhost.

Paso 8: Revisar el archivo .htaccess (casos raros)

En situaciones muy específicas, un .htaccess mal configurado puede redirigir o bloquear las peticiones internas. No es lo más común, pero si nada funciona, revisa el archivo .htaccess en la raíz de tu tienda.

Haz una copia de seguridad y luego renómbralo a .htaccess.bak para desactivarlo temporalmente.
Si el error desaparece, entonces el problema está en ese archivo. Puedes regenerarlo desde el panel de administración de PrestaShop (Preferencias -> SEO y URL -> Guardar sin cambios).

Solución avanzada: Restaurar una copia de seguridad de la base de datos

Si el error apareció después de una actualización o una modificación manual, puede que la base de datos esté corrupta o con tablas dañadas.

Desde phpMyAdmin, selecciona tu base de datos.
Ve a la pestaña Operaciones y busca "Reparar tabla" (o ejecuta REPAIR TABLE para todas las tablas).
Si eso no funciona, restaura una copia de seguridad reciente desde DirectAdmin (sección Gestión de copias de seguridad).

[TIP] Siempre mantén copias de seguridad automáticas. En DirectAdmin puedes configurarlas en Nivel de cuenta -> Copia de seguridad.

Preguntas frecuentes (FAQ) sobre error base datos PrestaShop DirectAdmin

¿Por qué veo el error después de migrar mi tienda a otro servidor?

Lo más probable es que las credenciales en el archivo de configuración sigan apuntando a la base de datos antigua. Sigue los pasos 2, 3 y 4 para actualizarlas.

¿Puedo usar un usuario de base de datos que ya existe en otra base de datos?

Sí, pero debe tener permisos sobre la base de datos de PrestaShop. En DirectAdmin, puedes asignar un mismo usuario a varias bases de datos.

¿Qué hago si no recuerdo la contraseña de la base de datos?

Restablécelo desde DirectAdmin: Gestión de bases de datos MySQL -> haz clic en el usuario -> Cambiar contraseña. Luego actualiza el archivo de configuración.

¿El error puede deberse a un plugin o módulo de PrestaShop?

Sí, algunos módulos mal codificados pueden interferir con la conexión. Si el error aparece solo en páginas específicas, desactiva los módulos recién instalados desde el panel de administración (si puedes acceder) o renombrando la carpeta modules temporalmente.

¿Cómo sé si mi hosting usa MariaDB en lugar de MySQL?

No importa, el proceso es el mismo. MariaDB es un reemplazo directo de MySQL y usa los mismos comandos. DirectAdmin lo gestiona de forma transparente.

¿Qué significa el error "Too many connections"?

Tu servidor tiene un límite de conexiones simultáneas a la base de datos. Puede deberse a muchos visitantes o a un proceso atascado. Contacta con tu hosting para aumentar el límite o revisa si hay consultas lentas.

Consejos finales para evitar futuros problemas

Usa contraseñas seguras para las bases de datos. Evita caracteres especiales que puedan dar problemas en el archivo de configuración.
No edites el archivo de configuración con editores de texto que añadan formato (como Word). Usa bloc de notas o un editor de código.
Actualiza PrestaShop y sus módulos regularmente. Las versiones antiguas tienen vulnerabilidades que pueden causar errores.
Si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106, y la gestión de bases de datos es similar a DirectAdmin.

[INFO] Si después de seguir todos los pasos el error persiste, puede ser un problema del servidor a nivel de red o configuración de PHP. No dudes en contactar con el soporte técnico de tu hosting y proporcionarles los pasos que ya has realizado.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Si algo no queda claro, vuelve a leer el paso correspondiente. ¡Tu tienda volverá a funcionar en poco tiempo!