Solucionar error de conexión a base de datos en PrestaShop (2024)

[INFO] Si estás leyendo esto, probablemente te hayas encontrado con una pantalla de error en tu tienda PrestaShop que te impide acceder tanto al panel de administración como a la tienda online. No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en servidores. En esta guía completa, vamos a desglosar paso a paso cómo arreglar el error PrestaShop no conecta base de datos en los tres paneles de control más utilizados: Plesk, cPanel y DirectAdmin. Al final, tendrás un plan de acción claro para diagnosticar y resolver el problema de la conexión BD PrestaShop.

¿Por qué aparece el error "PrestaShop no se conecta a la base de datos"?

Antes de lanzarnos a arreglar nada, es fundamental entender qué significa este mensaje. PrestaShop es un software que necesita dos cosas para funcionar: los archivos del programa (PHP, plantillas, etc.) y una base de datos MySQL donde guarda todos los productos, pedidos, clientes y configuración. Cuando ves el error de conexión, significa que PrestaShop no puede comunicarse con esa base de datos. Las causas más habituales son:

Credenciales incorrectas: Los datos de acceso (usuario, contraseña, nombre de la BD) en el archivo de configuración no coinciden con los del servidor.
Servidor de base de datos caído: El servicio MySQL/MariaDB se ha detenido o está sobrecargado.
Cambios en el hosting: Has migrado de servidor, cambiado la contraseña de la BD, o el proveedor ha modificado los parámetros de conexión.
Permisos de usuario: El usuario de la base de datos no tiene permisos suficientes para acceder a la BD.
Archivo de configuración corrupto: El archivo parameters.php está dañado o tiene errores de sintaxis.
Problemas de IP o host: En algunos paneles, el acceso a la BD está restringido a ciertas IPs (por ejemplo, solo localhost).

Vamos a atacar el problema desde el diagnóstico inicial hasta la solución definitiva, adaptando los pasos para cada panel.

Fase 0: Preparación y diagnóstico inicial (Aplica para todos)

Antes de tocar nada, necesitas acceso a tu panel de control de hosting y a un gestor de archivos (o FTP). Te recomiendo tener a mano la información de tu base de datos: el nombre de la BD, el usuario y la contraseña. Si no la tienes, la encontrarás en tu panel de control.

1. Verificar el estado del servidor de base de datos

Esto es lo primero. No tiene sentido cambiar contraseñas si el servicio está caído.

Accede a tu panel de control (Plesk, cPanel o DirectAdmin).
Busca la sección de "Base de Datos MySQL" o "MySQL Server".
Deberías ver un indicador de estado. Si dice "En ejecución" o "Running", el servidor está bien. Si dice "Detenido" o "Stopped", intenta iniciarlo con el botón correspondiente.

[WARNING] Si el servidor de BD se reinicia constantemente, es un síntoma de falta de recursos (memoria) en tu plan de hosting. Deberías contactar con tu proveedor, ya que no es algo que se arregle desde el panel.

2. Localizar el archivo de configuración de PrestaShop

El archivo que guarda los datos de conexión se llama parameters.php y se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Normalmente, la ruta completa es /public_html/app/config/parameters.php (o /httpdocs/app/config/parameters.php en Plesk).

Accede a tu gestor de archivos (File Manager) desde el panel de control y navega hasta esa ruta. Abre el archivo con un editor de texto (no lo descargues, edítalo directamente). Verás un contenido similar a este:

return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'tu_basededatos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        // ... más parámetros
    ],
];

Compara estos datos con los de tu panel. Si no coinciden, ese es tu problema. Anota los valores correctos y continúa con la sección correspondiente a tu panel para actualizarlos.

Cómo arreglar el error en Plesk

Plesk es un panel muy común en servidores VPS y dedicados. Su estructura es ligeramente distinta a cPanel.

Paso 1: Obtener las credenciales correctas de la base de datos

En el panel de Plesk, ve a "Bases de datos" (o "Databases").
Localiza la base de datos que usa tu PrestaShop. El nombre suele ser similar al nombre de tu dominio o usuario.
Haz clic en el nombre de la BD. Verás la información del servidor (normalmente localhost).
Para ver o cambiar la contraseña del usuario, ve a la pestaña "Usuarios".
Si no recuerdas la contraseña, puedes crear una nueva. Plesk te permite "Cambiar contraseña" directamente. Anótala.

Paso 2: Actualizar el archivo parameters.php

Ahora que tienes los datos correctos:

Vuelve al Administrador de archivos de Plesk (normalmente en la sección "Archivos" o "File Manager").
Navega a httpdocs/app/config/ (en Plesk, la raíz del sitio suele ser httpdocs).
Edita parameters.php y reemplaza 'database_user', 'database_password' y 'database_name' con los datos que acabas de obtener.

[TIP] Asegúrate de que 'database_host' sea 'localhost' a menos que tu proveedor te indique lo contrario. En Plesk, casi siempre es localhost.

Paso 3: Verificar la conexión desde la base de datos

Plesk tiene una herramienta llamada "phpMyAdmin". Puedes acceder a ella desde la sección de "Bases de datos". Si puedes entrar con el usuario y contraseña que has configurado, la conexión es correcta. Si no, hay un problema con los permisos o la contraseña.

Cómo arreglar el error en cPanel

cPanel es el panel más popular en el hosting compartido. El proceso es muy similar, pero la interfaz cambia.

Paso 1: Gestionar las bases de datos MySQL

En cPanel, busca la sección "Bases de datos" y haz clic en "Bases de datos MySQL".
Verás una lista de todas tus bases de datos y usuarios.
Localiza la BD de tu PrestaShop y el usuario asociado.

Paso 2: Revisar y actualizar credenciales

Si no sabes la contraseña, puedes cambiarla. En la lista de usuarios, verás un botón para "Cambiar contraseña". Hazlo y anota la nueva.
Asegúrate de que el usuario esté asociado a la base de datos correcta. En la sección "Añadir usuario a la base de datos", verifica que el usuario aparece en la lista de la BD. Si no, añádelo y otórgale TODOS LOS PRIVILEGIOS (aunque para funcionar solo necesita SELECT, INSERT, UPDATE, DELETE, pero por simplicidad, marcar todos no da problemas).

Paso 3: Editar parameters.php desde el Administrador de archivos

Ve a "Administrador de archivos" en cPanel.
Navega a public_html/app/config/.
Edita parameters.php con los nuevos datos (usuario, contraseña, nombre de BD). El host casi siempre es localhost.

Paso 4: Probar con phpMyAdmin

cPanel también tiene phpMyAdmin en la sección de bases de datos. Intenta entrar con las nuevas credenciales. Si lo consigues, el problema está resuelto. Si no, revisa que el usuario tiene permisos.

[INFO] En cPanel, a veces el nombre de la base de datos y el usuario tienen un prefijo con el nombre de tu cuenta (ej: usuario_bd). Es crucial que en parameters.php pongas el nombre completo, incluyendo ese prefijo.

Cómo arreglar el error en DirectAdmin

DirectAdmin es otro panel potente, muy usado en servidores dedicados. El proceso es igual de sencillo.

Paso 1: Acceder a la gestión de MySQL

En DirectAdmin, busca la sección "Gestión de MySQL" (o "MySQL Management").
Verás tus bases de datos y usuarios. DirectAdmin suele mostrar el nombre de la BD y el usuario asociado.

Paso 2: Cambiar contraseña y permisos

Haz clic en el icono de "Cambiar contraseña" junto al usuario que usa PrestaShop.
DirectAdmin no tiene una interfaz tan gráfica para permisos como cPanel, pero por defecto, si el usuario está asociado a la BD, tiene todos los permisos. Asegúrate de que el usuario esté en la lista de "Usuarios" de esa BD.

Paso 3: Editar la configuración

Entra al "Administrador de archivos" de DirectAdmin.
La ruta raíz de tu sitio suele ser domains/tudominio.com/public_html/.
Navega a app/config/ y edita parameters.php con los datos correctos.

Paso 4: Uso de phpMyAdmin

DirectAdmin integra phpMyAdmin. Accede desde el panel (normalmente un botón que dice "phpMyAdmin"). Si la conexión con las nuevas credenciales es exitosa, todo está correcto.

Solución avanzada: ¿Y si las credenciales son correctas y sigue fallando?

Si ya has verificado que el usuario, la contraseña y el nombre de la BD son correctos y coinciden con parameters.php, pero el error persiste, el problema puede estar en otro lugar.

1. El problema del "host" de la base de datos

En algunos hostings, especialmente en Plesk o DirectAdmin, el host de la BD no es localhost, sino algo como localhost con un puerto específico o un nombre de servidor interno (ej: mysql.tudominio.com). Revisa la información de tu panel. En Plesk, a veces se usa 127.0.0.1 en lugar de localhost. Prueba a cambiar 'database_host' a 127.0.0.1.

2. El puerto de conexión

Algunos servidores usan puertos no estándar (ej: 3307 en lugar de 3306). Si tu proveedor te ha dado un puerto específico, añádelo en 'database_port' en parameters.php.

3. Limpiar la caché de PrestaShop

A veces, PrestaShop guarda una caché de la configuración. Si has editado parameters.php, pero la caché no se ha actualizado, el error persiste.

Conéctate por FTP o usa el Administrador de archivos.
Elimina el contenido de la carpeta var/cache/ (o var/cache/prod/ y var/cache/dev/ en versiones más nuevas). No borres la carpeta en sí, solo su contenido.

[WARNING] Si no puedes acceder al panel de administración, esta es la única forma de limpiar la caché. Si el problema es de conexión, esta acción no lo arreglará, pero es un paso necesario después de cualquier cambio en la configuración.

4. Comprobar el archivo .htaccess

Un archivo .htaccess corrupto puede redirigir o bloquear la conexión a la BD de forma indirecta. Renombra el archivo .htaccess en la raíz de tu PrestaShop a .htaccess.bak temporalmente. Si la tienda carga (aunque sea sin URLs amigables), el problema era ese. Luego, regenera el archivo desde el panel de administración de PrestaShop.

5. El problema de la "IP remota" en MySQL

En servidores más avanzados, los usuarios de MySQL se definen con un host específico. Por ejemplo, un usuario puede tener acceso solo desde localhost y otro desde % (cualquier host). Si tu panel te permite ver esto (a veces solo en Plesk), asegúrate de que el usuario tiene permitido el acceso desde localhost o desde la IP de tu servidor.

PrestaShop no conecta base de datos: Preguntas Frecuentes (FAQ)

P: He cambiado la contraseña de la BD, pero ahora no puedo entrar a mi tienda. ¿Qué hago?
R: Has cambiado la contraseña en el panel, pero no en el archivo parameters.php. Debes actualizar la contraseña en app/config/parameters.php con la nueva que has configurado. Es el error más común.

P: ¿Puedo usar el mismo usuario para dos bases de datos diferentes?
R: Sí, puedes, pero no es recomendable. Si un usuario tiene acceso a dos BD, un error en una podría comprometer la otra. Lo ideal es un usuario por BD.

P: Mi hosting usa "Syspanel" en lugar de cPanel. ¿Cómo lo arreglo?
R: Si tu proveedor usa Syspanel (anteriormente conocido como HestiaCP), el acceso se realiza a través del puerto 2106 (ej: https://tudominio.com:2106). Una vez dentro, el proceso es muy similar a DirectAdmin. Busca la sección de "Bases de datos" o "MySQL". Las credenciales y la estructura de archivos (en public_html) son las mismas. El puerto de acceso al panel es 2106, pero el de la base de datos seguirá siendo el estándar (3306) o el que te indique tu proveedor.

P: El error dice "El servidor de la base de datos no está disponible". ¿Es un problema mío?
R: No siempre. Puede ser un problema del servidor (caída del servicio MySQL). Revisa el estado en tu panel. Si el servicio está activo, el problema es de configuración. Si está inactivo, contacta con tu proveedor de hosting.

P: He migrado mi tienda a un nuevo hosting y ahora no funciona.
R: Al migrar, las credenciales de la BD suelen cambiar. Es casi seguro que necesites actualizar el parameters.php con los datos del nuevo hosting. Asegúrate de importar la base de datos correctamente en el nuevo servidor antes de intentar conectar.

P: ¿Cómo sé si mi base de datos está corrupta?
R: Si el error es de "conexión", no de "corrupción", el problema es de acceso. Si PrestaShop se conecta pero muestra errores de tablas, entonces el problema es de corrupción. Para eso, puedes usar phpMyAdmin y ejecutar "REPARAR TABLAS".

Conclusión: Resumen de la solución

Para arreglar el error de conexión BD PrestaShop, sigue esta lista de verificación mental:

¿Está el servicio MySQL activo? (Revisa en el panel).
¿Coinciden las credenciales en parameters.php con las del panel? (Revisa usuario, contraseña y nombre de BD, incluyendo prefijos).
¿El host es correcto? (localhost o 127.0.0.1).
¿El usuario tiene permisos sobre la BD? (Revisa en la sección de usuarios de la BD).
¿Has limpiado la caché de PrestaShop? (Elimina el contenido de var/cache/).

Siguiendo estos pasos, resolverás el problema en el 95% de los casos. Recuerda que la paciencia es clave. No tengas miedo de explorar los paneles de control; son herramientas diseñadas para que puedas gestionar tus servicios, y con esta guía, ya tienes el conocimiento para hacerlo. Si después de todo esto el error persiste, no dudes en contactar con el soporte técnico de tu hosting, proporcionándoles el mensaje de error exacto y los pasos que ya has seguido. ¡Buena suerte con tu tienda!