Resolver error de conexión a BD de PrestaShop en WordPress (hosting)

¿Qué significa realmente el error "PrestaShop no se conecta a la base de datos"?

Cuando intentas conectar tu tienda PrestaShop con WordPress, o simplemente al cargar tu panel de administración de PrestaShop te aparece un mensaje similar a "Error de conexión a la base de datos" o "Prestashop MySQL error", no debes entrar en pánico. Este es uno de los problemas más comunes en el mundo del hosting y, en la mayoría de los casos, tiene una solución sencilla.

Este error significa que tu aplicación PrestaShop no puede comunicarse con el servidor donde se almacenan tus productos, pedidos y clientes. Es como si intentaras abrir una tienda física pero la puerta del almacén estuviera cerrada con llave y no encontraras la llave correcta.

A lo largo de esta guía, te explicaré paso a paso cómo identificar la causa y aplicar la solución error PrestaShop de forma clara y sin tecnicismos innecesarios. Vamos a ello.

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

Antes de lanzarnos a solucionar, es fundamental entender qué puede estar provocando el problema. Las causas más habituales son:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos.
Servidor de base de datos caído: El servicio MySQL o MariaDB no está activo en tu servidor.
Cambios en el hosting: Si has migrado de servidor o has cambiado de plan, los datos de conexión pueden haber cambiado.
Archivo de configuración corrupto: El archivo parameters.php o settings.inc.php de PrestaShop contiene datos erróneos.
Permisos de usuario insuficientes: El usuario de la base de datos no tiene privilegios completos.
Problemas con el puerto de conexión: A veces el puerto de MySQL no es el estándar (3306).
Saturación del servidor: Demasiadas conexiones simultáneas pueden bloquear el acceso.

Paso 1: Verifica que el servidor de base de datos esté activo

Lo primero que debes comprobar es si el servicio de base de datos está funcionando. Esto es especialmente relevante si usas un panel de control como Syspanel (recuerda que el acceso a este panel se realiza a través del puerto 2106).

Cómo comprobarlo en Syspanel

Accede a tu panel Syspanel escribiendo en tu navegador: https://tudominio.com:2106.
Inicia sesión con tus credenciales de administrador.
En el menú lateral, busca la sección "Servicios" o "Procesos".
Localiza el servicio MySQL o MariaDB.
Verifica que su estado sea "Activo" o "Running". Si aparece detenido, actívalo pulsando el botón de inicio.

[WARNING] Si el servicio no se inicia correctamente, puede ser que el disco esté lleno o que haya un conflicto de configuración. En ese caso, contacta con tu proveedor de hosting.

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

Si el servicio está activo pero el error persiste, es hora de revisar los datos de conexión que PrestaShop tiene guardados.

Localiza el archivo correcto

Dependiendo de la versión de PrestaShop que uses:

PrestaShop 1.7 y versiones superiores: El archivo es app/config/parameters.php.
PrestaShop 1.6 y versiones anteriores: El archivo es config/settings.inc.php.

Qué debes buscar

Abre el archivo con un editor de texto (puedes usar el administrador de archivos de Syspanel o un cliente FTP) y busca líneas similares a estas:

'database_host' => 'localhost',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Comprueba que estos cuatro valores coincidan exactamente con los datos que te proporcionó tu proveedor de hosting. Un error muy común es que la contraseña contenga caracteres especiales que se hayan escapado mal.

[TIP] Si no recuerdas tus credenciales de base de datos, puedes crear una nueva desde Syspanel en la sección "Bases de datos" y actualizar el archivo con los nuevos datos.

Paso 3: Prueba la conexión manualmente con MySQL

Para descartar que el problema sea de la aplicación, puedes probar la conexión directamente desde la línea de comandos o desde el propio Syspanel.

Desde Syspanel

Accede a Syspanel (puerto 2106).
Ve a la sección "Bases de datos".
Pulsa en "phpMyAdmin".
Intenta iniciar sesión con el usuario y contraseña que tienes configurados en PrestaShop.
Si no puedes acceder, el problema está en las credenciales.

Desde terminal (si tienes acceso SSH)

mysql -u tu_usuario -p -h localhost tu_basededatos

Si te pide la contraseña y no te deja entrar, las credenciales son incorrectas o el usuario no tiene permisos.

[INFO] Si usas un hosting compartido, es posible que el host de la base de datos no sea localhost, sino algo como mysql.tudominio.com. Consulta la documentación de tu proveedor.

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

A veces, el usuario existe y la contraseña es correcta, pero no tiene privilegios suficientes para que PrestaShop funcione correctamente.

Cómo otorgar todos los privilegios

Entra en phpMyAdmin desde Syspanel.
Selecciona tu base de datos.
Ve a la pestaña "Privilegios" o "Usuarios".
Localiza el usuario que usa PrestaShop.
Pulsa en "Editar privilegios".
Marca la opción "Marcar todos" para otorgar todos los permisos.
Guarda los cambios.

[WARNING] No otorgues permisos a usuarios que no conozcas. Esto es solo para el usuario específico que usa tu tienda.

Paso 5: Soluciona el error al conectar PrestaShop con WordPress

Si lo que intentas es conectar PrestaShop WordPress mediante un plugin o un puente de datos, el error puede tener matices diferentes. Aquí te dejo algunos consejos específicos:

Usa un plugin de integración fiable

Existen plugins como PrestaShop Integration for WooCommerce que permiten sincronizar productos y pedidos. Si el plugin no conecta, revisa:

URL del sitio PrestaShop: Debe ser la URL completa, incluyendo https://.
Clave de API: PrestaShop requiere una clave de API para conexiones externas. Genérala en el back office de PrestaShop en "Servicios Web".
Compatibilidad de versiones: Asegúrate de que el plugin sea compatible con tu versión de PrestaShop y de WordPress.

Errores típicos de integración

Error	Posible causa	Solución
"No se puede conectar al servidor"	Firewall bloquea peticiones	Abre los puertos necesarios o desactiva temporalmente el firewall
"Error 401 Unauthorized"	Clave API incorrecta	Regenera la clave en PrestaShop
"Timeout"	Servidor muy lento	Aumenta el tiempo de espera en el plugin

Paso 6: Revisa los logs de error

Si después de todo esto el error base datos PrestaShop continúa, los registros del servidor te darán pistas valiosas.

Dónde encontrar los logs

En Syspanel (puerto 2106), busca la sección "Registros" o "Logs".
También puedes revisar el archivo var/logs/ dentro de tu instalación de PrestaShop.
Los logs de MySQL suelen estar en /var/log/mysql/error.log.

Qué buscar

"Access denied for user": Indica que las credenciales son incorrectas.
"Unknown database": El nombre de la base de datos no existe.
"Connection refused": El servidor MySQL no está escuchando en el puerto esperado.

[TIP] Si no entiendes los logs, copia las últimas 10 líneas y búscalas en Google. Es muy probable que alguien ya haya tenido el mismo problema.

Paso 7: Solución avanzada: cambiar el host de conexión

En algunos alojamientos, especialmente en servidores con muchos sitios, el host de la base de datos no es localhost, sino una dirección IP o un nombre de host específico.

Cómo encontrar el host correcto

Accede a Syspanel (puerto 2106).
Ve a la sección "Bases de datos".
Junto a tu base de datos, verás el "Servidor" o "Host".
Copia ese valor y pégalo en tu archivo parameters.php o settings.inc.php en lugar de localhost.

Paso 8: Restablece la contraseña de la base de datos

Si has probado todo y sigues sin poder acceder, la opción más segura es restablecer la contraseña del usuario de la base de datos.

Desde Syspanel

Accede a Syspanel (puerto 2106).
Ve a "Bases de datos" y luego a "Usuarios".
Localiza tu usuario y pulsa en "Cambiar contraseña".
Elige una contraseña segura (combina letras, números y símbolos).
Actualiza el archivo de configuración de PrestaShop con la nueva contraseña.

[WARNING] Asegúrate de actualizar ambos sitios (PrestaShop y WordPress) si los dos usan la misma base de datos, para no romper la conexión del otro.

Paso 9: Verifica la compatibilidad de versiones MySQL

PrestaShop es exigente con las versiones de MySQL. Si tu servidor usa MySQL 8.0 y tu PrestaShop es antiguo, puede haber problemas de autenticación.

Qué hacer

Actualiza PrestaShop a la última versión estable.
Si no puedes actualizar, cambia el método de autenticación de MySQL a mysql_native_password (consulta con tu proveedor).
Comprueba que PHP y MySQL son compatibles entre sí.

Paso 10: Contacta con tu proveedor de hosting

Si has llegado hasta aquí y el problema persiste, es momento de pedir ayuda profesional. Tu proveedor de hosting tiene acceso al servidor y puede diagnosticar problemas que están fuera de tu alcance.

Qué información debes proporcionar

El mensaje de error exacto.
Los pasos que ya has intentado.
La versión de PrestaShop y de PHP.
Capturas de pantalla si es posible.

Preguntas frecuentes (FAQ)

¿Qué hago si el error aparece después de una migración?

Es muy común. Revisa que los datos de conexión en el archivo de configuración coincidan con los del nuevo servidor. A veces el host cambia de localhost a una IP.

¿Puedo conectar PrestaShop y WordPress en el mismo hosting?

Sí, siempre que ambos usen bases de datos diferentes o la misma con prefijos distintos. No es recomendable que compartan la misma base de datos sin una configuración avanzada.

¿El error puede deberse a un plugin de WordPress?

Si el error aparece al intentar conectar PrestaShop WordPress, desactiva temporalmente todos los plugins de WordPress y prueba de nuevo. Si funciona, reactiva uno a uno hasta encontrar el culpable.

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

Depende de la causa. Si es un problema de credenciales, en 10 minutos lo tienes resuelto. Si es un fallo del servidor, puede llevar más tiempo.

Conclusión

El error de conexión a la base de datos en PrestaShop es frustrante, pero como has visto, tiene solución. La clave está en ir descartando causas de forma metódica: primero el servicio, luego las credenciales, después los permisos y finalmente el entorno.

Recuerda que Syspanel es tu aliado para gestionar todo esto, accediendo siempre a través del puerto 2106. Y si en algún momento te sientes perdido, no dudes en contactar con tu proveedor de hosting: para eso están.

Espero que esta guía te haya sido de gran ayuda. Ahora ya sabes cómo enfrentarte a este problema con confianza. ¡Tu tienda online volverá a estar operativa en poco tiempo!