Solucionar error base de datos PrestaShop DirectAdmin

¡Hola! Soy tu técnico de soporte de confianza. Hoy vamos a resolver uno de los problemas más comunes y angustiosos para cualquier dueño de tienda online: el temido error de conexión a la base de datos en PrestaShop. Si ves un mensaje como "Cannot connect to DB" o "Error de conexión a la base de datos", no entres en pánico. Vamos a solucionarlo paso a paso, especialmente si tu hosting está gestionado con DirectAdmin.

Este artículo está diseñado para que, incluso si no eres un experto técnico, puedas diagnosticar y reparar base datos PrestaShop por ti mismo. Al final, tendrás una guía clara para recuperar tu tienda.

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

Cuando tu tienda PrestaShop intenta cargar, necesita comunicarse con una base de datos MySQL donde se almacenan todos tus productos, clientes, pedidos y configuraciones. El error de conexión indica que esa comunicación está rota. Las causas pueden ser varias, desde un cambio de contraseña hasta un fallo en el servidor.

Las razones más habituales son:

Credenciales incorrectas en el archivo de configuración de PrestaShop.
El servidor MySQL está caído o sobrecargado.
La base de datos ha sido corrompida (por un cierre incorrecto, por ejemplo).
El usuario de la base de datos ha perdido permisos.
Problemas con el archivo settings.inc.php (el que guarda las credenciales).

No te preocupes, vamos a revisar cada una de estas causas.

Requisitos previos: Acceso a DirectAdmin y herramientas básicas

Antes de empezar, asegúrate de tener a mano:

Tus datos de acceso a DirectAdmin (usuario y contraseña del panel de control de tu hosting).
Acceso a tu panel de PrestaShop (aunque esté caído, a veces podemos acceder al back office).
Un cliente FTP (como FileZilla) o el Administrador de Archivos de DirectAdmin. No te asustes, es más fácil de lo que parece.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es muy similar, pero recuerda que la URL de acceso es tudominio.com:2106. Los pasos dentro del panel son prácticamente idénticos.

Paso 1: Verificar que el servidor MySQL esté funcionando en DirectAdmin

Lo primero es lo primero: asegurarnos de que el motor de bases de datos esté activo. A veces, el servidor se reinicia o se cuelga.

Accede al servicio MySQL en DirectAdmin

Inicia sesión en tu DirectAdmin.
Busca en el menú principal la sección "Account Manager" o "Gestión de Cuentas".
Haz clic en "MySQL Management" o "Gestión de MySQL". En algunos temas, puede aparecer como "Databases".
Verás una lista de tus bases de datos. Si todo está bien, debería aparecer un mensaje como "MySQL is running" o un indicador verde.
Si ves que está "Stopped" o "Down", busca el botón "Start" o "Restart" y actívalo.

[TIP] Si no encuentras esta opción, puede que tu plan de hosting no te permita reiniciar el servicio. En ese caso, contacta con tu proveedor de hosting y pídeles que revisen el estado del servicio MySQL.

Comprueba desde phpMyAdmin

Dentro de la misma sección de MySQL, suele haber un enlace a phpMyAdmin. Haz clic en él. Si se abre sin problemas y ves tus bases de datos, significa que MySQL está funcionando correctamente. Si te da error, el problema es del servidor.

Paso 2: Revisar las credenciales en el archivo de configuración de PrestaShop

Si MySQL funciona, el error suele estar en el archivo app/config/parameters.php (en PrestaShop 1.7 y 8.x) o config/settings.inc.php (en PrestaShop 1.6). Este archivo contiene el nombre de la base de datos, el usuario y la contraseña.

Localiza y edita el archivo

Desde DirectAdmin, ve a "File Manager" (Administrador de Archivos).
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o tu-dominio).
Busca la carpeta app/config y dentro, el archivo parameters.php. (Si es PrestaShop 1.6, busca config/settings.inc.php).
Haz clic derecho sobre el archivo y selecciona "Edit" (Editar).

Verifica los datos de conexión

Dentro del archivo, busca líneas como estas:

'database_host' => 'localhost',
'database_name' => 'tu_usuario_bd',
'database_user' => 'tu_usuario_bd',
'database_password' => 'tu_contraseña_bd',

Comprueba que coincidan exactamente con los datos de tu base de datos en DirectAdmin.

[WARNING] Ten mucho cuidado al editar este archivo. Un solo carácter mal puesto (una coma, una comilla) romperá tu tienda. Si no te sientes seguro, haz una copia de seguridad del archivo antes de modificarlo.

Obtén los datos correctos desde DirectAdmin

Vuelve a "MySQL Management" en DirectAdmin.
Verás una tabla con tus bases de datos. Anota el nombre exacto de la base de datos y el usuario asociado.
Si no recuerdas la contraseña, puedes cambiarla desde aquí. Haz clic en el icono de "Editar" (un lápiz) junto al usuario y establece una nueva contraseña segura.
Actualiza el archivo parameters.php con la nueva contraseña.
Guarda los cambios y cierra el editor.

Paso 3: Reparar la base de datos desde phpMyAdmin

A veces, la base de datos se corrompe parcialmente. PrestaShop no puede conectarse porque una tabla está dañada. Vamos a reparar base datos PrestaShop directamente.

Accede a phpMyAdmin

Desde "MySQL Management" en DirectAdmin, haz clic en el enlace a phpMyAdmin (suele ser un icono de una base de datos).
Se abrirá una nueva pestaña. A la izquierda, verás una lista de bases de datos. Haz clic en la que corresponde a tu PrestaShop.

Repara todas las tablas

Una vez dentro de tu base de datos, verás una lista de tablas (son muchas, no te asustes).
Selecciona todas las tablas. Para ello, justo debajo de la lista de tablas, hay una casilla de verificación "Seleccionar todo" o "Check All".
En el menú desplegable que dice "Con selección:" (o "With selected:"), elige la opción "Reparar tabla" (o "Repair table").
phpMyAdmin ejecutará el proceso. Verás mensajes como "OK" o "La tabla está ya actualizada". Esto suele solucionar problemas menores de corrupción.

[INFO] Si después de reparar sigues teniendo errores, puedes probar con la opción "Optimizar tabla". Esto no es estrictamente necesario para la conexión, pero ayuda al rendimiento.

Paso 4: Verificar los permisos del usuario de la base de datos

A veces, el usuario de la base de datos pierde permisos, especialmente si has restaurado una copia de seguridad o has migrado el sitio.

Reasigna permisos desde DirectAdmin

En "MySQL Management", busca la base de datos problemática.
Haz clic en el icono de "Editar" (normalmente un lápiz) junto al nombre de la base de datos.
Verás una lista de usuarios. Asegúrate de que el usuario correcto esté marcado.
Marca la casilla "Todos los privilegios" (o "All Privileges").
Guarda los cambios.

[TIP] Si no ves la opción de editar permisos, puedes eliminar el usuario y volver a asignarlo a la base de datos desde el mismo panel. No te preocupes, los datos no se borran, solo los permisos de acceso.

Paso 5: Comprobar el archivo .htaccess (casos avanzados)

En raras ocasiones, un archivo .htaccess mal configurado puede bloquear la conexión a la base de datos. Esto es más común si has instalado algún módulo de seguridad o has hecho cambios manuales.

Renombra temporalmente el archivo

Desde el Administrador de Archivos de DirectAdmin, ve a la raíz de tu tienda.
Busca el archivo .htaccess. Puede estar oculto. Si no lo ves, activa la opción "Mostrar archivos ocultos" (Show Hidden Files) en la configuración del administrador.
Cámbiale el nombre a .htaccess_backup.
Prueba a cargar tu tienda. Si funciona, el problema está en ese archivo. Puedes regenerarlo desde el back office de PrestaShop (en Parámetros de la tienda > Tráfico y SEO > SEO y URLs, haz clic en "Guardar" sin cambiar nada para que lo regenere).

[WARNING] No borres el archivo .htaccess original, solo renómbralo. Si al regenerarlo tienes problemas, puedes restaurar el original.

Preguntas frecuentes (FAQ) sobre errores de base de datos en PrestaShop

Aquí respondo a las dudas más comunes que me encuentro en el soporte técnico.

¿Por qué aparece "Error de conexión a la base de datos" después de mover mi tienda a un nuevo hosting?

Es el motivo más frecuente. Al cambiar de hosting, las credenciales (nombre de BD, usuario y contraseña) cambian. Debes actualizar el archivo app/config/parameters.php con los nuevos datos de tu DirectAdmin.

¿Puedo perder datos si reparo la base de datos?

No. Reparar una tabla solo intenta corregir errores de estructura. No elimina filas ni registros. Es un proceso seguro.

¿Qué hago si ni siquiera puedo acceder a phpMyAdmin?

Si phpMyAdmin no abre, el problema es grave y está del lado del servidor. Contacta con tu proveedor de hosting y diles: "Mi DirectAdmin PrestaShop MySQL no funciona, no puedo acceder a phpMyAdmin". Ellos deberán revisar el servicio MySQL.

¿Un plugin de seguridad puede causar este error?

Sí. Algunos módulos de seguridad o firewall modifican el archivo .htaccess o bloquean IPs. Si el error apareció justo después de instalar un módulo, desactívalo (renombra la carpeta del módulo en /modules mediante FTP).

¿El error "Cannot connect to DB" siempre es culpa de la base de datos?

No siempre. A veces es un problema de permisos de archivos. Asegúrate de que la carpeta app/config tenga permisos 755 y el archivo parameters.php tenga 644. Puedes cambiarlos desde el Administrador de Archivos de DirectAdmin.

Resumen final: Checklist para solucionar el error

Para que no te pierdas, aquí tienes una lista de verificación rápida:

Reinicia MySQL desde DirectAdmin (si es posible).
Verifica credenciales en app/config/parameters.php contra los datos de DirectAdmin.
Repara la base de datos desde phpMyAdmin (seleccionar todas las tablas > Reparar).
Reasigna permisos al usuario de la base de datos en DirectAdmin.
Renombra el .htaccess para descartar conflictos.
Contacta a tu hosting si nada funciona.

Espero que esta guía detallada te haya sido de gran ayuda. Recuerda que la paciencia es clave. Si sigues estos pasos, en la mayoría de los casos podrás corregir error de conexión a base de datos en PrestaShop sin necesidad de un técnico. ¡Tu tienda volverá a estar online en poco tiempo!