Error conexión base de datos PrestaShop en DirectAdmin: Soluciones

¿Tu tienda PrestaShop se ha quedado en blanco o muestra un mensaje de error crítico relacionado con la base de datos? No te preocupes, es uno de los problemas más comunes al gestionar un ecommerce, especialmente si estás usando un panel de control como DirectAdmin. En esta guía completa, te explicaré paso a paso cómo solucionar los errores de conexión a la base de datos PrestaShop DirectAdmin, desde los síntomas más típicos hasta las soluciones más efectivas. Vamos a ello.

¿Por qué ocurre el error de conexión MySQL en PrestaShop?

Antes de lanzarnos a arreglar nada, es importante entender qué está pasando. Cuando PrestaShop no puede conectar con su base de datos, suele mostrar un mensaje como "Error de conexión a la base de datos" o "Cannot connect to database". Esto puede deberse a varias razones, pero las más frecuentes 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.
Servidor MySQL caído o sobrecargado: El servicio de base de datos no está funcionando en tu servidor.
Problemas de permisos: El usuario de la base de datos no tiene acceso a la base de datos específica.
Archivo de configuración dañado: El archivo app/config/parameters.php (o config/settings.inc.php en versiones antiguas) está corrupto o tiene errores.
Migración o cambio de servidor: Al mover tu tienda, las rutas o credenciales no se actualizaron correctamente.

[INFO] En DirectAdmin, la gestión de bases de datos MySQL se realiza desde la sección "MySQL Management". Asegúrate de tener a mano tu usuario y contraseña de administrador del panel.

Diagnóstico rápido: Identifica el problema en tu base de datos PrestaShop DirectAdmin

No necesitas ser un experto para diagnosticar. Sigue estos pasos en orden para descubrir dónde está el fallo.

1. Verifica el estado del servidor MySQL desde DirectAdmin

Lo primero es comprobar que el servicio MySQL está activo. En DirectAdmin:

Inicia sesión en tu panel de DirectAdmin.
Busca la sección "Account Manager" o "Extra Features" y haz clic en "MySQL Management".
Si ves un mensaje como "MySQL is running" o similar, el servicio está activo. Si no, puede que esté detenido.
Si está detenido, contacta a tu proveedor de hosting para que lo reinicien, ya que en la mayoría de los planes compartidos no tienes acceso directo al servicio.

2. Revisa las credenciales en el archivo de configuración de PrestaShop

El archivo que guarda los datos de conexión es el app/config/parameters.php. Si tu PrestaShop es anterior a la versión 1.7, busca config/settings.inc.php. Para acceder a él:

Usa un cliente FTP (como FileZilla) o el administrador de archivos de DirectAdmin.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o domains/tudominio.com/public_html).
Busca el archivo app/config/parameters.php. Si no lo ves, activa la opción de "Mostrar archivos ocultos" en tu cliente FTP.
Ábrelo con un editor de texto (como Notepad++ o el editor de DirectAdmin).

Busca estas líneas:

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

[WARNING] Si ves que database_host es algo como localhost pero tu hosting usa un servidor remoto (por ejemplo, mysql.tudominio.com), ese es el problema. Cámbialo por la dirección correcta que te haya dado tu proveedor.

3. Prueba la conexión manualmente desde phpMyAdmin

Otra forma rápida es comprobar si las credenciales funcionan desde phpMyAdmin, la herramienta de gestión de bases de datos que incluye DirectAdmin.

En DirectAdmin, ve a "phpMyAdmin" dentro de la sección de bases de datos.
Introduce el usuario y contraseña que tienes en el archivo parameters.php.
Si no puedes iniciar sesión, las credenciales son incorrectas. Si sí puedes, el problema está en otro lado (por ejemplo, en la configuración de PrestaShop o en los permisos).

Soluciones paso a paso para el error conexión MySQL PrestaShop

Una vez identificado el origen, aplica la solución correspondiente. Aquí tienes las más efectivas.

Solución 1: Corrige las credenciales en `parameters.php` (la más común)

Si descubres que las credenciales son incorrectas (por ejemplo, porque cambiaste la contraseña en DirectAdmin), edita el archivo parameters.php:

Abre el archivo con un editor.
Modifica las líneas database_user y database_password con los valores correctos.
Guarda los cambios y cierra el editor.
Vuelve a cargar tu tienda. Si el error persiste, puede que el archivo esté en caché. Borra la carpeta var/cache/ (o cache/ en versiones antiguas) desde FTP.

[TIP] Siempre haz una copia de seguridad del archivo parameters.php antes de editarlo. Si algo sale mal, puedes restaurarlo.

Solución 2: Restablece la contraseña de la base de datos desde DirectAdmin

Si no recuerdas la contraseña o crees que está mal, puedes cambiarla directamente desde el panel:

En DirectAdmin, ve a "MySQL Management".
Localiza tu base de datos y haz clic en el icono de editar (normalmente un lápiz).
Verás la opción de cambiar la contraseña. Escríbela y guárdala.
Importante: Ahora debes actualizar el archivo parameters.php con la nueva contraseña, como en la Solución 1.

Solución 3: Verifica los permisos del usuario de la base de datos

A veces el usuario tiene acceso a la base de datos, pero no todos los permisos necesarios. Para asegurarte:

En "MySQL Management" de DirectAdmin, busca la opción "Privilegios" o "Permissions".
Asegúrate de que tu usuario tenga al menos los permisos: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP. Si no, márcalos y guarda.
Si no ves esta opción, puedes hacerlo desde phpMyAdmin: selecciona tu base de datos, ve a la pestaña "Privilegios" y edita el usuario para otorgar todos los privilegios.

Solución 4: Repara la base de datos desde phpMyAdmin (si está corrupta)

Si el error persiste y la tienda muestra mensajes como "Table 'ps_xxx' doesn't exist", la base de datos puede estar corrupta.

Entra a phpMyAdmin desde DirectAdmin.
Selecciona tu base de datos en el panel izquierdo.
Marca la casilla "Seleccionar todo" para elegir todas las tablas.
En el menú desplegable de abajo, elige "Reparar tabla".
Espera a que termine. Si hay errores graves, puede que necesites restaurar una copia de seguridad.

Solución 5: Restaura una copia de seguridad reciente

Si nada funciona y tienes una copia de seguridad (¡espero que sí!), este es el momento de usarla.

Desde DirectAdmin, ve a "Backup/Transfer" o usa phpMyAdmin para importar un archivo .sql.
Si usas phpMyAdmin:
- Selecciona tu base de datos.
- Ve a la pestaña "Importar".
- Elige tu archivo de respaldo (asegúrate de que no pese más de 50 MB; si es mayor, usa herramientas como BigDump).
Una vez restaurada, actualiza el archivo parameters.php si es necesario.

[WARNING] La restauración borrará todos los datos actuales. Asegúrate de que la copia sea reciente para no perder pedidos o productos.

Preguntas frecuentes (FAQ) sobre base de datos PrestaShop DirectAdmin

Aquí respondo las dudas más comunes que suelen tener los usuarios.

¿Por qué mi PrestaShop muestra "Error de conexión a la base de datos" después de migrar a un nuevo servidor?

Es muy habitual. Al migrar, las credenciales suelen cambiar. Debes editar el archivo app/config/parameters.php con los nuevos datos de la base de datos del nuevo servidor. Además, verifica que el database_host no sea localhost si tu nuevo hosting usa un servidor remoto.

¿Qué hago si no puedo acceder a DirectAdmin pero mi tienda tiene el error?

Si no tienes acceso al panel, contacta a tu proveedor de hosting. Ellos pueden verificar el estado del servidor MySQL y ayudarte a editar el archivo de configuración. También puedes intentar usar un cliente FTP para descargar y editar el parameters.php localmente.

¿El error puede deberse a un plugin o tema de PrestaShop?

Sí, aunque es menos común. Si instalaste un módulo o tema recientemente y luego apareció el error, puede que haya modificado el archivo de configuración. Prueba a desactivar el módulo desde la base de datos (si puedes acceder a phpMyAdmin) o restaura una copia de seguridad anterior.

¿Cómo evito este error en el futuro?

Haz copias de seguridad periódicas de tu base de datos y archivos.
Anota las credenciales en un lugar seguro.
Actualiza PrestaShop regularmente, ya que las versiones nuevas corrigen bugs de conexión.
No modifiques el archivo parameters.php a menos que sepas lo que haces.

Conclusión: No te asustes, solucionarlo es sencillo

Como has visto, la mayoría de los problemas de conexión a la base de datos PrestaShop DirectAdmin se resuelven con unos pocos pasos: verificar credenciales, revisar permisos o reparar la base de datos. Si sigues esta guía, en pocos minutos tu tienda volverá a funcionar.

Recuerda que la clave está en la paciencia y en ir paso a paso. Si después de intentarlo todo el error persiste, no dudes en contactar al soporte técnico de tu hosting; ellos tienen acceso directo al servidor y pueden ayudarte más rápido.

[INFO] Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el acceso a la gestión de bases de datos se hace a través del puerto 2106. El proceso es similar, pero asegúrate de usar la URL correcta: https://tudominio.com:2106.

Espero que este artículo te haya sido de gran ayuda. ¡Buena suerte con tu tienda PrestaShop!