Cómo solucionar error de conexión a base de datos en PrestaShop con DirectAdmin

Introducción: ¿Por qué aparece este error y cómo solucionarlo?

Uno de los sustos más comunes al gestionar una tienda online con PrestaShop en un servidor DirectAdmin es encontrarse con el temido mensaje de error de conexión a la base de datos. Este problema puede aparecer de repente, justo cuando menos lo esperas, dejando tu tienda inaccesible tanto para ti como para tus clientes.

Pero no te preocupes. En esta guía extensa y detallada, te explicaré paso a paso cómo identificar y solucionar el error base datos PrestaShop DirectAdmin. Abordaremos desde las causas más simples (como un cambio de contraseña) hasta las más técnicas (como la configuración del archivo settings.inc.php). Además, incluiremos una sección de preguntas frecuentes (FAQ) para resolver las dudas más habituales.

[INFO] Este artículo está pensado para usuarios sin experiencia técnica avanzada. Si puedes acceder a DirectAdmin y sabes leer un archivo de configuración, podrás seguir esta guía sin problemas.

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

Cuando PrestaShop intenta conectarse a tu base de datos MySQL (o MariaDB) y no lo consigue, muestra un mensaje de error. Este error puede aparecer en la tienda (frontend) o en el panel de administración (backend). Los síntomas más comunes son:

Página en blanco o con un mensaje como: "Cannot connect to the database".
Error de conexión al intentar acceder al back office.
Tablas ausentes o mensajes de que ciertas tablas no existen.
Errores 500 o de servidor.

La causa raíz suele ser una de estas tres:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado.
Problemas con el servidor MySQL: El servicio de base de datos está caído o no responde.
Configuración errónea en el archivo de PrestaShop: El archivo settings.inc.php (o parameters.php según la versión) contiene datos desactualizados.

Paso 1: Verifica el estado del servicio MySQL en DirectAdmin

Antes de tocar ningún archivo, asegúrate de que el motor de base de datos esté funcionando. En DirectAdmin, esto es muy sencillo.

### Cómo comprobar si MySQL/MariaDB está activo en DirectAdmin

Accede a tu panel de DirectAdmin con tu usuario y contraseña.
Busca la sección "Servicios del sistema" o "System Services". Suele estar en el menú lateral o en la parte inferior del panel.
Busca el servicio "MySQL" o "MariaDB" (depende de la versión). Debería aparecer como "Running" (en ejecución) o con un círculo verde.
Si aparece como "Stopped" (detenido) o con un círculo rojo, haz clic en el botón "Start" o "Reiniciar" para iniciarlo de nuevo.

[WARNING] Si el servicio no arranca, puede haber un problema más grave en el servidor. En ese caso, contacta con tu proveedor de hosting indicando que el servicio MySQL no se inicia en DirectAdmin.

Paso 2: Revisa las credenciales de tu base de datos en DirectAdmin

El error más común es que hayas cambiado la contraseña de la base de datos o que hayas creado una nueva y olvidado actualizar PrestaShop. Vamos a verificar las credenciales reales.

### Cómo encontrar el usuario y nombre de tu base de datos en DirectAdmin

En DirectAdmin, busca la sección "Administración de MySQL" o "MySQL Management".
Allí verás una lista de tus bases de datos. Cada una tendrá un nombre de base de datos y un usuario asociado (normalmente son similares, ej: miusuario_bd y miusuario_bd_user).
Anota exactamente el nombre de la base de datos y el usuario (tal cual aparecen, con mayúsculas/minúsculas).
Si no recuerdas la contraseña, puedes cambiarla desde el mismo panel. Haz clic en el icono de "Cambiar contraseña" (suele ser un candado o un lápiz). Elige una contraseña segura y anótala.

[TIP] Te recomiendo usar una contraseña con al menos 12 caracteres, combinando letras mayúsculas, minúsculas, números y símbolos. Por ejemplo: MiTi3nda#2024!.

Paso 3: Localiza y edita el archivo de configuración de PrestaShop

Ahora que tienes las credenciales correctas, debes actualizarlas en el archivo que PrestaShop usa para conectarse a la base de datos. Este archivo se llama settings.inc.php (en versiones antiguas) o parameters.php (en PrestaShop 1.7+).

### ¿Dónde está el archivo de configuración?

Dentro de la carpeta donde está instalado PrestaShop (normalmente public_html o www), busca la carpeta config. Allí encontrarás el archivo settings.inc.php o parameters.php.

### Cómo editarlo de forma segura

Accede al gestor de archivos de DirectAdmin (File Manager) o usa FTP (por ejemplo, FileZilla).
Navega hasta: tu_dominio/config/settings.inc.php (o parameters.php).
Descarga una copia de seguridad de este archivo antes de editarlo. Así, si algo sale mal, puedes restaurarlo.
Haz clic derecho sobre el archivo y selecciona "Editar" (o ábrelo con un editor de texto como Notepad++ o Sublime Text).
Busca las siguientes líneas (los nombres pueden variar ligeramente):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base_de_datos');
define('_DB_USER_', 'usuario_de_tu_base_de_datos');
define('_DB_PASSWD_', 'contraseña_de_tu_base_de_datos');

Reemplaza los valores con los que anotaste en el Paso 2. Presta especial atención a:
- _DB_SERVER_: Normalmente es localhost, pero si tu hosting usa un servidor remoto, te lo habrán indicado.
- _DB_NAME_: El nombre exacto de la base de datos.
- _DB_USER_: El nombre exacto del usuario.
- _DB_PASSWD_: La contraseña (sin espacios ni comillas adicionales).
Guarda el archivo y súbelo de nuevo al servidor (si lo editaste localmente) o simplemente cierra el editor si lo hiciste desde DirectAdmin.

[WARNING] No cambies ningún otro valor. No toques _DB_PREFIX_ ni _DB_TYPE_ a menos que sepas exactamente lo que haces.

Paso 4: Prueba la conexión desde phpMyAdmin (opcional pero recomendado)

Para asegurarte de que las credenciales son correctas, puedes probar la conexión manualmente desde phpMyAdmin (que suele estar disponible en DirectAdmin).

En DirectAdmin, busca "phpMyAdmin" o "MySQL phpMyAdmin".
Inicia sesión con el usuario y contraseña que acabas de configurar.
Si puedes acceder y ves las tablas de tu tienda (por ejemplo, ps_product, ps_orders, etc.), entonces las credenciales son correctas.
Si no puedes acceder, revisa de nuevo el Paso 2 y asegúrate de que el usuario tenga permisos sobre la base de datos (en DirectAdmin, al crear la base de datos, debes asignar el usuario a ella).

Paso 5: Verifica los permisos del usuario de la base de datos

A veces, el usuario tiene acceso pero no todos los permisos necesarios (como SELECT, INSERT, UPDATE, DELETE). PrestaShop necesita permisos completos.

### Cómo otorgar permisos completos desde DirectAdmin

En la sección "Administración de MySQL", busca la base de datos y haz clic en "Gestionar" o "Manage".
Busca la opción "Privilegios" o "Permissions".
Marca todas las casillas (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.) o selecciona "ALL PRIVILEGES".
Guarda los cambios.

Paso 6: Limpia la caché de PrestaShop

Después de cambiar la configuración, PrestaShop puede seguir mostrando el error porque tiene una caché antigua. Para forzar la actualización:

Desde el panel de administración (si puedes acceder): Ve a Parámetros de la tienda > Rendimiento y haz clic en "Limpiar caché".
Si no puedes acceder al back office: Borra manualmente la carpeta cache dentro de tu instalación de PrestaShop (en public_html/cache). No borres la carpeta entera, solo su contenido (archivos y subcarpetas). También puedes eliminar el archivo class_index.php dentro de cache.

[INFO] Al borrar la caché, PrestaShop leerá la nueva configuración del archivo settings.inc.php.

Paso 7: Comprueba los logs de error del servidor

Si a pesar de todo el error persiste, es hora de revisar los logs del servidor. DirectAdmin ofrece acceso a los registros de errores de Apache y MySQL.

### Cómo acceder a los logs en DirectAdmin

Busca la sección "Registros de errores" o "Error Logs".
Revisa el "Error log de Apache" y el "Error log de MySQL".
Busca líneas que contengan frases como "Access denied for user", "Can't connect to MySQL server" o "Table doesn't exist".
Copia el mensaje exacto y búscalo en Google o compártelo con tu soporte técnico.

Preguntas Frecuentes (FAQ)

### 1. ¿Qué hago si el archivo `settings.inc.php` no existe?

En versiones modernas de PrestaShop (1.7+), el archivo se llama parameters.php. Si no encuentras ninguno, es posible que tu instalación esté corrupta o que no se haya completado. En ese caso, deberías reinstalar PrestaShop o restaurar una copia de seguridad.

### 2. ¿Puedo usar un editor de texto online para modificar el archivo?

Sí, puedes usar el editor de texto integrado en el File Manager de DirectAdmin. Es seguro y no requiere descargar nada. Solo asegúrate de no dejar espacios en blanco al final del archivo.

### 3. ¿Por qué aparece el error después de migrar mi tienda a otro servidor?

Al migrar, las credenciales de la base de datos cambian. Debes actualizar el archivo settings.inc.php con los nuevos datos del nuevo servidor. Además, asegúrate de que la base de datos esté importada correctamente.

### 4. ¿Qué significa "Host 'mi-servidor' is not allowed to connect to this MySQL server"?

Esto ocurre cuando el servidor web (donde está PrestaShop) no tiene permiso para conectarse al servidor de base de datos. Si ambos están en el mismo servidor (localhost), suele ser un problema de configuración de MySQL. Contacta con tu proveedor de hosting.

### 5. ¿Cómo sé si mi base de datos está corrupta?

Si ves mensajes como "Table 'ps_product' doesn't exist" o "MySQL server has gone away", puede que la base de datos esté dañada. Puedes repararla desde phpMyAdmin: selecciona la base de datos, marca todas las tablas y en el menú desplegable elige "Reparar tabla".

### 6. ¿Qué pasa si uso Syspanel (antes HestiaCP)? ¿El proceso es el mismo?

Si tu panel de control es Syspanel (puerto 2106), el proceso es muy similar. La diferencia está en la interfaz, pero los pasos son equivalentes:

Busca la sección de Base de datos para ver las credenciales.
El archivo de configuración de PrestaShop sigue siendo settings.inc.php o parameters.php.
La herramienta para gestionar MySQL suele ser phpMyAdmin también.

[TIP] En Syspanel, el acceso a phpMyAdmin suele estar en la sección "Herramientas" o "Base de datos".

### 7. ¿Debo preocuparme si veo el error solo de vez en cuando?

Si el error aparece intermitentemente, puede deberse a que el servidor de base de datos está sobrecargado o se reinicia. En ese caso, contacta a tu hosting para que revisen el rendimiento del servidor MySQL.

Conclusión

El error de conexión a la base de datos en PrestaShop en un entorno DirectAdmin suele tener solución en pocos minutos si sigues estos pasos de manera ordenada. Recuerda:

Verifica que MySQL esté funcionando.
Comprueba las credenciales en DirectAdmin.
Actualiza el archivo settings.inc.php con los datos correctos.
Limpia la caché.
Revisa los logs si el error persiste.

Y si todo falla, no dudes en pedir ayuda a tu proveedor de hosting. La mayoría de los errores de conexión se deben a cambios accidentales en las contraseñas o a problemas temporales del servidor.

[INFO] Guarda siempre una copia de seguridad de tu base de datos y de los archivos de configuración. Así podrás restaurar tu tienda rápidamente ante cualquier imprevisto.

¡Esperamos que esta guía te haya sido de ayuda! Si tienes más dudas, déjalas en los comentarios o contacta con nuestro equipo de soporte.