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

Introducción: El temido error de conexión a la base de datos

Si estás leyendo esto, probablemente te has encontrado con una pantalla en blanco o un mensaje de error crítico en tu tienda PrestaShop que dice algo como “Error de conexión a la base de datos” o “Cannot connect to database”. Es una situación frustrante, especialmente si tienes clientes intentando comprar. No te preocupes: este error es uno de los más comunes en entornos de hosting con DirectAdmin y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin ser un experto técnico.

En esta guía extensa y detallada, te explicaré paso a paso cómo diagnosticar y solucionar el error base datos PrestaShop DirectAdmin, asegurando que tu tienda vuelva a funcionar en minutos. Cubriremos desde las causas más básicas hasta las soluciones más avanzadas, todo explicado de forma clara y sin tecnicismos innecesarios.

¿Por qué ocurre el error de conexión a la base de datos en PrestaShop con DirectAdmin?

Antes de lanzarnos a las soluciones, es importante entender qué está pasando. El error de conexión base datos PrestaShop DirectAdmin se produce cuando PrestaShop no puede comunicarse con el servidor de base de datos MySQL o MariaDB. Las causas más frecuentes son:

Cambios en la contraseña de la base de datos (el más común).
El servicio de base de datos está detenido en el servidor.
Archivos de configuración corruptos o mal editados (especialmente el archivo app/config/parameters.php).
Problemas de permisos en la base de datos o en los archivos de configuración.
El usuario de la base de datos ha sido eliminado o modificado desde el panel de DirectAdmin.
Migración o cambio de servidor sin actualizar correctamente los datos de conexión.

Requisitos previos antes de empezar

Para seguir esta guía necesitarás:

Acceso al panel de DirectAdmin de tu hosting (usuario y contraseña).
Acceso a cPanel o al administrador de archivos de DirectAdmin (o un cliente FTP como FileZilla).
Los datos de acceso a tu base de datos (usuario, contraseña, nombre de la base de datos y servidor).
Un editor de texto plano (como Notepad++, Sublime Text o el bloc de notas).

[WARNING] Antes de hacer cualquier cambio, siempre haz una copia de seguridad de tu base de datos y de los archivos de configuración. Un error al editar puede dejar tu tienda completamente inaccesible.

Paso 1: Verificar que el servicio de base de datos esté activo en DirectAdmin

Lo primero es asegurarte de que MySQL o MariaDB esté funcionando correctamente en tu servidor. A veces el servicio se detiene por mantenimiento o por un error del sistema.

Inicia sesión en DirectAdmin.
Ve a "Account Manager" > "MySQL Management" o directamente busca "MySQL" en el menú.
Revisa si aparece algún mensaje de error o si el servicio está marcado como "Stopped".
Si ves que está detenido, busca el botón "Start" o "Restart" y haz clic para reiniciarlo.
Espera unos segundos y verifica que el estado cambie a "Running".

Si el servicio no arranca, contacta a tu proveedor de hosting, ya que puede ser un problema del servidor.

[TIP] En algunos paneles de DirectAdmin, también puedes verificar el estado desde "System Info & Monitoring" > "Services". Busca "mysqld" y asegúrate de que esté en verde.

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

El archivo que contiene los datos de conexión de PrestaShop es app/config/parameters.php. Si este archivo tiene credenciales incorrectas, tu tienda no podrá conectar.

¿Cómo localizar y editar el archivo?

Accede a los archivos de tu sitio web. Puedes usar:
- File Manager de DirectAdmin (en la sección "File Manager").
- O un cliente FTP (FileZilla, Cyberduck).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o domains/tudominio.com/public_html).
Busca la carpeta app/config/ y dentro de ella el archivo parameters.php.
Descarga una copia de seguridad de este archivo antes de editarlo.
Ábrelo con un editor de texto plano.

¿Qué buscar en el archivo?

Dentro de parameters.php encontrarás líneas como estas:

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

database_host: Normalmente es localhost, pero en algunos servidores puede ser una IP como 127.0.0.1 o un nombre de host específico.
database_name: El nombre exacto de tu base de datos (puedes verificarlo en DirectAdmin).
database_user: El usuario asociado a esa base de datos.
database_password: La contraseña de ese usuario.

[WARNING] Si no recuerdas la contraseña, no la inventes. Ve al paso siguiente para obtenerla desde DirectAdmin.

¿Qué hacer si los datos son incorrectos?

Corrige los valores con los datos correctos que obtendrás en el paso siguiente. Guarda el archivo y súbelo de nuevo (si usaste FTP) o simplemente guarda los cambios si usas el File Manager.

Paso 3: Obtener las credenciales correctas desde DirectAdmin

Para asegurarte de que los datos son correctos, verifica la información directamente en tu panel de hosting.

En DirectAdmin, ve a "Account Manager" > "MySQL Management".
Verás una lista de tus bases de datos. Localiza la que usa tu PrestaShop.
Haz clic en el icono de "lápiz" o "Edit" junto a la base de datos.
Aparecerán los siguientes datos:
- Database: El nombre completo (ej. usuario_bdpresta).
- User: El usuario asignado (ej. usuario_bduser).
- Password: Aquí puedes ver la contraseña actual o generar una nueva.
Anota estos tres datos exactamente como aparecen (respeta mayúsculas, minúsculas y caracteres especiales).

[INFO] Si la contraseña está oculta (con asteriscos), puedes hacer clic en "Show" o generar una nueva. Si generas una nueva, asegúrate de actualizarla también en el archivo parameters.php.

Paso 4: Probar la conexión manualmente (opcional pero recomendado)

Para descartar problemas de permisos o de la base de datos en sí, puedes probar la conexión desde una herramienta como phpMyAdmin (incluida en DirectAdmin).

En DirectAdmin, ve a "Advanced Features" > "phpMyAdmin".
Inicia sesión con el usuario y contraseña de la base de datos que anotaste.
Si puedes entrar sin problemas, la base de datos funciona correctamente y el problema está en el archivo de configuración de PrestaShop.
Si no puedes entrar, el error está en las credenciales o en la base de datos misma. En ese caso, verifica que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) sobre la base de datos. En DirectAdmin, puedes asignar privilegios desde la misma sección de MySQL Management.

Paso 5: Verificar los permisos del archivo de configuración

A veces, aunque los datos sean correctos, PrestaShop no puede leer el archivo parameters.php debido a permisos incorrectos.

Desde el File Manager o FTP, localiza app/config/parameters.php.
Haz clic derecho sobre el archivo y selecciona "Change Permissions" o "CHMOD".
Asegúrate de que los permisos sean 644 (lectura y escritura para el propietario, solo lectura para el grupo y otros). Si es necesario, cambia a 644.
También verifica que la carpeta app/config/ tenga permisos 755.

[TIP] Si después de cambiar los permisos el error persiste, prueba con permisos 444 (solo lectura) para el archivo. A veces los entornos de producción requieren que el archivo de configuración no sea escribible por el servidor web.

Paso 6: Limpiar la caché de PrestaShop

A veces, aunque corrijas los datos, PrestaShop sigue mostrando el error porque tiene una caché corrupta. Para limpiarla:

Accede a los archivos de tu tienda.
Elimina manualmente el contenido de la carpeta var/cache/ (todos los archivos y subcarpetas, pero no la carpeta en sí).
También puedes eliminar la carpeta cache/ si existe en la raíz.
Vuelve a cargar tu tienda. Si el error persiste, continúa con el siguiente paso.

Paso 7: Restaurar una copia de seguridad de la base de datos

Si has verificado todos los pasos anteriores y el error sigue apareciendo, es posible que la base de datos esté corrupta. En ese caso:

Ve a phpMyAdmin desde DirectAdmin.
Selecciona tu base de datos.
Haz clic en "Importar" y sube una copia de seguridad reciente de tu base de datos (en formato .sql).
Asegúrate de que el archivo de copia esté completo y no esté dañado.
Después de la importación, vuelve a probar tu tienda.

[WARNING] Si no tienes una copia de seguridad, contacta a tu proveedor de hosting. Algunos tienen backups automáticos que pueden restaurar.

Paso 8: Contactar con el soporte técnico (si nada funciona)

Si después de seguir todos estos pasos el error base datos PrestaShop DirectAdmin persiste, el problema puede estar en el servidor mismo (configuración de PHP, límites de conexión, firewall, etc.). En ese caso:

Abre un ticket de soporte con tu proveedor de hosting.
Proporciona la siguiente información:
- El mensaje de error exacto.
- Los pasos que ya has intentado.
- Capturas de pantalla si es posible.
Un buen técnico podrá revisar los logs del servidor y detectar el problema rápidamente.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error después de cambiar la contraseña en DirectAdmin?

Es la causa más común. Al cambiar la contraseña de la base de datos desde DirectAdmin, debes actualizarla también en el archivo app/config/parameters.php de PrestaShop. Si no lo haces, la conexión falla.

¿Qué hago si no encuentro el archivo parameters.php?

En versiones antiguas de PrestaShop (1.6 o anteriores), el archivo de configuración se llama config/settings.inc.php. Si usas PrestaShop 1.7 o superior, busca en app/config/parameters.php.

¿Puedo usar el mismo usuario para varias bases de datos?

Sí, pero cada base de datos necesita sus propios permisos. En DirectAdmin, puedes asignar un mismo usuario a varias bases de datos desde MySQL Management.

¿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 cambiar de tema, desactívalos temporalmente renombrando la carpeta modules o themes desde FTP para aislar el problema.

¿Qué es "localhost" y cuándo debo cambiarlo?

"localhost" es la dirección del servidor de base de datos cuando está en el mismo servidor que tu web. Si tu base de datos está en un servidor externo (por ejemplo, en un servicio de base de datos en la nube), deberás usar la IP o el nombre de host que te proporcione tu proveedor.

Conclusión

El error de conexión a la base de datos en PrestaShop con DirectAdmin puede ser alarmante, pero en la mayoría de los casos se soluciona en pocos minutos revisando las credenciales, el estado del servicio y los permisos de archivos. Siguiendo esta guía paso a paso, podrás diagnosticar y resolver el problema tú mismo, ahorrando tiempo y dinero en soporte técnico.

Recuerda siempre mantener copias de seguridad actualizadas de tu tienda y de tu base de datos. La prevención es la mejor herramienta contra este tipo de errores.

Si este artículo te ha sido útil, compártelo con otros usuarios de PrestaShop que puedan estar enfrentando el mismo problema. ¡Tu tienda volverá a funcionar en poco tiempo!