Error conexión BD PrestaShop en hosting WordPress – Solución

[INFO] Este artículo está pensado para usuarios que han instalado PrestaShop en un entorno de hosting de WordPress y se encuentran con el temido mensaje de error de conexión a la base de datos. No te preocupes, es un problema muy común 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 programación.

Cuando intentas instalar o acceder a tu tienda PrestaShop y te aparece un mensaje como "PrestaShop no puede conectarse a la base de datos" o similar, la frustración es normal. Sin embargo, este error suele ser la puerta de entrada a un problema de configuración, de permisos o de datos incorrectos. Vamos a desglosarlo paso a paso para que puedas solucionar el error PrestaShop y volver a tener tu tienda online funcionando en un abrir y cerrar de ojos.

¿Qué significa exactamente este error?

El mensaje "error conexión base datos prestashop" indica que tu instalación de PrestaShop no puede establecer una comunicación con el servidor de base de datos MySQL (o MariaDB) donde se almacenan todos tus productos, pedidos y clientes.

Imagina que tu tienda es una tienda física. La base de datos es el almacén trasero donde guardas toda la mercancía. Si la puerta del almacén está cerrada con una llave equivocada, o el almacén está en otra dirección de la que creías, no podrás sacar nada para vender. Este error es exactamente eso: un problema de acceso al almacén.

Es importante aclarar que, aunque estés en un prestashop hosting wordpress error, el problema no suele ser culpa de WordPress. Lo que ocurre es que ambos sistemas comparten el mismo servidor y, a veces, la configuración de uno interfiere o simplemente la configuración de PrestaShop no es la correcta para ese entorno específico.

Primeros pasos: Localiza el archivo de configuración

El corazón de la conexión a la base de datos en PrestaShop se encuentra en un archivo llamado parameters.php. Este archivo es como el mapa que le dice a tu tienda dónde está el almacén y con qué llave abrirlo.

¿Cómo encontrar y revisar `parameters.php`?

Accede a tu hosting mediante un gestor de archivos (como cPanel, Syspanel o FTP).
Navega a la carpeta raíz donde está instalado PrestaShop. Normalmente es public_html, htdocs o una subcarpeta como tienda o prestashop.
Dentro de esa carpeta, busca la subcarpeta llamada app y luego config.
Ahí encontrarás el archivo parameters.php. Ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text).

Dentro de este archivo verás una estructura similar a esta (no te asustes, es más simple de lo que parece):

return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'tu_nombre_de_bd',
        'database_user' => 'tu_usuario_de_bd',
        'database_password' => 'tu_contraseña_de_bd',
        'database_prefix' => 'ps_',
        // ... otros parámetros
    ],
];

Aquí es donde se encuentra el 90% de los problemas. Debes verificar que estos datos sean exactamente los mismos que te proporcionó tu proveedor de hosting al crear la base de datos.

Causa #1: Credenciales incorrectas (El error más común)

La causa más frecuente del prestashop no conecta mysql es haber escrito mal el nombre de la base de datos, el usuario o la contraseña. Es increíblemente fácil cometer un error tipográfico, o copiar y pegar un espacio extra.

Solución paso a paso

Accede a tu panel de control del hosting (cPanel, Syspanel, Plesk, etc.). Recuerda que si usas Syspanel, el acceso es a través del puerto 2106.
Busca la sección de Bases de Datos MySQL.
Anota cuidadosamente el nombre exacto de la base de datos, el nombre de usuario y asegúrate de tener la contraseña correcta. A veces, si no recuerdas la contraseña, puedes cambiarla desde el mismo panel.
Vuelve al archivo parameters.php y compara los datos. Corrige cualquier discrepancia.
Guarda el archivo y sube los cambios al servidor si lo editaste localmente.

[WARNING] Asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos. En la mayoría de los paneles, al crear un usuario y asignarlo a una base de datos, debes marcar la casilla "Privilegios Totales" o "ALL PRIVILEGES". Si no lo has hecho, este es el momento de hacerlo.

Causa #2: El host de la base de datos no es `localhost`

Muchos hosting de gama alta o específicos para WordPress (y que también alojan PrestaShop) utilizan un servidor de base de datos separado de la web. En lugar de localhost, tendrás algo como mysql.tudominio.com o db12345.hostingcompany.com.

¿Cómo saber cuál es el host correcto?

Revisa el correo de bienvenida de tu proveedor de hosting. Casi siempre incluye los datos de conexión a la base de datos.
Si usas Syspanel, ve a la sección de bases de datos y busca el campo "Servidor" o "Host". Ahí te dirá la dirección exacta que debes usar.
Si no lo encuentras, contacta con el soporte técnico de tu hosting. Ellos te confirmarán el valor exacto para database_host.

Si el valor es distinto a localhost, cámbialo en el archivo parameters.php y guarda.

Causa #3: El puerto de conexión es incorrecto

A veces, el servidor de base de datos no está en el puerto estándar (3306). Puede estar en un puerto personalizado por seguridad o por la configuración del servidor.

Localizar el puerto

En tu panel de control del hosting (cPanel, Syspanel, etc.), busca la sección de bases de datos.
A menudo, el puerto aparece junto al host, por ejemplo: mysql.tudominio.com:3307.
Si ves un puerto diferente, añádelo en el campo database_port del archivo parameters.php. Si no ves ningún puerto, déjalo vacío o pon 3306, que es el estándar.

Causa #4: El archivo de configuración está corrupto o incompleto

Si has editado el archivo manualmente y has borrado una coma o una comilla sin querer, el archivo PHP fallará y PrestaShop no podrá leer los datos de conexión.

Solución

Si tienes una copia de seguridad reciente del archivo parameters.php, restáurala.
Si no tienes copia, puedes descargar una copia limpia de PrestaShop de la versión que estés usando, extraer el archivo parameters.php de la carpeta app/config y rellenarlo con tus datos. Ten mucho cuidado de no cambiar la estructura del array.

[INFO] Una buena práctica es hacer una copia de seguridad de este archivo antes de hacer cualquier cambio. Así, si algo sale mal, puedes revertir fácilmente.

Causa #5: Problemas con el prefijo de las tablas

PrestaShop, por defecto, usa el prefijo ps_ para sus tablas. Si durante la instalación cambiaste este prefijo (por ejemplo, a shop_), el archivo parameters.php debe reflejarlo.

Verificar el prefijo

Accede a tu base de datos desde el panel de control del hosting (por ejemplo, con phpMyAdmin).
Mira los nombres de las tablas. Si empiezan por ps_, el prefijo es correcto. Si empiezan por otra cosa, como shop_, debes actualizar el campo database_prefix en parameters.php.

Causa #6: El servidor MySQL está caído o sobrecargado

A veces el error no es culpa de tu configuración, sino del servidor. Si el servicio de MySQL se ha detenido o está sobrecargado, no podrás conectarte.

¿Cómo comprobarlo?

Intenta acceder a phpMyAdmin desde tu panel de control. Si tampoco puedes acceder, es muy probable que el problema sea del servidor.
Revisa el estado del servicio en tu panel de control. En Syspanel, busca la sección de "Servicios" o "Estado del servidor".
Si el servidor está caído, no puedes hacer nada excepto esperar y, si es muy prolongado, contactar con el soporte de tu hosting.

Causa #7: Conflictos con la caché de PrestaShop

Después de corregir los datos en parameters.php, es posible que PrestaShop siga mostrando el error porque tiene una caché antigua guardada.

Solución: Limpiar la caché

Borra la carpeta var/cache en la raíz de tu instalación de PrestaShop. Puedes hacerlo a través del gestor de archivos de tu hosting o por FTP.
Si no puedes borrar la carpeta completa, borra todos los archivos que están dentro de var/cache/dev y var/cache/prod. Esto forzará a PrestaShop a regenerar la caché con los nuevos datos de conexión.

Solución avanzada: Editar el archivo `.env` (si existe)

En versiones más recientes de PrestaShop, también puede haber un archivo llamado .env en la raíz. Este archivo puede sobrescribir los valores de parameters.php.

Qué hacer

Busca el archivo .env en la raíz de tu instalación.
Si existe, ábrelo y busca las líneas que empiecen por DATABASE_.
Verifica que los valores sean correctos. Si el archivo .env tiene prioridad, los datos de parameters.php se ignorarán.

Preguntas Frecuentes (FAQ)

¿Por qué me sale este error justo después de migrar mi tienda a un hosting de WordPress?

Es muy común. Al migrar, los datos de conexión (host, usuario, contraseña) suelen cambiar. El archivo parameters.php aún tiene los datos del antiguo servidor. Solo tienes que actualizarlo con los nuevos datos de tu nuevo hosting.

¿Puedo usar el mismo usuario de base de datos de WordPress para PrestaShop?

Técnicamente sí, pero no es recomendable. Es mejor crear una base de datos y un usuario específicos para PrestaShop. Así evitas conflictos si algo sale mal con WordPress y mantienes tus datos más seguros.

¿Qué es Syspanel y por qué se menciona tanto?

Syspanel es un panel de control de hosting popular y amigable. Si tu proveedor lo usa, para acceder a la gestión de tus bases de datos, archivos y servicios, debes hacerlo a través de su dirección web específica, que generalmente incluye el puerto 2106. Es simplemente una alternativa a cPanel o Plesk.

He seguido todos los pasos y aún no funciona, ¿qué hago?

Si has verificado las credenciales, el host, el puerto, el prefijo y limpiado la caché, el problema puede ser más profundo. Te recomiendo:

Revisar los logs de error de PrestaShop en la carpeta var/logs. Ahí encontrarás mensajes más detallados.
Contactar con el soporte técnico de tu hosting. Ellos pueden verificar si el servidor MySQL está funcionando correctamente y si hay algún bloqueo de firewall.

[TIP] Antes de contactar con el soporte, ten a mano tu número de ticket o de cliente, y describe exactamente los pasos que has seguido. Esto acelerará el proceso de resolución.

¿Perderé mis datos si modifico el archivo `parameters.php`?

No. Este archivo solo contiene la configuración de conexión. No contiene datos de tu tienda (productos, pedidos, etc.). Modificarlo no afecta a tus datos, solo a la capacidad de PrestaShop para encontrarlos.

Esperamos que esta guía extensa te haya sido de gran ayuda para solucionar el error PrestaShop. Recuerda que la paciencia y la revisión meticulosa de los datos son tus mejores aliadas. Si has llegado hasta aquí, ya tienes un conocimiento sólido para enfrentarte a este problema con confianza. ¡Tu tienda online volverá a estar operativa en nada!