Solucionar problemas de base de datos en PrestaShop en DirectAdmin

¿Tu tienda PrestaShop se ha quedado en blanco o muestra un mensaje de error como “Error de conexión a la base de datos” o “Unable to connect to database server”? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución.

En esta guía completa, te explicaré paso a paso cómo diagnosticar y solucionar los errores de conexión a la base de datos PrestaShop desde tu panel de DirectAdmin. Incluso si no eres un experto técnico, podrás seguir estas instrucciones y recuperar tu tienda en pocos minutos.

Vamos a empezar por lo básico: entender qué significa este error y por qué ocurre.

¿Qué significa “Error de conexión a la base de datos” en PrestaShop?

Cuando PrestaShop no puede comunicarse con la base de datos donde guarda todos tus productos, clientes, pedidos y configuraciones, muestra un error de conexión. Esto puede ocurrir por varias razones, desde un cambio de contraseña hasta un fallo en el servidor.

Los síntomas más habituales son:

La tienda se muestra completamente en blanco (pantalla blanca).
Aparece un mensaje como “Error de conexión a la base de datos” o “Unable to connect to database server”.
El panel de administración (back office) también deja de funcionar.

[INFO]: No te asustes si ves esto. En la mayoría de los casos, tu información sigue intacta en la base de datos. Solo necesitas restablecer la conexión.

Antes de empezar: Prepara la información que necesitarás

Para solucionar el error, vas a necesitar los datos de acceso a tu base de datos. Si los tienes a mano, el proceso será mucho más rápido. Anota o copia lo siguiente:

Nombre de la base de datos (ejemplo: usuario_tienda).
Usuario de la base de datos (ejemplo: usuario_db).
Contraseña de la base de datos.
Host de la base de datos (normalmente localhost o 127.0.0.1).

Si no recuerdas alguno de estos datos, no te preocupes. Te mostraré cómo obtenerlos desde DirectAdmin.

Paso 1: Accede a DirectAdmin y localiza tu base de datos

DirectAdmin es el panel de control de tu hosting. Desde aquí podrás gestionar todos los recursos de tu sitio, incluyendo las bases de datos.

Abre tu navegador y escribe la URL de acceso a DirectAdmin. Normalmente es algo como https://tudominio.com:2222 o la IP de tu servidor seguida de :2222.
Inicia sesión con tu usuario y contraseña de hosting.

Una vez dentro, busca la sección “Administrador de bases de datos” o “MySQL Management”. Dependiendo de la versión de DirectAdmin, puede estar en un menú lateral o en la página principal.

[TIP]: Si no ves la opción directamente, escribe en el buscador interno de DirectAdmin “MySQL” y te llevará a la sección correcta.

Paso 2: Verifica que la base de datos existe y tiene el usuario correcto

En la sección de bases de datos, verás una lista con todas las bases que tienes creadas. Busca la que corresponde a tu PrestaShop (normalmente tiene el nombre de tu dominio o un nombre similar).

Haz clic en el nombre de la base de datos o en el icono de administración (a veces es un lápiz o un engranaje). Se abrirá una ventana con detalles importantes:

Nombre de la base de datos: asegúrate de que coincide con el que usa PrestaShop.
Usuario asignado: debe haber al menos un usuario con permisos completos sobre esa base.
Contraseña: si no la recuerdas, puedes generar una nueva desde aquí mismo (te explicaré cómo más adelante).

[WARNING]: Si la base de datos no aparece en la lista, es posible que la hayan eliminado accidentalmente. En ese caso, necesitarás restaurar una copia de seguridad. Si no tienes copia, contacta con tu proveedor de hosting inmediatamente.

Paso 3: Comprueba el archivo de configuración de PrestaShop (settings.inc.php)

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado settings.inc.php. Este archivo está en la carpeta config de tu instalación de PrestaShop.

Para acceder a él, necesitas un gestor de archivos (como el que incluye DirectAdmin) o un cliente FTP.

En DirectAdmin, busca la sección “Administrador de archivos” o “File Manager”.
Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o domains/tudominio.com/public_html).
Dentro de esa carpeta, abre la carpeta config.
Busca el archivo settings.inc.php y haz clic derecho para editarlo (o selecciona “Edit”).

Dentro del archivo, busca las siguientes líneas (normalmente al principio):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_base_datos');

Verifica que estos valores coincidan exactamente con los que tienes en DirectAdmin. Los errores más comunes son:

Host incorrecto: a veces no es localhost, sino la IP del servidor o un nombre como mysql.tudominio.com.
Nombre de base de datos mal escrito: recuerda que en DirectAdmin suele llevar un prefijo con tu usuario (ejemplo: usuario_nombrebd).
Usuario o contraseña equivocados: asegúrate de que no haya espacios al copiar y pegar.

[TIP]: Si no estás seguro del host, prueba primero con localhost. Si no funciona, pregúntale a tu proveedor de hosting cuál es el host de base de datos correcto.

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

A veces el usuario existe, pero no tiene permisos suficientes para conectarse desde el servidor web. Para solucionarlo:

En DirectAdmin, ve a la sección de bases de datos y selecciona la base de datos problemática.
Busca la opción “Administrar usuarios” o “Privilegios”.
Asegúrate de que el usuario tiene marcados todos los permisos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Lo más seguro es seleccionar “Todos los privilegios”.

[INFO]: Si no ves cómo cambiar permisos, puedes eliminar el usuario y volver a asignarlo a la base de datos con todos los privilegios. DirectAdmin te guiará en el proceso.

Paso 5: Prueba la conexión manualmente con phpMyAdmin

Dentro de DirectAdmin, suele haber una herramienta llamada phpMyAdmin que te permite acceder directamente a tus bases de datos. Esto te ayudará a confirmar si el problema es de configuración o de la base de datos en sí.

En DirectAdmin, busca el icono de phpMyAdmin (normalmente en la sección de bases de datos).
Inicia sesión con el usuario y contraseña de la base de datos (los mismos que pusiste en settings.inc.php).

Si puedes entrar y ver las tablas de PrestaShop (como ps_product, ps_customer, etc.), entonces la base de datos funciona correctamente y el error está en el archivo de configuración o en el host.

Si no puedes entrar, el problema está en los datos de acceso (usuario, contraseña o permisos). Vuelve al Paso 3 y verifica todo de nuevo.

[WARNING]: Si phpMyAdmin te da error de “acceso denegado”, significa que la contraseña o el usuario son incorrectos. Puedes restablecer la contraseña desde DirectAdmin (hay una opción “Cambiar contraseña” en la sección de bases de datos).

Paso 6: Restablece la contraseña de la base de datos desde DirectAdmin

Si has olvidado la contraseña o sospechas que está mal, lo mejor es generar una nueva. Sigue estos pasos:

En DirectAdmin, ve a la sección “Administrador de bases de datos”.
Haz clic en el nombre de la base de datos.
Busca la opción “Cambiar contraseña” (o “Change password”).
Introduce una nueva contraseña segura (puedes usar el generador que ofrece DirectAdmin).
Guarda los cambios.

Ahora, actualiza la contraseña en el archivo settings.inc.php de PrestaShop (Paso 3) con la nueva contraseña.

[TIP]: Anota la nueva contraseña en un lugar seguro. Si vuelves a olvidarla, tendrás que repetir este proceso.

Paso 7: Verifica que el servidor MySQL esté funcionando

A veces el problema no está en tu configuración, sino en el servidor de bases de datos. Si el servicio MySQL se ha detenido o ha fallado, ninguna aplicación podrá conectarse.

Si tienes acceso a Syspanel (anteriormente conocido como HestiaCP), recuerda que el puerto de acceso es el 2106. Desde allí puedes verificar el estado de los servicios.

Pero si solo usas DirectAdmin, puedes hacer una comprobación rápida:

Intenta acceder a phpMyAdmin (Paso 5). Si no carga o da error de conexión al servidor MySQL, es probable que el servicio esté caído.
Contacta con tu proveedor de hosting y diles que “el servicio MySQL no responde”. Ellos lo reiniciarán en pocos minutos.

[INFO]: En la mayoría de los hostings compartidos, el servicio MySQL se reinicia automáticamente, pero a veces necesita una intervención manual.

Paso 8: Comprueba el límite de conexiones simultáneas

Si tu tienda recibe mucho tráfico, es posible que el servidor MySQL haya alcanzado su límite de conexiones simultáneas. Esto provoca errores de conexión intermitentes.

Para solucionarlo:

Si tu plan de hosting lo permite, aumenta el límite de conexiones desde la configuración de MySQL en DirectAdmin (no siempre está disponible).
Si no puedes modificarlo, contacta con tu proveedor y explícale que necesitas aumentar el max_connections.

Mientras tanto, puedes reducir la carga desactivando temporalmente módulos que hagan muchas consultas a la base de datos (como motores de búsqueda avanzados o estadísticas en tiempo real).

Paso 9: Revisa los logs de error de PrestaShop

PrestaShop guarda registros de errores que pueden darte pistas adicionales. Para acceder a ellos:

Desde el back office de PrestaShop (si puedes acceder), ve a Parámetros avanzados > Registros.
Si no puedes acceder al back office, revisa la carpeta log dentro de la instalación de PrestaShop (en public_html/log/). Allí encontrarás archivos con nombres como error.log o fatal.log.

Busca entradas que contengan “database” o “MySQL”. Te dirán exactamente qué está fallando (por ejemplo, “Table ‘ps_product’ doesn’t exist” o “Access denied for user”).

[TIP]: Si el log está muy grande, puedes descargarlo y buscar palabras clave como “error”, “database” o “connect”.

Paso 10: Restaura una copia de seguridad de la base de datos (si es necesario)

Si después de todos los pasos anteriores el error persiste, es posible que la base de datos esté corrupta. En ese caso, la solución más rápida es restaurar una copia de seguridad reciente.

En DirectAdmin, ve a la sección “Copias de seguridad” o “Backups”.
Busca una copia de seguridad de tu base de datos (suelen tener extensión .sql o .gz).
Selecciona la opción de restaurar y elige la base de datos correcta.

Si no tienes copias de seguridad automáticas, contacta con tu proveedor de hosting. Algunos guardan copias durante unos días.

[WARNING]: Restaurar una copia de seguridad sobrescribirá todos los datos actuales. Asegúrate de que sea una copia reciente para no perder pedidos o clientes nuevos.

Preguntas frecuentes (FAQ)

¿Qué hago si no encuentro el archivo settings.inc.php?

Puede que tu versión de PrestaShop use un archivo diferente. Busca parameters.php o app/config/parameters.php. Los valores de conexión son los mismos, solo cambia el nombre del archivo.

¿Por qué mi base de datos aparece como “usuario_nombre” y no solo “nombre”?

En la mayoría de los hostings compartidos, las bases de datos llevan un prefijo con el nombre de usuario para evitar conflictos. Asegúrate de incluir ese prefijo completo en settings.inc.php.

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

Sí, algunos módulos mal configurados pueden saturar la base de datos. Si el error apareció después de instalar un módulo, desactívalo desde el back office o renombra su carpeta en public_html/modules/ para forzar su desactivación.

¿Necesito reiniciar algo después de cambiar la contraseña?

No, los cambios en settings.inc.php se aplican inmediatamente. Solo guarda el archivo y recarga tu tienda.

¿Qué significa “Host ‘mi-servidor’ is not allowed to connect to this MySQL server”?

Significa que el usuario de la base de datos no tiene permiso para conectarse desde el servidor web. En DirectAdmin, asegúrate de que el host permitido sea localhost o % (todos los hosts). Si no sabes cómo cambiarlo, pide ayuda a tu proveedor.

Resumen final

Los errores de conexión a la base de datos PrestaShop en DirectAdmin suelen resolverse verificando cuatro puntos clave:

Datos correctos en settings.inc.php (nombre, usuario, contraseña y host).
Usuario con permisos totales sobre la base de datos.
Servicio MySQL funcionando (si no, contacta al hosting).
Contraseña actualizada si hay dudas.

Si has seguido todos los pasos de esta guía y el error persiste, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo al servidor y podrán revisar logs más profundos.

Recuerda: la paciencia es clave. Tómate tu tiempo para verificar cada detalle y, sobre todo, siempre mantén copias de seguridad actualizadas. Así, cualquier problema de base de datos será solo un pequeño contratiempo.

¡Espero que esta guía te haya sido de gran ayuda! Ahora ya sabes cómo solucionar error de conexión en PrestaShop como todo un profesional.