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

Primeros pasos: entender qué está pasando exactamente

Cuando tu tienda online basada en WordPress muestra el temido mensaje “PrestaShop no puede conectarse a la base de datos”, lo primero que debes saber es que no estás solo. Este es uno de los errores más comunes en el mundo del hosting y el comercio electrónico, y tiene solución en la gran mayoría de los casos.

Antes de ponernos manos a la obra, es importante que entiendas qué significa este aviso. Básicamente, tu instalación de PrestaShop (que funciona dentro de WordPress) está intentando comunicarse con la base de datos donde se guardan tus productos, pedidos, clientes y configuraciones. Si esa comunicación falla, la tienda no puede cargar nada.

El error puede aparecer de varias formas: una pantalla blanca, un mensaje de error en inglés, o directamente la página de instalación de PrestaShop. No te asustes si ves algo diferente a lo que esperabas; el proceso de diagnóstico es prácticamente el mismo.

Lo más importante es que respires hondo. En el 90% de los casos, este problema se resuelve en menos de 15 minutos sin necesidad de contactar con soporte técnico. Eso sí, necesitarás acceso a tu panel de control de hosting (como cPanel, Syspanel o similar) y un poco de paciencia.

¿Por qué ocurre este error? Causas más frecuentes

Para solucionar cualquier problema, primero hay que conocer su origen. El error conexión base datos PrestaShop puede deberse a varias razones, aunque las más habituales son estas:

1. Cambios en las credenciales de acceso

Si recientemente cambiaste la contraseña de tu base de datos desde el panel de tu hosting, o si alguien más lo hizo (un desarrollador, un compañero de trabajo), es muy probable que PrestaShop siga intentando conectarse con las credenciales antiguas.

2. Problemas con el servidor de bases de datos

El servidor donde se aloja tu base de datos puede estar caído, sobrecargado o en mantenimiento. Esto es especialmente común en planes de hosting compartido, donde los recursos se reparten entre muchos usuarios.

3. Archivos de configuración corruptos o modificados

PrestaShop guarda los datos de conexión en un archivo llamado parameters.php. Si este archivo se corrompe, se modifica incorrectamente o se sube una versión antigua, la conexión fallará.

4. Movimiento del sitio web

Si has migrado tu tienda a un nuevo servidor o has cambiado de dominio, es posible que los datos de conexión sigan apuntando a la ubicación anterior.

5. Errores en la instalación de WordPress o PrestaShop

En ocasiones, los plugins o temas de WordPress que interactúan con PrestaShop pueden generar conflictos que bloquean la conexión a la base de datos.

6. Límite de memoria PHP excedido

Aunque menos común, un límite de memoria demasiado bajo puede provocar que el script de conexión falle en mitad del proceso.

Antes de empezar: prepara tu entorno de trabajo

Para poder solucionar el error, vas a necesitar:

Acceso a tu panel de control de hosting (cPanel, Syspanel, Plesk o similar).
Las credenciales de acceso a tu base de datos (usuario y contraseña). Si no las recuerdas, las puedes buscar en el panel de control.
Un editor de texto plano (como el Bloc de notas de Windows o TextEdit en Mac).
Acceso FTP o al administrador de archivos de tu hosting.

[INFO] Si tu hosting utiliza Syspanel, recuerda que el acceso al panel se realiza a través del puerto 2106. Por ejemplo: https://tu-dominio.com:2106. Allí encontrarás todas las herramientas de gestión de bases de datos y archivos.

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

El primer paso del diagnóstico es comprobar que la base de datos sigue existiendo y que el servidor donde se aloja funciona correctamente.

Accede a tu panel de control de hosting.
Busca la sección de Bases de Datos MySQL (o MariaDB, dependiendo de tu proveedor).
Localiza la base de datos que utiliza tu instalación de PrestaShop. Normalmente tendrá un nombre similar a tuusuario_prestashop o wp_prestashop.
Comprueba que aparece en la lista y que no está marcada como “suspendida” o “en mantenimiento”.

Si la base de datos no aparece, es posible que se haya eliminado accidentalmente. En ese caso, necesitarás restaurarla desde una copia de seguridad reciente.

Si aparece pero el servidor de bases de datos está caído, verás un mensaje de error en el propio panel. En ese caso, contacta con tu proveedor de hosting.

Paso 2: Localiza 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.

Para acceder a él, tienes dos opciones:

Opción A: Usando el administrador de archivos del hosting

Entra en tu panel de control.
Busca la sección de Administrador de Archivos (en Syspanel suele estar en el menú principal).
Navega hasta la carpeta donde tienes instalado WordPress/PrestaShop (normalmente public_html o www).
Entra en la carpeta app y luego en config.
Busca el archivo parameters.php.

Opción B: Usando FTP

Conéctate a tu servidor mediante un cliente FTP como FileZilla.
Navega hasta la raíz de tu instalación.
Entra en app/config/.
Descarga el archivo parameters.php a tu ordenador para editarlo.

Paso 3: Revisa y corrige las credenciales de conexión

Una vez que tengas el archivo parameters.php abierto en tu editor de texto, busca las líneas que contienen la configuración de la base de datos. Deberías ver algo parecido a esto:

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

[WARNING] Ten muchísimo cuidado al editar este archivo. Una coma mal puesta o una comilla fuera de lugar puede romper completamente tu tienda. Si no te sientes seguro, haz una copia de seguridad del archivo antes de modificarlo.

Ahora, verifica que estos datos coinciden con los que tienes en tu panel de control:

database_host: normalmente es localhost o 127.0.0.1, pero algunos proveedores usan direcciones como mysql.tudominio.com.
database_name: debe coincidir exactamente con el nombre de la base de datos en tu panel.
database_user: el usuario debe tener permisos sobre esa base de datos.
database_password: asegúrate de que no hay espacios adicionales ni caracteres extraños.

Si alguno de estos datos es incorrecto, corrígelo y guarda el archivo. Luego súbelo de nuevo al servidor (si usaste FTP) o guarda los cambios directamente en el administrador de archivos.

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

A veces las credenciales son correctas, pero el usuario no tiene permisos suficientes para acceder a la base de datos. Esto puede ocurrir después de una migración o si alguien modificó los privilegios.

Ve a la sección de Bases de Datos MySQL en tu panel de control.
Busca la base de datos que usa PrestaShop.
Haz clic en “Gestionar usuarios” o “Editar privilegios”.
Asegúrate de que el usuario que aparece en parameters.php tiene marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.).

Si no tiene todos los permisos, actívalos y guarda los cambios.

Paso 5: Reinicia el servidor de bases de datos (si es posible)

En algunos paneles de control, puedes reiniciar el servicio de MySQL/MariaDB directamente. Esto puede resolver problemas temporales de conexión.

En Syspanel, busca la sección de Servicios o Procesos.
Localiza el servicio de base de datos.
Haz clic en “Reiniciar”.

[TIP] Si no encuentras esta opción, no te preocupes. A veces basta con esperar unos minutos, ya que los servidores suelen reiniciarse automáticamente tras un fallo.

Paso 6: Comprueba el límite de memoria PHP

Un límite de memoria PHP demasiado bajo puede provocar que la conexión a la base de datos falle. Para aumentarlo, tienes que modificar el archivo wp-config.php (de WordPress) o el archivo .htaccess.

En `wp-config.php`:

Añade esta línea justo antes de la línea que dice /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');

En `.htaccess`:

Añade estas líneas al principio del archivo:

php_value memory_limit 256M
php_value upload_max_filesize 64M
php_value post_max_size 64M

Guarda los cambios y prueba de nuevo.

Paso 7: Verifica que WordPress y PrestaShop son compatibles

Aunque PrestaShop es un sistema independiente, cuando se integra con WordPress (por ejemplo, mediante plugins de sincronización), pueden surgir conflictos de versiones.

Comprueba que tu versión de PrestaShop es compatible con la de WordPress.
Revisa si los plugins de integración están actualizados.
Si recientemente actualizaste WordPress o algún plugin, intenta desactivarlo temporalmente para ver si el error desaparece.

Paso 8: Prueba la conexión manualmente

Para descartar que el problema sea de PrestaShop y no de la base de datos, puedes probar la conexión manualmente desde un archivo PHP temporal.

Crea un archivo llamado test_db.php en la raíz de tu instalación.
Pega este código:

<?php
$conn = new mysqli('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_datos');
if ($conn->connect_error) {
    die("Error de conexión: " . $conn->connect_error);
} else {
    echo "Conexión exitosa";
}
$conn->close();
?>

Sustituye los datos de conexión por los tuyos.
Accede a tudominio.com/test_db.php en tu navegador.

Si ves “Conexión exitosa”, el problema está en la configuración de PrestaShop. Si ves un error, el problema está en las credenciales o en el servidor.

[WARNING] Elimina este archivo inmediatamente después de la prueba. Dejarlo en el servidor es un riesgo de seguridad enorme.

Paso 9: Restaura desde una copia de seguridad

Si has probado todo lo anterior y sigues sin solución, la opción más segura es restaurar tu sitio desde una copia de seguridad reciente. Esto te devolverá la versión funcional de los archivos de configuración y la base de datos.

Ve a la sección de Copias de Seguridad en tu panel de control.
Selecciona la copia más reciente anterior al error.
Restaura tanto los archivos como la base de datos.

[INFO] Si no tienes copias de seguridad automáticas, puedes pedir a tu proveedor de hosting que restaure una copia reciente. La mayoría lo hace de forma gratuita si el error no es culpa tuya.

Paso 10: Contacta con soporte técnico

Si después de todos estos pasos el error PrestaShop no conecta BD persiste, es momento de contactar con tu proveedor de hosting. Explícales todo lo que has hecho y dales los detalles del error (captura de pantalla, mensaje exacto, fecha de inicio, etc.).

Muchas veces el problema está en el servidor y ellos pueden solucionarlo en minutos. No te sientas mal por tener que pedir ayuda; para eso está el soporte técnico.

Preguntas frecuentes sobre este error

¿Puedo perder mis datos si intento solucionarlo yo mismo?

Si sigues los pasos con cuidado y haces copias de seguridad antes de modificar nada, el riesgo es muy bajo. Eso sí, si no te sientes seguro, no toques nada y contacta con soporte.

¿Es lo mismo si mi tienda usa PrestaShop pero está en WordPress?

Sí, el error es el mismo. La diferencia es que la configuración de la base de datos puede estar gestionada por WordPress, pero los pasos de diagnóstico son idénticos.

¿Cuánto tiempo tarda en solucionarse?

En la mayoría de los casos, entre 15 y 30 minutos si sigues los pasos en orden. Si el problema es del servidor, puede tardar más, pero normalmente el hosting lo resuelve en menos de 24 horas.

¿Debo actualizar PrestaShop y WordPress?

Siempre es recomendable tener todo actualizado, pero no es la causa principal de este error. Las actualizaciones pueden ayudar a prevenir problemas futuros.

¿Qué hago si no encuentro el archivo `parameters.php`?

Si no encuentras el archivo, es posible que tu instalación esté dañada o que estés mirando en la carpeta equivocada. Verifica la ruta exacta: raiz/app/config/parameters.php. Si no está, necesitarás reinstalar PrestaShop o restaurar desde una copia.

Consejos finales para evitar este error en el futuro

Haz copias de seguridad periódicas de tu base de datos y archivos. La mayoría de los paneles de control permiten automatizarlas.
Anota tus credenciales en un lugar seguro. Así evitarás problemas cuando necesites acceder a la base de datos.
No modifiques archivos de configuración sin hacer antes una copia del original.
Mantén todo actualizado: WordPress, PrestaShop, plugins y temas.
Contrata un hosting de calidad con buen soporte técnico. Un buen proveedor puede marcar la diferencia cuando ocurren estos problemas.

Conclusión

El error conexión base datos PrestaShop es un problema molesto pero completamente solucionable en la mayoría de los casos. Siguiendo esta guía paso a paso, tendrás tu tienda funcionando de nuevo en poco tiempo.

Recuerda que la clave está en la paciencia y en ir descartando causas una a una. Empieza por lo más simple (verificar credenciales) y ve avanzando hacia soluciones más complejas si es necesario.

Si en algún momento te sientes abrumado, no dudes en pedir ayuda profesional. Un error de este tipo no debería arruinar tu negocio, y con las herramientas y conocimientos adecuados, podrás superarlo sin demasiado estrés.

Esperamos que este artículo te haya sido de gran ayuda. Si tienes más dudas, no dudes en consultar nuestra sección de preguntas frecuentes o contactar con nuestro equipo de soporte. ¡Tu tienda online merece estar siempre funcionando a pleno rendimiento!