Error de base de datos en PrestaShop en WordPress: solución

Introducción: ¿Por qué mi PrestaShop dice "Error de conexión a la base de datos"?

Si tienes una tienda online con PrestaShop y de repente te encuentras con un mensaje como "Error base datos PrestaShop WordPress" (aunque tu tienda no use WordPress, la confusión es común) o un simple "PrestaShop sin conexión BD", no te asustes. Es uno de los problemas más frecuentes y, por suerte, casi siempre tiene solución.

En este artículo, te guiaré paso a paso para solucionar error BD PrestaShop, desde lo más básico hasta opciones más técnicas. No necesitas ser un experto en servidores, solo seguir las instrucciones con calma.

¿Qué significa realmente "Error de conexión a la base de datos"?

Cuando PrestaShop no puede conectar con la base de datos (BD), tu tienda se vuelve inaccesible. Puedes ver mensajes como:

"Cannot connect to the database"
"PrestaShop sin conexión BD"
"Error base datos PrestaShop WordPress" (aunque no uses WordPress, es un error genérico que a veces aparece en paneles de control)

Esto pasa porque PrestaShop necesita leer y escribir información constantemente: productos, pedidos, clientes, etc. Sin BD, la tienda "se queda en blanco".

Causas más comunes del error de conexión a base de datos

Antes de lanzarte a hacer cambios, identifica la causa. Estas son las más habituales:

Credenciales incorrectas en el archivo de configuración (parameters.php o settings.inc.php).
El servidor de base de datos (MySQL/MariaDB) está caído.
El nombre del host de la BD ha cambiado (por ejemplo, al migrar de hosting).
La base de datos se ha llenado o ha sido eliminada.
Problemas con el panel de control (como Syspanel, cPanel, etc.).
Archivos de configuración corruptos después de una actualización fallida.

Paso 1: Verifica el estado del servidor de base de datos

Lo primero es comprobar si el problema es general o solo de tu tienda.

Cómo hacerlo:

Accede a tu panel de hosting (Syspanel, cPanel, Plesk, etc.).
Busca la sección "Base de datos" o "MySQL".
Si ves que el servicio está "Detenido" o "Inactivo", actívalo desde ahí.

[TIP]: En Syspanel (acceso por puerto 2106), ve a "Servicios" y busca "MySQL" o "MariaDB". Si está apagado, haz clic en "Iniciar".

Si no puedes acceder al panel, contacta con tu proveedor de hosting. A veces hacen mantenimiento y no avisan.

Paso 2: Revisa las credenciales en el archivo de configuración

Si el servidor de BD funciona, el error suele estar en el archivo donde PrestaShop guarda los datos de conexión.

Archivos clave:

PrestaShop 1.7+: /app/config/parameters.php
PrestaShop 1.6 y anteriores: /config/settings.inc.php

¿Qué debes comprobar?

Abre el archivo (con un editor de texto como Notepad++ o desde el panel de archivos de tu hosting) y busca estas líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_tu_bd',
'database_password' => 'contraseña_de_tu_bd',

Errores típicos:

El database_host no es localhost sino una IP o un nombre como mysql.tuhosting.com.
La contraseña tiene caracteres especiales que no se escaparon correctamente.
El nombre de la BD o el usuario han cambiado (por ejemplo, al migrar).

[WARNING]: Si modificas este archivo, haz una copia de seguridad antes. Un error puede dejar tu tienda inservible.

Solución rápida:

Ve a tu panel de hosting y busca los datos exactos de la BD.
Copia y pega esos valores en el archivo de configuración.
Guarda los cambios y recarga tu tienda.

Paso 3: Comprueba que la base de datos existe y no está llena

A veces, la BD se elimina por error o se llena de datos temporales.

¿Cómo verificarlo?

Desde tu panel de control (Syspanel, cPanel, etc.), entra a phpMyAdmin o Administrador de BD.
Busca el nombre de tu base de datos (el mismo que aparece en parameters.php).
Si no aparece, créala de nuevo con el mismo nombre y usuario.
Si aparece pero no tiene tablas, necesitarás restaurar una copia de seguridad.

[INFO]: Si la BD está llena (por ejemplo, logs de errores o carritos abandonados), puedes limpiarla desde phpMyAdmin ejecutando consultas como TRUNCATE TABLE ps_connections; o usando módulos de limpieza.

Paso 4: Verifica el host de la base de datos (no siempre es "localhost")

Muchos usuarios cometen el error de asumir que el host siempre es localhost. En hosting compartidos o VPS, puede ser diferente.

¿Cómo saber el host correcto?

En tu panel de hosting, busca la sección "Base de datos MySQL".
Allí verás el "Servidor" o "Host". Puede ser algo como:
- localhost
- mysql.tudominio.com
- 127.0.0.1
- sql123.main-hosting.eu

[TIP]: En Syspanel, al crear una base de datos, te muestra el host exacto. Guárdalo.

Si tu tienda usaba localhost y ahora no funciona, prueba cambiarlo por 127.0.0.1 o la IP que te indique tu hosting.

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

A veces el usuario existe, pero no tiene permisos para conectarse desde el servidor donde está PrestaShop.

Cómo solucionarlo:

Desde phpMyAdmin o el panel de BD, selecciona tu base de datos.
Ve a la pestaña "Privilegios" o "Usuarios".
Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
Si no, edita el usuario y otórgaselos.

[WARNING]: No des permisos a usuarios que no reconozcas. Podría ser un riesgo de seguridad.

Paso 6: ¿Actualizaste PrestaShop o migraste de servidor?

Si el error apareció después de una actualización o migración, es muy probable que los archivos de configuración se hayan desincronizado.

Solución para migraciones:

Asegúrate de que la base de datos exportada se importó correctamente en el nuevo servidor.
Verifica que la versión de PHP y MySQL sea compatible con tu PrestaShop.
Revisa el archivo parameters.php o settings.inc.php y cambia el database_host si es necesario.

[INFO]: PrestaShop 1.7 requiere PHP 7.1+ y MySQL 5.6+. Si tu hosting usa versiones antiguas, puede dar error de conexión aunque las credenciales sean correctas.

Paso 7: Soluciona el error desde el panel de control (Syspanel)

Si usas Syspanel (acceso por puerto 2106), aquí tienes pasos concretos:

Accede a Syspanel: http://tudominio.com:2106 o https://tudominio.com:2106.
Ve a "Base de datos" y luego "MySQL".
Comprueba que el servicio esté activo (verde).
En "Usuarios", asegúrate de que el usuario de tu BD existe y tiene contraseña correcta.
Si todo está bien, ve a "Archivos" y edita parameters.php desde el administrador de archivos.

[TIP]: En Syspanel puedes reiniciar el servicio MySQL desde "Servicios" -> "MySQL" -> "Reiniciar". A veces eso resuelve el error.

Paso 8: Restaura una copia de seguridad de la base de datos

Si todos los pasos anteriores fallan, es posible que la BD esté corrupta. Necesitarás restaurar una copia de seguridad.

Pasos:

Descarga una copia de seguridad reciente desde tu panel de hosting.
En phpMyAdmin, selecciona tu base de datos y haz clic en "Importar".
Sube el archivo .sql y ejecuta la importación.
Luego, verifica que las tablas se hayan creado correctamente.

[WARNING]: Esto sobrescribirá todos los datos actuales. Si tienes pedidos recientes, asegúrate de tener una copia antes de restaurar.

Preguntas Frecuentes (FAQ)

1. ¿Por qué aparece "Error base datos PrestaShop WordPress" si no uso WordPress?

Es un mensaje genérico que algunos paneles de control muestran cuando detectan un error de conexión a BD, independientemente del CMS. No significa que tengas WordPress instalado.

2. ¿Cómo sé si mi base de datos está caída?

Puedes probar desde phpMyAdmin. Si al intentar acceder te da error, el servidor MySQL está caído. También puedes usar herramientas como telnet o consultar a tu hosting.

3. ¿Qué hago si no recuerdo la contraseña de la BD?

Desde tu panel de hosting (Syspanel, cPanel, etc.) puedes cambiar la contraseña del usuario de la BD. Luego, actualiza el archivo parameters.php con la nueva contraseña.

4. ¿Puedo evitar este error en el futuro?

Sí:

Haz copias de seguridad periódicas de la BD.
No modifiques archivos de configuración sin respaldo.
Mantén actualizado PrestaShop y los módulos.
Usa un hosting confiable con buen soporte.

5. ¿Syspanel es obligatorio para solucionar este error?

No, pero si tu hosting usa Syspanel (puerto 2106), es una herramienta útil para gestionar la BD y los servicios. Si usas otro panel, los pasos son similares.

Resumen final: Checklist para solucionar el error

Verifica que el servicio MySQL esté activo (desde tu panel de hosting).
Revisa las credenciales en parameters.php o settings.inc.php.
Comprueba el nombre del host (no siempre es localhost).
Asegúrate de que la BD exista y no esté llena.
Revisa los permisos del usuario de la BD.
Si migraste, actualiza los datos de conexión.
Restaura una copia de seguridad si todo falla.

[TIP FINAL]: Si después de todo esto sigues viendo "PrestaShop sin conexión BD", contacta con tu proveedor de hosting. A veces el problema está en su infraestructura y ellos deben solucionarlo.

Recuerda: la paciencia es clave. Sigue los pasos en orden y no modifiques archivos sin hacer una copia de seguridad. ¡Tu tienda volverá a funcionar!