Error de conexión a base de datos en PrestaShop | DirectAdmin

¿Qué significa el error "Error de conexión a la base de datos" en PrestaShop?

Cuando visitas tu tienda online y en lugar de ver tus productos aparece un mensaje como "Error de conexión a la base de datos" o "Link to database cannot be established", no entres en pánico. Este es uno de los fallos más comunes en PrestaShop y, por suerte, en la mayoría de los casos tiene una solución sencilla.

Este error indica que tu tienda no puede comunicarse con el servidor donde se almacenan tus datos (productos, clientes, pedidos, configuraciones). Es como si intentaras abrir una tienda física pero la puerta del almacén estuviera cerrada con llave y no tuvieras la llave correcta.

En este artículo, pensado especialmente para usuarios de DirectAdmin, te guiaré paso a paso para que puedas solucionar el error de conexión a la base de datos en PrestaShop, incluso si no eres un experto técnico. Vamos a ello.

Causas principales del error de conexión a base de datos PrestaShop

Antes de lanzarnos a solucionar, es útil entender por qué ocurre este problema. Las causas más habituales son:

Credenciales incorrectas en el archivo de configuración de PrestaShop.
La base de datos está caída o no responde en el servidor.
El servidor de base de datos (MySQL/MariaDB) tiene problemas de permisos o recursos.
El archivo de configuración ha sido modificado por error o por una actualización fallida.
Cambios en el panel de control (DirectAdmin, Syspanel, etc.) que afectan a las contraseñas.
Espacio en disco lleno o límites de memoria excedidos.

Vamos a revisar cada una de estas causas y cómo solucionarlas, ordenadas de la más sencilla a la más compleja.

Solución paso a paso para DirectAdmin

Paso 1: Verifica si la base de datos existe y está activa

Lo primero es comprobar que tu base de datos sigue existiendo y que el servicio de MySQL/MariaDB está funcionando en tu servidor.

Accede a tu panel de DirectAdmin (normalmente en https://tudominio.com:2222).
Busca la sección "MySQL Management" o "Base de Datos MySQL".
Revisa que tu base de datos aparezca en la lista. Si no aparece, es posible que se haya eliminado por error.
Comprueba también que el servicio MySQL esté activo. En DirectAdmin, puedes ir a "System Info" o "Server Status" y ver si el proceso mysqld o mariadb está corriendo.

[WARNING] Si no ves tu base de datos, no intentes crearla tú mismo sin antes contactar con tu proveedor de hosting. Podrías perder datos importantes.

Paso 2: Revisa el archivo de configuración de PrestaShop (parameters.php)

PrestaShop guarda la configuración de conexión a la base de datos en un archivo llamado parameters.php. Si este archivo tiene datos incorrectos, tendrás el error.

Accede a tu hosting mediante FTP o el Administrador de archivos de DirectAdmin.
Navega hasta la carpeta de tu tienda, normalmente en public_html o una subcarpeta.
Busca la ruta: config/parameters.php.
Descarga una copia de seguridad de este archivo a tu ordenador (por si acaso).
Ábrelo con un editor de texto como Notepad++ o Sublime Text.

Dentro verás algo similar a esto:

'database_host' => 'localhost',
'database_name' => 'usuario_nombrebasededatos',
'database_user' => 'usuario_usuariobd',
'database_password' => 'tucontraseña',

Comprueba que estos cuatro valores coinciden exactamente con los datos de tu base de datos en DirectAdmin. Presta mucha atención a:

El host: normalmente es localhost, pero a veces puede ser una IP como 127.0.0.1 o un nombre de servidor.
El nombre de la base de datos: en DirectAdmin suele llevar un prefijo con tu usuario (ej: usuario_bdtienda).
El usuario de la base de datos (también con prefijo).
La contraseña: asegúrate de que no tenga espacios ni caracteres extraños.

[TIP] Si no recuerdas tu contraseña de la base de datos, puedes cambiarla desde DirectAdmin en "MySQL Management" → selecciona tu base de datos → "Change Password". Luego actualiza el archivo parameters.php con la nueva contraseña.

Paso 3: Comprueba los permisos del archivo de configuración

A veces el problema no es el contenido, sino los permisos del archivo. Si parameters.php tiene permisos demasiado restrictivos, PHP no puede leerlo.

En el Administrador de archivos de DirectAdmin, localiza config/parameters.php.
Haz clic derecho sobre el archivo y selecciona "Change Permissions".
Asegúrate de que tenga permisos 644 (lectura y escritura para el propietario, lectura para el grupo y otros).
Guarda los cambios y recarga tu tienda.

Paso 4: Verifica el archivo settings.inc.php (versiones antiguas de PrestaShop)

Si tu PrestaShop es anterior a la versión 1.7, la configuración se guarda en el archivo config/settings.inc.php. El proceso es el mismo que en el paso 2, pero con este archivo. Asegúrate de que los valores de DB_NAME, DB_USER, DB_PASSWD y DB_SERVER sean correctos.

Soluciones avanzadas si el error persiste

Paso 5: Reinicia el servicio de base de datos desde DirectAdmin

Si has verificado las credenciales y todo parece correcto, el problema puede estar en el servicio de MySQL de tu servidor. Muchas veces, reiniciar el servicio resuelve bloqueos temporales.

En DirectAdmin, ve a la sección "System Commands" o "Server Management".
Busca la opción "Restart MySQL" o "Restart MariaDB".
Confirma el reinicio y espera unos segundos.
Vuelve a cargar tu tienda.

[INFO] Si no encuentras esta opción en tu panel de DirectAdmin, es posible que tu plan de hosting no incluya acceso a estos comandos. En ese caso, contacta con tu proveedor.

Paso 6: Comprueba el espacio en disco y los límites de recursos

Un disco lleno o un límite de memoria PHP demasiado bajo también pueden provocar errores de conexión a la base de datos.

En DirectAdmin, ve a "System Info" y revisa el espacio libre en disco.
Si está al 90% o más, intenta liberar espacio (borra cachés, backups antiguos, logs, etc.).
También puedes aumentar el límite de memoria de PHP en el archivo .htaccess o php.ini. Añade esta línea al .htaccess de tu tienda:

php_value memory_limit 256M

Paso 7: Revisa los logs de error de PrestaShop y del servidor

Los logs son tus mejores aliados para diagnosticar el problema.

En tu FTP, busca la carpeta var/logs (en PrestaShop 1.7+) o log (en versiones antiguas).
Abre el archivo de log más reciente y busca mensajes relacionados con la base de datos.
También puedes revisar los logs de error de DirectAdmin en la sección "Error Logs".

[TIP] Si el log dice algo como Access denied for user 'usuario'@'localhost', significa que la contraseña o el usuario son incorrectos. Si dice Unknown database, el nombre de la base de datos está mal.

Paso 8: Restaura una copia de seguridad reciente

Si nada de lo anterior funciona y tienes una copia de seguridad reciente de tu base de datos, puedes restaurarla. Esto es especialmente útil si el error apareció después de una modificación o actualización.

En DirectAdmin, ve a "MySQL Management".
Selecciona tu base de datos y busca la opción de "Backup" o "Restore".
Restaura la copia más reciente que tengas.
Si no tienes backups automáticos, contacta con tu proveedor para que te ayude.

DirectAdmin PrestaShop error: Consejos extra y prevención

Una vez que hayas solucionado el error de conexión a la base de datos en PrestaShop, es importante tomar medidas para que no vuelva a ocurrir:

Guarda tus credenciales en un lugar seguro (gestor de contraseñas).
Haz copias de seguridad periódicas de tu base de datos y archivos. DirectAdmin tiene herramientas automáticas, actívalas.
No modifiques archivos de configuración sin hacer una copia de seguridad previa.
Mantén PrestaShop actualizado a la última versión estable.
Si usas Syspanel (antes conocido como HestiaCP) en lugar de DirectAdmin, recuerda que el puerto de acceso es el 2106 y el proceso de verificación es similar, pero adaptado a su interfaz.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si borro la base de datos?

No borres la base de datos bajo ninguna circunstancia. Si lo haces, perderás todos tus productos, clientes y pedidos. Siempre intenta restaurar una copia de seguridad antes que eliminar nada.

¿Qué hago si el error aparece solo en el panel de administración?

Si el front-office (tu tienda) carga bien pero el back-office (admin) da error, suele ser un problema de caché o de permisos en la carpeta var/cache. Borra el contenido de var/cache (excepto el archivo .htaccess) y recarga.

¿Cuánto tiempo se tarda en solucionar este error?

En la mayoría de los casos, entre 10 y 30 minutos si sigues los pasos anteriores. Si el problema es del servidor y necesitas contactar con el soporte, puede tardar unas horas.

¿El error puede deberse a un ataque informático?

Es poco común, pero posible. Si sospechas de un ataque, revisa los logs de acceso y cambia todas tus contraseñas (panel, FTP, base de datos). También puedes instalar un módulo de seguridad.

¿Necesito conocimientos avanzados para arreglarlo?

No, con los pasos de esta guía y un poco de paciencia, cualquier persona puede solucionarlo. Si te atascas, siempre puedes pedir ayuda a tu proveedor de hosting mostrándole este artículo.

Conclusión

El error de conexión a la base de datos en PrestaShop es un contratiempo molesto, pero totalmente solucionable. Como has visto, la mayoría de las veces se debe a un problema de credenciales o a un servicio MySQL caído, y con las herramientas de DirectAdmin puedes resolverlo en pocos minutos.

Recuerda siempre:

Verifica las credenciales en parameters.php o settings.inc.php.
Comprueba el estado del servicio MySQL.
Revisa los logs para obtener pistas concretas.
Contacta con tu proveedor si el problema persiste; para eso están.

Espero que esta guía te haya sido de gran ayuda. Si sigues todos los pasos y aún así tienes problemas, no dudes en dejar tu consulta en los comentarios o contactar con el soporte de tu hosting. ¡Tu tienda online volverá a estar operativa en nada de tiempo!

[TIP] Guarda este artículo en favoritos; te será útil la próxima vez que aparezca este error. Y si te ha servido, compártelo con otros emprendedores que usen PrestaShop. ¡Nos vemos en el próximo tutorial!