Solucionar error 'PrestaShop no encuentra la base de datos' | Guía 2024

¿Qué significa exactamente "PrestaShop no encuentra la base de datos"?

Cuando hablamos del error "PrestaShop no encuentra la base de datos" nos referimos a un problema de conexión entre tu tienda online y el servidor donde se almacenan todos tus productos, pedidos y clientes. Es un error bastante común que puede aparecer tanto al instalar PrestaShop por primera vez, como al migrar tu tienda a un nuevo hosting o al actualizar la plataforma.

Este error puede manifestarse de varias formas: un mensaje en blanco, un aviso de "Error de conexión a la base de datos", o incluso un texto técnico que menciona algo sobre "PrestaShop WordPress error". Aunque parezca complicado, la mayoría de las veces tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Lo primero que debes saber es que PrestaShop y WordPress son plataformas diferentes, pero comparten un mismo sistema de almacenamiento de datos: MySQL. Es por eso que a veces los usuarios que gestionan ambas plataformas se confunden y buscan soluciones mezcladas. En este artículo nos centraremos específicamente en PrestaShop, aunque algunos consejos también te servirán si gestionas WordPress.

Causas más comunes del error de base de datos en PrestaShop

Antes de lanzarnos a solucionar el problema, es importante entender qué lo está causando. Las causas más frecuentes son:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos no coinciden con los datos reales.
Servidor de base de datos caído: El hosting donde se aloja tu base de datos está experimentando problemas.
Archivos de configuración corruptos: El archivo parameters.php de PrestaShop contiene información incorrecta o ha sido modificado accidentalmente.
Permisos insuficientes: El usuario de la base de datos no tiene los privilegios necesarios para leer o escribir datos.
Migración incompleta: Si acabas de mover tu tienda a un nuevo servidor, puede que la transferencia no se haya completado correctamente.
Actualización fallida: Una actualización de PrestaShop o de PHP puede haber dejado incompatibilidades.

Paso 1: Verifica que tu base de datos existe y está activa

El primer paso para solucionar error PrestaShop es comprobar que la base de datos existe realmente en tu servidor. Para ello, necesitas acceder a tu panel de control de hosting. Si utilizas Syspanel (el panel de control que antes se llamaba HestiaCP), recuerda que la URL de acceso es https://tu-dominio.com:2106.

Una vez dentro, sigue estos pasos:

Busca la sección de "Bases de datos" o "MySQL".
Revisa si aparece la base de datos que tu PrestaShop está intentando usar.
Anota el nombre exacto, el usuario y el puerto (normalmente 3306).

[!TIP]
TIP: El nombre de la base de datos suele tener un prefijo con tu nombre de usuario (por ejemplo: usuario_prestashop). Asegúrate de copiarlo tal cual, con mayúsculas y minúsculas exactas.

Si la base de datos no aparece, es posible que se haya eliminado por error. En ese caso, necesitarás restaurarla desde una copia de seguridad reciente. Si no tienes copia, contacta con tu proveedor de hosting para que te ayude a recuperarla.

Paso 2: Revisa el archivo de configuración de PrestaShop

El archivo que contiene toda la información de conexión es parameters.php y se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Este archivo es el "interruptor" que conecta tu tienda con la base de datos.

Para revisarlo, necesitas acceder a tu servidor mediante FTP o el administrador de archivos de tu hosting. Una vez localizado el archivo:

Descarga una copia de seguridad del mismo.
Ábrelo con un editor de texto como Notepad++ o Sublime Text.
Busca la sección que dice database_params.
Verifica que los siguientes valores sean correctos:
- database_host: normalmente es localhost o 127.0.0.1, pero en algunos hostings puede ser un servidor remoto.
- database_name: el nombre exacto de tu base de datos.
- database_user: el usuario con acceso a dicha base.
- database_password: la contraseña asociada a ese usuario.
- database_port: casi siempre es 3306.

[!WARNING]
WARNING: Ten mucho cuidado al editar este archivo. Un solo carácter mal escrito o un espacio de más puede provocar que PrestaShop no funcione. Si no te sientes seguro, haz una copia de seguridad antes de tocar nada.

Si alguno de los datos es incorrecto, corrígelo y guarda el archivo. Luego intenta acceder a tu tienda de nuevo.

Paso 3: Comprueba las credenciales en el administrador de bases de datos

A veces las credenciales que tienes anotadas en el archivo de configuración son correctas, pero el problema está en los permisos del usuario dentro de la base de datos. Para verificarlo:

Accede a Syspanel (recuerda, puerto 2106).
Ve a la sección de bases de datos.
Busca el usuario que está configurado en PrestaShop.
Comprueba que tiene todos los privilegios: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP.
Si no los tiene, edita el usuario y marca todas las casillas de permisos.

[!INFO]
INFO: En algunos hostings, los usuarios de bases de datos solo tienen permisos sobre su propia base de datos. Si has migrado la tienda y el usuario no tiene permisos sobre la nueva base, este es el problema.

Paso 4: Reinicia los servicios de base de datos

Si todo parece estar en orden pero el error persiste, es posible que el servidor de MySQL esté bloqueado o haya sufrido un fallo temporal. En este caso, reiniciar el servicio suele resolver el problema.

Desde Syspanel (puerto 2106):

Ve a la sección de "Servicios" o "Servicios del sistema".
Busca el servicio llamado MySQL o MariaDB.
Haz clic en "Reiniciar".
Espera unos segundos y prueba a acceder a tu tienda.

Si no tienes acceso a esta opción, contacta con tu proveedor de hosting y pídeles que reinicien el servicio de bases de datos.

Paso 5: Verifica los permisos de los archivos de PrestaShop

Un error poco conocido pero muy frustrante es cuando los archivos de PrestaShop tienen permisos incorrectos, lo que impide que el sistema lea correctamente la configuración. Esto suele ocurrir después de una migración o una restauración de copias de seguridad.

Los permisos recomendados son:

Carpetas: 755
Archivos: 644
Archivo parameters.php: 444 (solo lectura) después de la instalación.

Para cambiarlos, puedes usar el administrador de archivos de tu hosting o un cliente FTP como FileZilla. Selecciona todos los archivos y carpetas, haz clic derecho y elige "Permisos de archivo". Aplica los valores mencionados.

[!TIP]
TIP: Si no sabes qué permisos tienen tus archivos, revisa la documentación de tu hosting. En la mayoría de los casos, el soporte técnico puede ayudarte a configurarlos correctamente.

Paso 6: Prueba la conexión manualmente

Para descartar que el problema sea del servidor, puedes probar la conexión a la base de datos desde un script simple. Crea un archivo llamado test.php en la raíz de tu PrestaShop con el siguiente contenido:

<?php
$connection = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_de_datos');
if (!$connection) {
    die('Error de conexión: ' . mysqli_connect_error());
} else {
    echo 'Conexión exitosa';
}
?>

Reemplaza los valores por los tuyos y guarda el archivo. Luego accede desde tu navegador a https://tu-dominio.com/test.php. Si ves "Conexión exitosa", el problema está en la configuración de PrestaShop, no en la base de datos. Si ves un error, el problema es del servidor.

[!WARNING]
WARNING: IMPORTANTE: Elimina este archivo inmediatamente después de usarlo, ya que contiene información sensible de conexión y puede ser un riesgo de seguridad.

Paso 7: Actualiza PHP y los módulos de PrestaShop

Una causa menos evidente del error "PrestaShop no encuentra base de datos" es una versión de PHP incompatible. PrestaShop funciona mejor con PHP 7.4 o superior, y si tu hosting usa una versión más antigua, puede dar fallos de conexión.

Para actualizar PHP desde Syspanel (puerto 2106):

Ve a la sección de "PHP" o "Opciones de PHP".
Selecciona la versión más reciente disponible (recomendamos PHP 8.1 o superior).
Guarda los cambios y reinicia el servicio.

Además, asegúrate de que todos los módulos de PrestaShop estén actualizados. Los módulos obsoletos pueden generar conflictos que impidan la conexión correcta.

Paso 8: Restaura desde una copia de seguridad

Si has probado todo lo anterior y el error persiste, puede que tu instalación de PrestaShop esté dañada de forma irreparable. En ese caso, la solución más rápida es restaurar desde una copia de seguridad reciente.

Accede a Syspanel (puerto 2106).
Ve a la sección de "Copias de seguridad".
Elige una copia de tu base de datos y de los archivos.
Restaura primero la base de datos y luego los archivos.
Prueba de nuevo el acceso a tu tienda.

[!INFO]
INFO: Si no tienes copias de seguridad automáticas, contacta con tu proveedor de hosting. Muchos ofrecen copias diarias que pueden restaurar en menos de una hora.

Paso 9: Contacta con el soporte técnico

Si después de todos estos pasos sigues viendo el error, es hora de pedir ayuda profesional. Contacta con tu proveedor de hosting y explica claramente:

El mensaje exacto de error que ves.
Los pasos que ya has probado.
La versión de PrestaShop y PHP que estás usando.
Si el error apareció después de algún cambio reciente.

La mayoría de los hostings tienen técnicos disponibles 24/7 que pueden revisar los logs del servidor y detectar el problema en cuestión de minutos.

Preguntas frecuentes sobre el error de conexión

¿El error afecta a WordPress también?

El error de conexión a la base de datos puede afectar a cualquier plataforma que use MySQL, incluido WordPress. De hecho, es común que si PrestaShop falla, WordPress también muestre problemas si están en el mismo servidor. Sin embargo, los archivos de configuración son diferentes: WordPress usa wp-config.php y PrestaShop usa parameters.php.

¿Puedo solucionar este error sin acceso al hosting?

Lamentablemente no. Necesitas acceso al panel de control o al menos al FTP para poder modificar los archivos de configuración. Si no tienes estos accesos, contacta con quien te haya instalado la tienda o con tu proveedor de hosting.

¿Cuánto tiempo se tarda en arreglar este error?

Depende de la causa. Si es un problema de credenciales, puedes solucionarlo en menos de 10 minutos. Si es un problema del servidor, puede tardar unas horas hasta que el hosting lo resuelva. En el peor de los casos, restaurar una copia de seguridad puede llevar entre 30 minutos y 2 horas.

¿Cómo evito que esto vuelva a pasar?

La mejor prevención es mantener copias de seguridad periódicas y actualizar PrestaShop y PHP regularmente. También es recomendable guardar las credenciales de acceso en un lugar seguro y no compartirlas con nadie.

Conclusión: la paciencia es tu mejor aliada

El error "PrestaShop no encuentra la base de datos" es frustrante, pero casi siempre tiene solución. La clave está en seguir un orden lógico: primero verifica que la base existe, después revisa las credenciales, y finalmente comprueba los permisos y servicios.

Recuerda que no estás solo en esto. Si te sientes abrumado, tu proveedor de hosting está para ayudarte. Y si gestionas tu tienda en Syspanel, no olvides que el acceso es a través del puerto 2106.

Con estos pasos, estarás de vuelta en funcionamiento en poco tiempo y con tu tienda online vendiendo como siempre. Mucha suerte y no dudes en consultar este artículo cada vez que necesites solucionar error PrestaShop de forma rápida y eficaz.