Arreglar error de conexión a BD en PrestaShop con DirectAdmin

¿Por qué PrestaShop muestra "Error de conexión a la base de datos"?

Cuando tu tienda PrestaShop se cae y aparece el temido mensaje "Error de conexión a la base de datos", es normal que salten las alarmas. Este error puede aparecer tanto en la parte pública de tu tienda como en el panel de administración, y suele deberse a problemas con los datos de acceso, el servidor de bases de datos o la configuración del archivo parameters.php.

Si estás usando DirectAdmin como panel de control de tu hosting, tienes la ventaja de contar con herramientas gráficas muy útiles para diagnosticar y solucionar el problema sin necesidad de ser un experto en programación. En este artículo te explicaré, paso a paso y con un lenguaje sencillo, cómo resolver este error en tu PrestaShop con DirectAdmin.

El origen del problema: ¿qué significa realmente este error?

Antes de lanzarnos a cambiar cosas, es importante entender qué significa este mensaje. PrestaShop necesita conectarse a una base de datos MySQL o MariaDB para funcionar. Esta base de datos almacena tus productos, pedidos, clientes, configuraciones y todo lo demás. Cuando PrestaShop no puede conectarse, la tienda se queda "en blanco" o muestra ese mensaje tan poco amigable.

Las causas más comunes de este fallo son:

Datos de acceso incorrectos (usuario, contraseña o nombre de la base de datos).
La base de datos ha alcanzado su límite de conexiones o está saturada.
El servidor de bases de datos está caído o reiniciándose.
El archivo de configuración parameters.php está corrupto o mal editado.
Cambios recientes en el hosting (por ejemplo, migración de servidor o cambio de contraseña).
Problemas con los permisos de usuario de la base de datos.

Vamos a ir descartando causas una a una, de la más sencilla a la más compleja, para que puedas recuperar tu tienda cuanto antes.

Primeros pasos: verifica el estado del servidor

### Comprueba si el problema es general o solo tuyo

Lo primero que debes hacer es asegurarte de que el problema no viene de tu conexión a internet o del propio servidor de hosting. Puedes usar herramientas online como "Down for everyone or just me" para comprobar si tu tienda está caída para todo el mundo o solo para ti.

[TIP]: Si la tienda funciona desde tu móvil con datos móviles pero no desde tu ordenador, es probable que el problema sea local (caché, DNS, etc.) y no un error real de conexión a la base de datos.

### Revisa el estado del servidor en DirectAdmin

Accede a tu panel de DirectAdmin (normalmente en https://tudominio.com:2222). Una vez dentro, busca la sección de "Servicios" o "System Status". Allí podrás ver si el servicio de MySQL o MariaDB está activo y funcionando.

Si el servicio aparece como "stopped" o "down", intenta reiniciarlo desde el propio panel.
Si no puedes reiniciarlo o el servicio se detiene inmediatamente, contacta con tu proveedor de hosting, ya que puede ser un problema del servidor.

Solución 1: Verificar los datos de acceso en el archivo parameters.php

Esta es la causa más habitual y la más fácil de solucionar. PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php, que se encuentra en la carpeta app/config/ de tu instalación.

### Cómo acceder al archivo parameters.php

Entra en DirectAdmin y abre el Administrador de Archivos (File Manager).
Navega hasta la carpeta public_html (o la carpeta donde tengas instalada tu tienda).
Entra en la carpeta app y luego en config.
Busca el archivo parameters.php y haz clic derecho para editarlo.

### Qué debes revisar en el archivo

Dentro del archivo verás una estructura como esta (simplificada):

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

Comprueba que estos cuatro valores coincidan exactamente con los datos de tu base de datos en DirectAdmin. Para verificar los datos correctos:

En DirectAdmin, busca la sección "MySQL Management" o "Bases de datos MySQL".
Allí verás la lista de bases de datos, los usuarios asociados y podrás cambiar las contraseñas.

[WARNING]: Ten mucho cuidado al editar este archivo. Si dejas una coma mal puesta o un carácter extra, PrestaShop no podrá cargar y el error será aún peor. Haz siempre una copia de seguridad del archivo antes de modificarlo.

### Cómo cambiar la contraseña de la base de datos

Si sospechas que la contraseña es incorrecta (por ejemplo, porque la cambiaste recientemente), puedes restablecerla desde DirectAdmin:

Ve a "MySQL Management".
Localiza el usuario de tu base de datos.
Haz clic en "Change Password" y establece una nueva.
Actualiza el archivo parameters.php con la nueva contraseña.

Solución 2: Comprobar el host de la base de datos

Aunque normalmente el host es localhost, en algunos servidores con DirectAdmin puede ser diferente, como 127.0.0.1 o incluso un nombre de servidor específico. Si tu proveedor de hosting te ha dado un host concreto para la base de datos, asegúrate de que esté correctamente reflejado en el parameters.php.

### Cómo saber el host correcto

Si tu hosting es compartido, casi siempre será localhost o 127.0.0.1.
Si tienes un servidor dedicado o VPS, el host puede ser algo como mysql.tudominio.com.
En caso de duda, consulta la documentación de tu hosting o contacta con soporte.

Solución 3: Limpiar la caché de PrestaShop

A veces, PrestaShop guarda en caché configuraciones antiguas que provocan conflictos. Si has modificado el parameters.php pero el error persiste, es posible que necesites limpiar la caché.

### Eliminar la caché manualmente

Ve al Administrador de Archivos de DirectAdmin.
Accede a la carpeta var/cache (en PrestaShop 1.7 y versiones posteriores).
Elimina todo el contenido de las subcarpetas dev y pro (pero no las carpetas en sí).
Si no encuentras estas carpetas, busca en cache (para PrestaShop 1.6).

[INFO]: Si no puedes acceder al panel de administración porque también te da error, esta eliminación manual de la caché es la mejor opción. No te preocupes, PrestaShop regenerará la caché automáticamente.

Solución 4: Verificar los límites de conexión a la base de datos

Otro problema común es que la base de datos alcance el límite máximo de conexiones simultáneas. Esto suele pasar si tu tienda tiene mucho tráfico o si hay algún script que esté haciendo peticiones continuas.

### Cómo comprobar los límites en DirectAdmin

En el panel de DirectAdmin, busca la sección de "MySQL" o "Database Metrics". Algunos proveedores ofrecen estadísticas de uso. Si ves que el número de conexiones está cerca del límite, puede ser el origen del error.

### Soluciones para el límite de conexiones

Optimiza tu tienda: Desactiva módulos que no uses, activa la caché de PrestaShop y considera usar un plugin de caché para mejorar el rendimiento.
Aumenta el límite: Si tienes un plan de hosting que lo permita, puedes solicitar a tu proveedor que aumente el límite de conexiones.
Reinicia el servicio MySQL: Desde DirectAdmin, en la sección de servicios, puedes reiniciar MySQL para liberar conexiones atascadas.

Solución 5: Reparar las tablas de la base de datos

Si las tablas de tu base de datos están corruptas, también puede dar error de conexión. Afortunadamente, DirectAdmin incluye herramientas para repararlas.

### Usar phpMyAdmin para reparar tablas

En DirectAdmin, busca el icono de phpMyAdmin (normalmente dentro de la sección de MySQL).
Selecciona tu base de datos en el panel izquierdo.
Marca todas las tablas (botón "Seleccionar todo").
En el menú desplegable inferior, elige "Reparar tabla".

[WARNING]: Esta operación puede tardar unos minutos si la base de datos es grande. No cierres la ventana del navegador durante el proceso.

Solución 6: Cambiar el motor de base de datos

A veces, el problema viene porque PrestaShop está configurado para usar un motor de base de datos que no está disponible en tu servidor. Los más comunes son InnoDB y MyISAM.

### Cómo cambiar el motor de las tablas

Entra en phpMyAdmin.
Selecciona tu base de datos.
Ve a la pestaña "SQL" y ejecuta el siguiente comando:

ALTER TABLE nombre_de_tabla ENGINE=InnoDB;

Repite esto para cada tabla o usa un script para cambiar todas a la vez. Si no te sientes cómodo con SQL, puedes usar la opción de "Operaciones" en cada tabla y cambiar el motor desde el menú desplegable.

Solución 7: Revisar los permisos del usuario de la base de datos

En DirectAdmin, cada base de datos tiene usuarios asociados con permisos específicos. Si el usuario no tiene permisos suficientes (por ejemplo, solo tiene permisos SELECT y no INSERT o UPDATE), PrestaShop no funcionará correctamente.

### Cómo verificar y cambiar permisos

Ve a "MySQL Management" en DirectAdmin.
Haz clic en el usuario de tu base de datos.
Asegúrate de que tenga todos los privilegios marcados (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc.).
Guarda los cambios.

Solución 8: Restaurar una copia de seguridad

Si has probado todo lo anterior y el problema persiste, es posible que la base de datos esté dañada de forma irreparable o que algún archivo de configuración se haya corrompido. En ese caso, restaurar una copia de seguridad reciente es la solución más segura.

### Cómo restaurar desde DirectAdmin

En tu panel de DirectAdmin, busca la sección de "Backups" o "Administración de copias de seguridad".
Localiza la copia de seguridad más reciente de tu base de datos (y si es posible, también de los archivos).
Restaura la copia.

[INFO]: Si tu hosting no ofrece copias de seguridad automáticas, es fundamental que tengas un sistema de copias externo. Puedes usar módulos de PrestaShop o herramientas como mysqldump para hacer copias manuales periódicas.

Solución extra: ¿Qué pasa si nada de esto funciona?

Si has seguido todos los pasos y el error persiste, puede ser un problema más profundo del servidor. En ese caso:

Contacta con tu proveedor de hosting y explícales el error exacto que te aparece.
Si tienes acceso a los logs del servidor (en DirectAdmin, sección "Logs" o "Error Logs"), revísalos y comparte la información relevante con soporte.
Considera migrar tu tienda a un hosting especializado en PrestaShop si el problema es recurrente.

Preguntas frecuentes (FAQ)

### ¿Por qué me da error de conexión a la base de datos después de cambiar la contraseña de MySQL?

Es muy común. Al cambiar la contraseña desde DirectAdmin, debes actualizarla también en el archivo parameters.php de PrestaShop. Si no lo haces, la tienda no podrá conectarse.

### ¿Cómo sé si mi base de datos está caída?

Accede a DirectAdmin y revisa el estado del servicio MySQL en la sección de servicios. Si aparece como detenido, intenta reiniciarlo. Si no puedes, contacta con soporte.

### ¿Qué es Syspanel y tiene que ver con este error?

Syspanel (antes conocido como HestiaCP) es otro panel de control de hosting. Si tu hosting usa Syspanel, el acceso se realiza a través del puerto 2106 (https://tudominio.com:2106). Aunque este artículo se centra en DirectAdmin, los pasos para solucionar el error de conexión a la base de datos son muy similares en cualquier panel de control. La diferencia principal está en la interfaz y en los nombres de las secciones.

### ¿Puedo evitar este error en el futuro?

Sí, con estas buenas prácticas:

Realiza copias de seguridad periódicas de tu base de datos y archivos.
No cambies contraseñas sin actualizar el parameters.php inmediatamente.
Mantén PrestaShop y sus módulos actualizados.
Monitorea el uso de recursos de tu hosting para evitar saturaciones.

Conclusión

El error de conexión a la base de datos en PrestaShop puede ser estresante, pero en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo desde DirectAdmin. Hemos visto desde lo más básico (verificar contraseñas) hasta soluciones más avanzadas (reparar tablas o cambiar el motor de base de datos).

Recuerda siempre trabajar con calma, hacer copias de seguridad antes de modificar cualquier archivo y, si te sientes perdido, no dudes en contactar con el soporte de tu hosting. Ellos tienen acceso a herramientas y logs que tú no puedes ver, y estarán encantados de ayudarte a recuperar tu tienda online.

Con estos pasos, tu tienda PrestaShop debería volver a estar operativa en poco tiempo. ¡Mucha suerte y a vender!