Error conexión BD PrestaShop cPanel | Solución rápida

¿Tu tienda PrestaShop se ha quedado en blanco o muestra un mensaje de error sobre la base de datos? Es una situación que asusta a cualquier propietario de una tienda online, pero no te preocupes, es más común de lo que crees y, en la mayoría de los casos, tiene solución.

En esta guía completa, vamos a desglosar paso a paso cómo solucionar cualquier error base datos PrestaShop cPanel. Te explicaré desde los problemas más básicos (como un usuario o contraseña incorrectos) hasta los más complejos (como la corrupción de tablas). Al final, serás capaz de diagnosticar y resolver los problemas de PrestaShop conexión BD por ti mismo.

Empecemos por lo básico.

¿Por qué falla la conexión a la base de datos en PrestaShop?

Antes de lanzarnos a solucionar, entendamos qué está pasando. PrestaShop guarda toda la información de tu tienda (productos, clientes, pedidos, configuraciones) en una base de datos MySQL. Cuando tu tienda no puede "hablar" con esa base de datos, se produce un error. Las causas principales son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos en el archivo de configuración no coinciden con los reales.
Servidor MySQL caído o sobrecargado: El servicio de bases de datos en tu hosting no está funcionando.
Base de datos corrupta: Alguna tabla de la base de datos se ha dañado.
Límite de conexiones excedido: Demasiadas conexiones simultáneas están bloqueando el acceso.
Permisos de usuario incorrectos: El usuario no tiene permisos para leer o escribir en la base de datos.
Problemas con el archivo settings.inc.php: La configuración está mal escrita o el archivo está dañado.

Vamos a ver cómo identificar y solucionar cada uno de estos escenarios.

Paso 1: Lo primero, comprueba el estado del servidor MySQL

Antes de tocar nada, asegúrate de que el problema no sea general. Un error típico es "Error de conexión a la base de datos" o "No se puede conectar al servidor MySQL".

¿Cómo saber si MySQL está funcionando en cPanel?

Accede a tu cPanel. (Normalmente es tudominio.com/cpanel o te lo proporciona tu hosting).
Busca la sección "Bases de datos" y haz clic en "MySQL Databases" o "phpMyAdmin".
Si phpMyAdmin se abre y ves tus bases de datos, el servidor MySQL está funcionando. Si te da un error al abrir phpMyAdmin, el servidor puede estar caído.
Otra opción: busca la herramienta "MySQL Database Wizard" o "Remote MySQL".

[WARNING] Si phpMyAdmin no carga o te muestra un error de conexión, contacta con tu proveedor de hosting inmediatamente. Es probable que el servicio MySQL se haya detenido y ellos deben reiniciarlo. No es algo que puedas solucionar desde cPanel.

Si phpMyAdmin funciona, el problema está en la configuración de tu tienda. Sigue leyendo.

Paso 2: Verifica y corrige las credenciales en el archivo settings.inc.php

Este es el archivo más importante para la PrestaShop conexión BD. Se encuentra en la carpeta config de tu instalación de PrestaShop. Aquí es donde PrestaShop guarda los datos de acceso a la base de datos.

¿Cómo acceder y editar el archivo?

Desde cPanel, abre el "Administrador de Archivos" (File Manager).
Navega a la carpeta donde instalaste PrestaShop (normalmente public_html o una subcarpeta).
Busca la carpeta config y dentro, el archivo settings.inc.php.
Haz clic derecho sobre el archivo y selecciona "Editar" o "Code Editor".

¿Qué debes buscar y corregir?

Dentro del archivo, verás líneas como estas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_usuario_cpanel_nombre_bd');
define('_DB_USER_', 'tu_usuario_cpanel_usuario_bd');
define('_DB_PASSWD_', 'tu_contraseña_segura');
define('_DB_PREFIX_', 'ps_');

Debes verificar que estos valores sean EXACTAMENTE IGUALES a los que tienes en cPanel.

_DB_SERVER_: Normalmente es localhost. Si tu hosting usa un servidor de bases de datos remoto, te lo habrán indicado. Si no estás seguro, localhost es el valor por defecto correcto en el 99% de los casos.
_DB_NAME_, _DB_USER_ y _DB_PASSWD_: Estos son los que creaste en cPanel.

¿Cómo obtener los valores correctos desde cPanel?

Ve a "MySQL Databases" en cPanel.
En la sección "Current Databases" verás el nombre de tu base de datos (ej: tuusuario_nombrebd).
En la sección "Current Users" verás los usuarios y sus bases de datos asociadas.
Si no recuerdas la contraseña, puedes crear una nueva desde "MySQL Database Wizard" o cambiar la contraseña del usuario desde la sección "Change Password".
- Importante: Si cambias la contraseña, debes actualizarla también en el archivo settings.inc.php.

[TIP] Si no estás seguro de la contraseña, es más seguro crear un nuevo usuario y asignarlo a la base de datos, y luego actualizar el archivo settings.inc.php con las nuevas credenciales. Así evitas errores de tipeo.

Paso 3: Soluciona la corrupción de la base de datos

A veces, el error no es de conexión, sino que la base de datos está dañada. PrestaShop puede mostrar errores como "Table 'ps_product' doesn't exist" o similares.

¿Cómo reparar la base de datos desde cPanel?

Abre phpMyAdmin desde cPanel.
Selecciona la base de datos de tu PrestaShop (la que aparece en settings.inc.php).
Marca la casilla "Seleccionar todo" en la parte inferior de la lista de tablas.
En el menú desplegable "Con seleccionados:", elige "Reparar tabla".
phpMyAdmin intentará reparar todas las tablas. Si alguna no se puede reparar, te lo indicará.

[INFO] Si la reparación falla, puedes intentar una "Verificar tabla" primero para ver el estado. Si el problema persiste, contacta a tu hosting, ya que puede ser un problema de hardware o de versión de MySQL.

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

Un error común es que el usuario tenga permisos insuficientes. Para que PrestaShop funcione, el usuario necesita TODOS LOS PRIVILEGIOS sobre la base de datos.

¿Cómo asignar todos los privilegios?

En cPanel, ve a "MySQL Databases".
En la sección "Add User To Database" (o similar), busca el usuario y la base de datos.
Marca la casilla "ALL PRIVILEGES" y haz clic en "Make Changes" o "Add".
Si ya están añadidos, puedes modificar los privilegios desde la sección "Current Databases" haciendo clic en "Check Privileges" y luego en "Edit Privileges".

Paso 5: Soluciona el límite de conexiones a la base de datos

Si tu tienda recibe mucho tráfico o tienes muchos módulos que hacen consultas, puedes exceder el límite de conexiones simultáneas permitidas por tu hosting.

Síntomas:

Errores intermitentes de conexión.
La tienda carga a veces y a veces no.
Mensajes como "Too many connections".

¿Qué puedes hacer?

Contacta a tu hosting: Pregunta si puedes aumentar el límite de conexiones (max_connections). Algunos planes compartidos tienen límites muy bajos (ej: 30 conexiones).
Optimiza tu tienda: Desactiva módulos que no uses, habilita la caché de PrestaShop (en Preferencias > Rendimiento) y considera usar un sistema de caché como Redis o Memcached si tu hosting lo permite.
Revisa plugins pesados: Algunos módulos de terceros hacen muchas consultas a la base de datos sin necesidad.

Paso 6: Restaura un backup de la base de datos

Si has intentado todo y el error persiste, especialmente si la base de datos está corrupta y no se puede reparar, restaurar un backup es la solución más segura.

¿Cómo restaurar desde cPanel?

Ve a "phpMyAdmin".
Selecciona tu base de datos.
Haz clic en la pestaña "Importar" (Import).
Haz clic en "Seleccionar archivo" y elige el archivo .sql de tu backup.
Haz clic en "Continuar" o "Ejecutar".

[WARNING] ¡MUY IMPORTANTE! Antes de importar, borra todas las tablas existentes de la base de datos. Si no lo haces, los datos se duplicarán o se mezclarán. Puedes hacerlo desde phpMyAdmin seleccionando todas las tablas y eligiendo "Eliminar" (Drop). Luego importas el backup.

Preguntas Frecuentes (FAQ) sobre errores de base de datos en PrestaShop

¿Por qué aparece "Error de conexión a la base de datos" después de mover mi tienda a otro hosting?

Es el error más común al migrar. La causa es que el archivo settings.inc.php aún tiene las credenciales del antiguo hosting. Debes editarlo y poner los datos del nuevo hosting (servidor, nombre BD, usuario y contraseña).

¿Qué hago si no tengo acceso a cPanel?

Si no tienes cPanel, tu hosting puede usar otro panel como Syspanel (HestiaCP). En ese caso:

Accede a Syspanel a través de tu-ip:2106.
Busca la sección de bases de datos (MySQL).
Los pasos son similares: buscar phpMyAdmin, editar archivos de configuración desde el gestor de archivos (File Manager) de Syspanel.

[INFO] Recuerda que Syspanel (HestiaCP) usa el puerto 2106 para el acceso web.

¿Puedo usar un editor de texto para modificar settings.inc.php?

Sí, pero nunca lo edites con un editor como Bloc de Notas de Windows porque puede añadir caracteres ocultos. Usa el editor de código de cPanel o un editor avanzado como Notepad++ o Sublime Text. Si lo editas desde el Administrador de Archivos de cPanel, es seguro.

¿El error puede deberse a una versión de PHP incompatible?

Sí. PrestaShop 1.6, por ejemplo, no funciona bien con PHP 8.0 o superior. Si tu hosting ha actualizado PHP, puedes cambiarlo desde cPanel en la sección "Select PHP Version". Asegúrate de usar una versión compatible con tu PrestaShop (normalmente PHP 7.1 a 7.4 para versiones antiguas).

¿Cómo evito futuros errores de conexión?

Haz backups periódicos de la base de datos (cPanel tiene herramientas automáticas).
Mantén PrestaShop y los módulos actualizados.
No instales módulos de fuentes no confiables.
Supervisa el espacio en disco de tu hosting (si se llena, MySQL puede fallar).

Resumen y conclusión

Los problemas de error base datos PrestaShop cPanel pueden ser frustrantes, pero siguiendo estos pasos tendrás altas probabilidades de solucionarlos:

Verifica el servidor MySQL desde phpMyAdmin.
Revisa y corrige las credenciales en config/settings.inc.php.
Repara la base de datos desde phpMyAdmin si está corrupta.
Asigna todos los privilegios al usuario de la base de datos.
Comprueba el límite de conexiones con tu hosting.
Restaura un backup como último recurso.

Si después de todo esto el problema persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen acceso a los logs del servidor y pueden identificar problemas más profundos.

Recuerda: la paciencia es clave. Tómate tu tiempo para seguir cada paso, y muy pronto tu tienda PrestaShop volverá a funcionar a la perfección. ¡Ánimo!