Solucionar errores de conexión a base de datos PrestaShop en DirectAdmin

Si estás leyendo esto, probablemente te has encontrado con un mensaje de error en tu tienda PrestaShop que dice algo como “No se puede conectar a la base de datos” o “Error de conexión a la base de datos”. Es frustrante, especialmente si tienes clientes intentando comprar. Pero no te preocupes: en la mayoría de los casos, es un problema que puedes resolver tú mismo siguiendo unos pasos lógicos y sencillos.

Este artículo está diseñado para guiarte paso a paso. Vamos a centrarnos en cómo solucionar errores de conexión a base de datos en PrestaShop cuando tu servidor utiliza el panel de control DirectAdmin. Aprenderás a identificar la causa, acceder a tus herramientas, corregir los datos de conexión y, si es necesario, restaurar la base de datos.

¿Por qué aparece este error en PrestaShop?

El error de conexión a la base de datos en PrestaShop puede aparecer por varias razones. Las más comunes son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos en el archivo de configuración de PrestaShop.
Servidor de base de datos caído: El servicio MySQL o MariaDB no está funcionando en tu servidor.
Espacio en disco agotado: Si el disco está lleno, la base de datos no puede operar correctamente.
Corrupción de la base de datos: Después de una migración, actualización o ataque, la base de datos puede dañarse.
Cambios en el hosting: Al mover tu tienda a otro servidor o cambiar de plan, los datos de conexión pueden ser diferentes.

[WARNING] Nunca modifiques archivos de configuración sin hacer una copia de seguridad previa. Un error puede dejar tu tienda completamente inaccesible.

Accede a DirectAdmin para diagnosticar

El primer paso es entrar a tu panel de control DirectAdmin. Si no recuerdas la URL, normalmente es algo como https://tudominio.com:2222 o la IP de tu servidor seguida del puerto 2222. Usa tu usuario y contraseña de hosting.

Una vez dentro, verás una interfaz con varias secciones. Nos interesa especialmente la parte de Base de Datos y Administración de Servicios.

Paso 1: Verifica que el servicio MySQL esté activo

A veces el problema es tan simple como que el servicio de base de datos se ha detenido.

En DirectAdmin, busca la sección "Administración de Servicios" o "Service Monitor".
Busca el servicio mysqld o mariadb.
Verifica que su estado sea "Running" (en ejecución). Si está detenido, haz clic en "Start" o "Reiniciar".
Espera unos segundos y vuelve a cargar tu tienda PrestaShop.

[TIP] Si el servicio se detiene con frecuencia, puede ser por falta de memoria RAM o por un error en la configuración del servidor. Contacta con tu proveedor de hosting si esto ocurre a menudo.

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

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado app/config/parameters.php. Si estos datos son incorrectos, la conexión fallará.

¿Cómo acceder al archivo?

Desde DirectAdmin, ve a la sección "Administrador de Archivos" (File Manager).
Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o domains/tudominio.com/public_html).
Busca la carpeta app/config y dentro de ella el archivo parameters.php.
Haz clic derecho sobre él y selecciona "Editar" (o "View" si solo quieres verlo).

¿Qué debes buscar?

Dentro del archivo verá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',

Comprueba que estos valores coincidan exactamente con los datos de tu base de datos en DirectAdmin. Los datos correctos los encuentras en la sección "Administrador de Bases de Datos" de DirectAdmin.

[WARNING] No cambies el database_host a menos que sepas que tu base de datos está en otro servidor. Normalmente debe ser localhost.

¿Cómo corregir los datos?

Si ves que algún dato está mal, cámbialo directamente en el editor y guarda el archivo. Luego recarga tu tienda.

Paso 3: Verifica las credenciales en DirectAdmin

A veces los datos son correctos en el archivo, pero la base de datos ha sido renombrada o el usuario ha sido eliminado. Para asegurarte:

En DirectAdmin, ve a "Administrador de Bases de Datos" (MySQL Management).
Verás una lista de todas las bases de datos y sus usuarios asociados.
Anota el nombre exacto de la base de datos y el usuario que debe usarla.
Compara con lo que tienes en el archivo parameters.php.

Si el usuario o la base de datos no existen, tendrás que crearlos de nuevo o cambiar los datos en PrestaShop para que apunten a una base existente.

[TIP] Si no recuerdas la contraseña de la base de datos, puedes cambiarla desde DirectAdmin. Hazlo y luego actualiza también el archivo parameters.php.

Paso 4: Comprueba el espacio en disco

Un disco lleno puede impedir que MySQL funcione.

En DirectAdmin, busca la sección "Uso de Disco" o "Disk Usage".
Verifica que no esté al 100%. Si lo está, libera espacio eliminando archivos temporales, logs antiguos o copias de seguridad innecesarias.
Después de liberar espacio, reinicia el servicio MySQL desde "Administración de Servicios".

Paso 5: Restaura la base de datos desde una copia de seguridad

Si después de todo lo anterior el error persiste, es probable que la base de datos esté corrupta. La solución más segura es restaurar una copia de seguridad reciente.

¿Cómo hacerlo en DirectAdmin?

Ve a "Administrador de Bases de Datos" y selecciona la base de datos problemática.
Haz clic en "phpMyAdmin" para acceder a la base de datos.
Dentro de phpMyAdmin, ve a la pestaña "Exportar" y descarga una copia de seguridad (aunque esté corrupta, puede servir para extraer datos).
Luego, borra todas las tablas de la base de datos (puedes usar la opción "Vaciar" o "Eliminar").
Ahora importa la copia de seguridad que tengas de antes de que ocurriera el error. Si no tienes, contacta con tu hosting o busca en las copias automáticas de DirectAdmin (suelen estar en la sección "Copias de Seguridad").

[INFO] Si no tienes copia de seguridad, puedes intentar reparar las tablas desde phpMyAdmin. Selecciona todas las tablas, elige "Reparar tabla" en el menú desplegable. No siempre funciona, pero vale la pena intentarlo.

Paso 6: Reinstala PrestaShop manteniendo los datos

Como último recurso, puedes reinstalar PrestaShop sin perder los productos ni clientes, siempre que tengas la base de datos intacta.

Descarga una copia fresca de PrestaShop desde la web oficial.
Sube los archivos a tu servidor (sobrescribiendo los existentes) usando el Administrador de Archivos de DirectAdmin o FTP.
Ejecuta la instalación desde tudominio.com/install.
Durante la instalación, elige "Actualizar" o "Reparar" y proporciona los datos de tu base de datos existente.
El proceso restaurará las tablas y configuraciones.

[WARNING] Este paso es avanzado. Si no te sientes seguro, pide ayuda a un técnico.

Preguntas frecuentes (FAQ)

¿Qué hago si el error aparece después de mover mi tienda a otro hosting?

Es muy común. Debes actualizar el archivo parameters.php con los nuevos datos de la base de datos del nuevo servidor. También asegúrate de que el servicio MySQL esté activo en el nuevo hosting.

¿Puedo evitar este error en el futuro?

Sí, te recomiendo:

Realizar copias de seguridad periódicas de la base de datos (DirectAdmin permite programarlas).
No modificar manualmente los archivos de configuración sin saber lo que haces.
Mantener PrestaShop y sus módulos actualizados.
Vigilar el espacio en disco.

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

Raramente, pero si instalaste un módulo justo antes del error, pruébalo desactivándolo desde la base de datos (en la tabla ps_module puedes cambiar su estado a 0).

¿Qué pasa si uso Syspanel (HestiaCP) en lugar de DirectAdmin?

Si tu panel es Syspanel (anteriormente conocido como HestiaCP), el proceso es similar pero accedes por el puerto 2106. Dentro, busca la sección de Bases de Datos y sigue los mismos pasos para verificar credenciales y servicios.

Conclusión

El error de conexión a la base de datos en PrestaShop puede parecer grave, pero en la mayoría de los casos se soluciona con unos pocos clics desde DirectAdmin. Recuerda siempre verificar primero el servicio MySQL, luego las credenciales y, si todo falla, restaurar desde una copia de seguridad.

Si después de seguir todos estos pasos el problema continúa, puede tratarse de un fallo en el servidor o en la configuración de red. En ese caso, contacta con tu proveedor de hosting y muéstrales este artículo para que sepan exactamente qué has revisado.

[INFO] Mantén la calma. Con orden y paciencia, tu tienda volverá a funcionar. Y si algo no te queda claro, busca ayuda profesional.

Palabras clave incluidas: DirectAdmin, PrestaShop error, conexión base de datos, solucionar errores PrestaShop, DirectAdmin PrestaShop.

Nota final: Este artículo está escrito para usuarios sin experiencia técnica. Si eres desarrollador, los pasos son igualmente válidos, pero puedes profundizar en logs de error de MySQL o en la consola de comandos para un diagnóstico más avanzado.