Error de conexión a base de datos en PrestaShop en DirectAdmin: solución

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, probablemente te has topado con el temido pantallazo de error conexión base datos PrestaShop en tu servidor DirectAdmin. No te preocupes, es uno de los problemas más comunes y, por suerte, tiene solución. En esta guía paso a paso, te explicaré cómo solucionar base datos PrestaShop cuando falla la conexión, todo explicado para que lo entiendas aunque no seas un experto.

Vamos a desglosarlo en partes muy sencillas. Al final, tu tienda volverá a funcionar sin problemas.

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

Cuando ves un mensaje como “Error de conexión a la base de datos” o “No se puede conectar a la base de datos”, PrestaShop te está diciendo que no puede hablar con el lugar donde guarda todos tus productos, clientes, pedidos y configuraciones. Es como si intentaras abrir la puerta de tu casa pero la llave no girara.

Las causas más frecuentes en PrestaShop DirectAdmin error son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado.
Servidor de base de datos caído: El servicio MySQL/MariaDB no está funcionando.
Archivo de configuración dañado: El archivo settings.inc.php (o parameters.php en versiones modernas) tiene datos erróneos.
Espacio en disco agotado: Si el disco está lleno, la base de datos no puede escribir.
Permisos de archivos incorrectos: El sistema no puede leer el archivo de configuración.
Cambio de servidor o migración: Al mover tu tienda, las rutas o credenciales no se actualizaron.

Paso 1: Verifica que el servicio MySQL/MariaDB esté activo en DirectAdmin

Lo primero es asegurarte de que el motor de base de datos esté funcionando. En DirectAdmin, tienes herramientas para comprobarlo fácilmente.

Cómo hacerlo:

Accede a tu panel de DirectAdmin con tu usuario y contraseña.
Busca la sección “Servicios del sistema” o “System Services” (a veces está en el menú de la izquierda o en la parte superior).
Localiza el servicio llamado MySQL o MariaDB.
Verifica que aparezca como “Running” (en ejecución). Si está en “Stopped” (detenido), haz clic en el botón “Start” o “Restart”.

[TIP] Si no ves esta opción, puedes pedirle a tu proveedor de hosting que reinicie MySQL. Es rápido y ellos lo hacen en segundos.

Si el servicio se inicia pero el error persiste, sigue al siguiente paso.

Paso 2: Revisa el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión en un archivo llamado settings.inc.php (para versiones 1.6 y anteriores) o parameters.php (para versiones 1.7 y 8.x). Este archivo se encuentra en la carpeta app/config/ o directamente en config/.

¿Cómo acceder a él?

Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o al Administrador de archivos de DirectAdmin.
Navega hasta la carpeta raíz de tu tienda PrestaShop. Normalmente es public_html o www.
Busca la carpeta config/ o app/config/.
Dentro, encontrarás el archivo settings.inc.php o parameters.php.

¿Qué debes verificar?

Abre el archivo con un editor de texto (como Notepad++ o el editor de DirectAdmin). Busca líneas similares a estas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

(o en versiones modernas, algo como 'database_host' => 'localhost').

Comprueba que:

El servidor sea localhost (a menos que tu hosting te dé un servidor remoto específico).
El nombre de la base de datos sea exactamente el que ves en DirectAdmin.
El usuario y la contraseña coincidan con los que creaste en DirectAdmin.

[WARNING] Si cambiaste la contraseña recientemente en DirectAdmin, debes actualizarla aquí también. Si no, el error seguirá apareciendo.

Paso 3: Verifica las credenciales en DirectAdmin

A veces el error es porque los datos en el archivo no coinciden con los reales. Ve a DirectAdmin y revisa tus bases de datos.

Pasos:

En DirectAdmin, busca la sección “Base de datos MySQL” o “MySQL Management”.
Verás una lista de tus bases de datos. Localiza la que usa tu PrestaShop.
Haz clic en “Ver/Editar” al lado de esa base de datos.
Ahí podrás comprobar el nombre exacto, el usuario y contraseña.
Si la contraseña no la recuerdas, puedes cambiarla desde ahí (anótala bien).
Luego, actualiza el archivo settings.inc.php o parameters.php con esos mismos datos.

[INFO] Si tienes varias bases de datos, asegúrate de usar la correcta. A veces por error se apunta a una que no existe.

Paso 4: Comprueba los permisos de archivos y carpetas

PrestaShop necesita poder leer el archivo de configuración. Si los permisos son incorrectos, el sistema no podrá acceder a él.

¿Qué permisos deben tener?

Los archivos (como settings.inc.php) deben tener permisos 644.
Las carpetas (como config/) deben tener permisos 755.

Cómo cambiarlos en DirectAdmin:

Ve al Administrador de archivos de DirectAdmin.
Navega hasta la carpeta config/ o app/config/.
Selecciona el archivo settings.inc.php (o parameters.php).
Haz clic en “Permisos” o “Change Permissions”.
Marca: Lectura y escritura para el propietario, solo lectura para grupo y otros (644).
Aplica los cambios.

[TIP] Si no estás seguro, pon 644 en todos los archivos PHP y 755 en todas las carpetas. Es un estándar seguro.

Paso 5: Verifica el espacio en disco

Una causa poco conocida pero muy común es que el disco esté lleno. La base de datos necesita espacio para funcionar.

Cómo revisarlo en DirectAdmin:

En el panel principal, busca “Uso de disco” o “Disk Usage”.
Revisa si estás cerca del límite (por ejemplo, 90% o más).
Si está lleno, libera espacio eliminando archivos temporales, logs antiguos, copias de seguridad viejas o imágenes innecesarias.

[WARNING] Si el disco está al 100%, ni siquiera podrás acceder a DirectAdmin a veces. En ese caso, contacta a tu proveedor para que te ayude a liberar espacio.

Paso 6: Revisa el archivo .htaccess (para problemas de redirección)

A veces, un .htaccess mal configurado puede interferir con la conexión a la base de datos, especialmente si estás usando redirecciones o reglas de seguridad.

Solución temporal:

Conéctate por FTP o al Administrador de archivos.
Renombra el archivo .htaccess a .htaccess_backup.
Prueba tu tienda de nuevo. Si funciona, el problema estaba ahí.
Luego, regenera el .htaccess desde el panel de administración de PrestaShop (Preferencias > SEO y URLs > Guardar).

Paso 7: Si nada funciona, restaura desde una copia de seguridad

Si ya verificaste todos los pasos anteriores y el error conexión base datos PrestaShop persiste, es posible que el archivo de configuración esté corrupto o que hayas modificado algo sin querer.

Cómo restaurar:

En DirectAdmin, busca “Copias de seguridad” o “Backups”.
Descarga la copia más reciente de tu sitio (generalmente un archivo .tar.gz o .zip).
Extrae el archivo settings.inc.php o parameters.php de la copia.
Sube ese archivo a tu servidor, sobrescribiendo el actual.
Si no tienes copia, puedes pedirle a tu hosting que te proporcione una.

[INFO] Siempre es buena idea tener copias de seguridad automáticas. Si no las tienes, configura una en DirectAdmin (sección “Cron Jobs” o “Backup Manager”).

Preguntas frecuentes (FAQ)

¿Por qué veo el error después de cambiar la contraseña de la base de datos?

Porque PrestaShop no actualiza automáticamente el archivo de configuración. Debes editar manualmente settings.inc.php o parameters.php con la nueva contraseña.

¿Puedo usar un servidor de base de datos remoto en lugar de localhost?

Sí, pero solo si tu proveedor lo permite. En la mayoría de los casos, debes usar localhost. Si usas un servidor remoto, asegúrate de que el nombre del host sea correcto (por ejemplo, mysql.tudominio.com).

¿Qué hago si el archivo settings.inc.php no existe?

Eso significa que tu PrestaShop no está instalado correctamente. Deberás reinstalarlo o restaurar desde una copia de seguridad. Si es una versión moderna (1.7+), busca parameters.php en app/config/.

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

Rara vez, pero puede ocurrir si un módulo modifica la configuración de la base de datos. Prueba desactivando módulos recién instalados. Puedes hacerlo desde el panel de administración (si accedes) o renombrando la carpeta modules/ temporalmente.

¿Cómo evito este error en el futuro?

Actualiza tu contraseña con cuidado y siempre sincronízala con el archivo de configuración.
Haz copias de seguridad periódicas de tu base de datos y archivos.
Mantén tu PrestaShop actualizado a la última versión estable.
No modifiques archivos de configuración sin saber lo que haces.
Revisa el espacio en disco cada cierto tiempo.

Resumen rápido: Checklist para solucionar el error

✅ Reinicia MySQL/MariaDB en DirectAdmin.
✅ Verifica credenciales en settings.inc.php o parameters.php.
✅ Comprueba nombre, usuario y contraseña en DirectAdmin.
✅ Ajusta permisos a 644 en archivos y 755 en carpetas.
✅ Libera espacio en disco si está lleno.
✅ Renombra .htaccess para descartar conflictos.
✅ Restaura desde backup si todo falla.

[TIP] Si después de todo esto sigues sin solución, contacta a tu proveedor de hosting. Ellos tienen acceso directo a los logs del servidor y pueden detectar el problema en segundos.

Espero que esta guía te haya sido de gran ayuda. Recuerda que solucionar base datos PrestaShop es más sencillo de lo que parece si sigues los pasos con calma. ¡Tu tienda volverá a estar online en poco tiempo! Si tienes más dudas, no dudes en escribirme. ¡Éxito!