Corregir error de conexión a base de datos en PrestaShop (DirectAdmin)

¿Por qué PrestaShop muestra "No se puede conectar a la base de datos" en DirectAdmin?

Este es uno de los errores más comunes y frustrantes para cualquier persona que gestione una tienda online con PrestaShop. Ver ese mensaje en la pantalla de tu tienda, o en el panel de administración, puede generar mucha preocupación, sobre todo si no tienes experiencia técnica avanzada.

La buena noticia es que, en la gran mayoría de los casos, este error tiene una solución clara y sencilla. No significa que hayas perdido tus productos, tus clientes o tus pedidos. Simplemente indica que PrestaShop no puede comunicarse con el servidor de bases de datos MySQL, que es donde se almacena toda la información de tu tienda.

En este artículo, vamos a desglosar paso a paso, y en un lenguaje muy claro, todas las posibles causas y soluciones para el error base de datos prestashop directadmin. Olvídate del pánico; vamos a arreglarlo juntos. Aprenderás a diagnosticar el problema y a aplicar la solución correcta, incluso si es la primera vez que te enfrentas a un fallo de este tipo.

Primeros Pasos: Diagnóstico Inicial y Verificaciones Rápidas

Antes de lanzarnos a modificar archivos o configuraciones, es fundamental hacer un diagnóstico tranquilo. Muchas veces, la solución es más simple de lo que parece. Vamos a empezar por lo básico para descartar problemas menores.

1. Comprueba si el problema es general o solo de tu tienda

Lo primero que debes hacer es ver si otras páginas web en tu mismo servidor (si tienes más de una) funcionan correctamente. Si todas las webs están caídas o muestran errores de conexión, el problema es del servidor y no de tu PrestaShop.

En ese caso, deberías contactar con tu proveedor de hosting inmediatamente. Si solo tu tienda PrestaShop tiene el problema, entonces el fallo está en la configuración de tu tienda o en su base de datos, y podemos continuar con los siguientes pasos.

2. Revisa si tu dominio apunta correctamente a tu hosting

A veces, el problema no es la base de datos, sino que el dominio no está apuntando al servidor correcto. Si recientemente cambiaste de hosting o de plan, es posible que los registros DNS aún no se hayan actualizado. Puedes comprobarlo accediendo a tu dominio desde un dispositivo diferente o usando herramientas online de "DNS Checker".

3. Accede a tu panel de control DirectAdmin

Para la mayoría de las soluciones de este artículo, necesitarás acceder a tu panel de control de hosting, que en este caso es DirectAdmin. Es la interfaz desde la que gestionas tus dominios, bases de datos y archivos. Normalmente accedes a través de una URL como tudominio.com:2222 o panel.tudominio.com. Ten a mano tu usuario y contraseña, ya que los necesitaremos constantemente.

Solucionar error PrestaShop: La Configuración del Archivo parameters.php

La causa más común de la conexión fallida prestashop es que los datos de acceso a la base de datos en el archivo de configuración de PrestaShop sean incorrectos. Este archivo se llama parameters.php y se encuentra en la carpeta app/config de tu instalación de PrestaShop.

Este archivo contiene las credenciales que tu tienda utiliza para conectarse a MySQL. Si estos datos no coinciden exactamente con los que creaste en DirectAdmin, el error aparecerá de inmediato.

Cómo editar el archivo parameters.php de forma segura

Vamos a ver cómo revisar y corregir este archivo. Sigue estos pasos con calma:

Accede al Administrador de Archivos de DirectAdmin: Dentro de tu panel, busca la sección "Administrador de Archivos" o "File Manager". Se encuentra normalmente en la sección "Administración de archivos" o similar.
Navega hasta la carpeta de tu tienda: Entra en la carpeta donde está instalado tu PrestaShop. Normalmente es public_html o una subcarpeta dentro de esta, como public_html/tienda o public_html/prestashop.
Localiza el archivo: Dentro de la raíz de tu PrestaShop, entra en la carpeta app y luego en config. Busca el archivo llamado parameters.php.
Edita el archivo: Haz clic derecho sobre el archivo y selecciona "Editar" o "Edit". Se abrirá un editor de texto en la misma ventana del navegador.
Revisa los valores de la conexión: Busca el bloque que se llama 'database_host', 'database_name', 'database_user' y 'database_password'. Deben tener un aspecto similar a este:

'database_host' => 'localhost',
'database_name' => 'tu_usuario_prestashop',
'database_user' => 'tu_usuario_prestashop',
'database_password' => 'tu_contraseña_secreta',

database_host: Este valor casi siempre es localhost o 127.0.0.1. A menos que tu hosting te indique un servidor de bases de datos remoto (algo poco común en planes básicos), déjalo como localhost.
database_name: El nombre exacto de tu base de datos. En DirectAdmin, suele tener un prefijo con el nombre de tu usuario, por ejemplo, usuariodb_prestashop.
database_user: El nombre de usuario de la base de datos. También suele tener un prefijo similar al nombre de la base de datos.
database_password: La contraseña que asignaste a ese usuario de la base de datos.

[!WARNING]
Este es un punto crítico. Si has cambiado recientemente la contraseña de tu base de datos desde DirectAdmin, debes actualizarla aquí también. Un error muy común es cambiar la contraseña en el panel y olvidar actualizarla en este archivo.

Guarda los cambios: Una vez que hayas verificado que todos los datos son correctos, guarda el archivo. Vuelve a cargar tu tienda para ver si el error ha desaparecido.

¿Y si el archivo no existe o está corrupto?

Si no encuentras el archivo parameters.php, puede que tu instalación de PrestaShop esté dañada o incompleta. En este caso, la solución más segura es restaurar una copia de seguridad reciente de tu tienda. Si no tienes una copia, puedes intentar reemplazar el archivo con uno nuevo desde un paquete de instalación limpio de la misma versión de PrestaShop, pero esto es más avanzado.

PrestaShop DirectAdmin Error MySQL: Verificar la Base de Datos en DirectAdmin

Otra causa muy frecuente de este error es que la base de datos en sí tenga un problema, o que los permisos del usuario no sean los correctos. Vamos a revisar esto desde el panel de DirectAdmin.

1. Comprueba que la base de datos existe

En tu panel de DirectAdmin, busca la sección "Gestión de Bases de Datos" o "MySQL Management". Aquí verás una lista de todas las bases de datos que has creado.

Verifica que el nombre de la base de datos que aparece en tu archivo parameters.php existe en esta lista.
Si no existe, tendrás que crearla. Anota el nombre, el usuario y la contraseña que uses, ya que luego deberás actualizar el archivo parameters.php.

2. Verifica que el usuario tiene acceso a la base de datos

DirectAdmin te permite gestionar qué usuarios tienen acceso a cada base de datos. En la sección de gestión de MySQL, deberías poder ver qué usuarios están vinculados a tu base de datos.

Asegúrate de que el usuario database_user que configuraste en el archivo parameters.php tiene permisos sobre la base de datos database_name.
Si no aparece, tendrás que añadirlo y otorgarle "TODOS LOS PRIVILEGIOS" (ALL PRIVILEGES).

3. Prueba la conexión manualmente con phpMyAdmin

Esta es una prueba muy útil para saber si el problema es de credenciales o de otra cosa.

En DirectAdmin, busca el acceso a phpMyAdmin (suele estar dentro de la sección de MySQL).
Accede con el usuario y contraseña de tu base de datos (los mismos que pusiste en parameters.php).
Si logras entrar y ves tus tablas (las de PrestaShop), significa que las credenciales son correctas y el problema está en otro lugar.
Si no puedes entrar, te mostrará un error de acceso. Ahí sabrás que el problema es de credenciales o de permisos, y deberás corregirlos en DirectAdmin.

[!INFO]
Recuerda: El nombre de usuario de la base de datos y el nombre de la base de datos en DirectAdmin a menudo comparten el prefijo de tu cuenta de hosting, pero son dos entidades diferentes. Asegúrate de usar el nombre de usuario correcto, no el nombre de la base de datos.

Soluciones Avanzadas: Servidor, Puertos y Permisos de Archivos

Si has verificado las credenciales y la base de datos existe y es accesible, pero el error persiste, el problema puede residir en la configuración del servidor o en los permisos de los archivos de tu instalación.

1. El servidor MySQL no está funcionando

A veces, el servicio de MySQL en el servidor se detiene o se reinicia. Esto es algo que no puedes controlar desde tu panel de usuario básico, pero puedes comprobarlo indirectamente.

Intenta acceder a phpMyAdmin desde DirectAdmin. Si no puedes acceder ni siquiera con las credenciales correctas, es muy probable que el servicio MySQL esté caído.
En este caso, deberás contactar con tu proveedor de hosting y notificarles el problema. Es un fallo del servidor que ellos deben solucionar.

2. El puerto de conexión a MySQL es incorrecto

En la mayoría de los servidores compartidos, el puerto por defecto es el 3306. Sin embargo, algunos servidores utilizan puertos personalizados por razones de seguridad. Si tu hosting usa un puerto diferente, deberás especificarlo en el archivo parameters.php.

Puedes encontrar el puerto correcto en la documentación de tu hosting o preguntando al soporte. Si es diferente, modifica la línea 'database_port' => '3306', con el puerto correcto.

3. Permisos de archivos y carpetas incorrectos

PrestaShop necesita tener permisos específicos en sus archivos y carpetas para funcionar correctamente. Si estos permisos se han cambiado, puede provocar errores extraños, incluido el de conexión a la base de datos.

Carpetas (directorios) deben tener permisos 755.
Archivos deben tener permisos 644.

Puedes cambiar estos permisos desde el Administrador de Archivos de DirectAdmin. Selecciona todos los archivos y carpetas de tu instalación de PrestaShop y cambia sus permisos a los valores indicados. Es un proceso que puede tardar unos minutos si tienes muchos archivos.

[!WARNING]
Ten cuidado con el archivo parameters.php. Asegúrate de que después de cambiarlo, sus permisos sean 644. Si lo dejas con permisos 777, puede suponer un riesgo de seguridad.

4. El problema de los límites de memoria de PHP

Aunque es menos común, un límite de memoria de PHP demasiado bajo puede causar errores de conexión a la base de datos, especialmente si tu tienda es grande o tiene muchos módulos. Puedes aumentar el límite de memoria de PHP desde la sección "Configuración de PHP" o "PHP Settings" en DirectAdmin.

Busca la opción memory_limit y cámbiala a 256M o incluso 512M. Guarda los cambios y prueba de nuevo.

Prevención y Buenas Prácticas para Evitar Futuros Errores

Una vez que hayas solucionado el problema, es esencial que tomes medidas para evitar que vuelva a ocurrir en el futuro. La prevención es la mejor herramienta.

Realiza copias de seguridad periódicas y completas

Esta es la regla de oro. Asegúrate de tener copias de seguridad automáticas de tu tienda (archivos y base de datos). DirectAdmin suele ofrecer herramientas de backup, pero también puedes usar módulos de PrestaShop o servicios externos. Si algo sale mal, podrás restaurar tu tienda a un estado anterior sin perder datos críticos.

Documenta tus credenciales de forma segura

Guarda en un lugar seguro (como un gestor de contraseñas) los datos de acceso a tu base de datos: nombre de la base, usuario y contraseña. Esto te ahorrará muchos quebraderos de cabeza cuando necesites hacer cambios o migraciones.

Mantén PrestaShop y sus módulos actualizados

Las actualizaciones no solo añaden nuevas funciones, sino que también corrigen errores y vulnerabilidades de seguridad. Una versión desactualizada puede ser más propensa a fallos de conexión y otros problemas.

Realiza cambios con cuidado

Antes de modificar archivos de configuración o cambiar la contraseña de tu base de datos, piensa en las consecuencias. Si vas a cambiar la contraseña, ten a mano el archivo parameters.php para actualizarlo inmediatamente después.

Preguntas Frecuentes (FAQ) sobre el Error de Conexión a la Base de Datos en PrestaShop

Aquí tienes algunas de las preguntas más habituales que recibimos sobre este error.

¿He perdido mis productos y pedidos si veo este error?

No. Este error solo indica que la aplicación no puede comunicarse con la base de datos. Los datos siguen almacenados en el servidor MySQL. Una vez que se restablece la conexión, todo vuelve a estar en su sitio.

¿Puedo solucionar este error sin acceso a DirectAdmin?

Es muy complicado. Para editar el archivo parameters.php o gestionar la base de datos, necesitas acceso al panel de control o al servidor. Si no tienes acceso, deberás contactar con tu proveedor de hosting para que te ayuden.

¿Qué significa el error "mysqli_real_connect(): (HY000/2002): Connection refused"?

Este error específico suele indicar que el servidor de bases de datos está inaccesible. Puede ser que el servicio MySQL esté caído, que el puerto sea incorrecto o que haya un firewall bloqueando la conexión. Contacta con tu hosting para verificar el estado del servicio.

¿Por qué aparece el error después de cambiar la contraseña de mi base de datos?

Porque has olvidado actualizar el archivo parameters.php con la nueva contraseña. Es el error más común. Vuelve al paso de edición de parameters.php y actualiza la contraseña.

Si tengo mi tienda en Syspanel (el antiguo HestiaCP), ¿cómo puedo solucionarlo?

Si tu hosting utiliza Syspanel, el proceso es muy similar. Debes acceder a tu panel de control a través del puerto 2106 (por ejemplo, tudominio.com:2106). Dentro, busca el administrador de archivos y la sección de bases de datos MySQL. El archivo parameters.php se encuentra en la misma ruta (app/config/). La lógica para solucionar el error es idéntica a la explicada para DirectAdmin: verificar credenciales, permisos y el estado del servidor de bases de datos.

Conclusión: Recupera el Control de tu Tienda

El error de "No se puede conectar a la base de datos" en PrestaShop es un problema serio, pero casi siempre tiene una solución al alcance de la mano. Hemos recorrido las causas más comunes y sus remedios, desde la simple verificación de credenciales en el archivo parameters.php hasta la comprobación de la salud del servidor MySQL.

Recuerda el orden lógico de actuación:

Mantén la calma y diagnostica si el problema es general o específico de tu tienda.
Revisa el archivo parameters.php y asegúrate de que las credenciales (nombre de base, usuario y contraseña) sean exactas.
Verifica en DirectAdmin que la base de datos y el usuario existen y tienen los permisos correctos.
Prueba la conexión con phpMyAdmin para descartar problemas de credenciales.
Si todo lo anterior falla, revisa el estado del servidor, los puertos y los permisos de archivos.

Con estas herramientas y un poco de paciencia, podrás solucionar error prestashop y volver a poner tu tienda online en funcionamiento. Y recuerda, la prevención mediante copias de seguridad regulares es la mejor estrategia para minimizar el impacto de cualquier imprevisto técnico