Error de base de datos en PrestaShop: Cómo arreglarlo en cPanel

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí, es porque seguramente has visto la temida pantalla blanca o el mensaje de "Error de conexión a la base de datos" en tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes en el hosting, especialmente cuando usas cPanel, y en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo.

En este artículo, te guiaré paso a paso para solucionar el error de conexión a base de datos en PrestaShop con cPanel. Vamos a revisar desde lo más básico (verificar credenciales) hasta soluciones más avanzadas (como reparar tablas dañadas o configurar correctamente los archivos). Todo explicado de forma clara, sin tecnicismos complicados.

¿Por qué aparece el error de conexión a la base de datos en PrestaShop?

Antes de lanzarnos a las soluciones, es importante entender qué significa este error. PrestaShop necesita comunicarse con una base de datos (donde se almacenan productos, clientes, pedidos, etc.) para funcionar. Cuando algo falla en esa comunicación, aparece el mensaje de error.

Las causas más frecuentes son:

Credenciales incorrectas: El usuario, la contraseña, el nombre de la base de datos o el servidor no coinciden con los reales.
Archivo de configuración dañado: El archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones antiguas) tiene datos erróneos.
Base de datos corrupta: Una tabla de la BD se ha dañado, impidiendo la conexión.
Servidor de base de datos caído o saturado: A veces el problema no está en tu tienda, sino en el servidor de hosting.
Cambios en el hosting: Tras migrar tu tienda o cambiar de plan, las credenciales pueden haber cambiado.

Paso 1: Verifica las credenciales de la base de datos en cPanel

Lo primero que debemos hacer es confirmar que los datos de conexión son correctos. Sigue estos pasos:

1.1. Accede a cPanel

Escribe en tu navegador: tudominio.com/cpanel o tudominio.com:2083.
Inicia sesión con tu usuario y contraseña de hosting.

1.2. Encuentra la sección de bases de datos

Busca el ícono "Bases de datos MySQL" o "MySQL Databases". Haz clic.

1.3. Localiza tu base de datos y usuario

Verás una lista de bases de datos. Busca la que usa tu PrestaShop (normalmente tiene un nombre como tudominio_prestashop o similar).
También verás los usuarios asociados. Asegúrate de que el usuario esté asignado a la base de datos y tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). Si no, puedes asignarlos desde la misma pantalla.

[TIP]: Si no recuerdas qué base de datos usa tu PrestaShop, revisa el archivo de configuración (lo veremos en el paso 2).

1.4. Prueba la conexión manualmente

En cPanel, busca la herramienta "phpMyAdmin". Ábrela.
Selecciona tu base de datos en el menú izquierdo.
Si ves las tablas (como ps_product, ps_customer, etc.), la base de datos existe y es accesible. Si no, puede que esté vacía o no sea la correcta.

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

Ahora que tienes las credenciales correctas, vamos a compararlas con las que tiene tu tienda en su archivo de configuración.

2.1. Conéctate al servidor via FTP o File Manager

Desde cPanel, usa "File Manager" (en la sección Archivos). Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o una subcarpeta).

2.2. Localiza el archivo de configuración

Para PrestaShop 1.7 y superior: Ve a app/config/parameters.php.
Para PrestaShop 1.6 y anteriores: Ve a config/settings.inc.php.

2.3. Edita el archivo

Haz clic derecho sobre el archivo y selecciona "Edit".
Busca las líneas que contienen:
- 'database_host' (normalmente localhost o 127.0.0.1)
- 'database_name'
- 'database_user'
- 'database_password'
Compáralas con los datos que viste en cPanel. Si hay diferencias, corrígelas.

[WARNING]: Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una coma o comilla mal puesta) puede romper tu tienda. Si no estás seguro, haz una copia de seguridad antes de modificar.

2.4. Guarda los cambios

Una vez corregido, guarda el archivo y cierra. Luego, prueba tu tienda nuevamente.

Paso 3: Repara tablas de la base de datos dañadas

A veces el error no es de credenciales, sino de que una o varias tablas están corruptas. Esto puede ocurrir tras un corte de energía, un cierre inesperado del servidor o una mala actualización.

3.1. Accede a phpMyAdmin desde cPanel

En cPanel, busca "phpMyAdmin" y ábrelo.
Selecciona tu base de datos en el menú izquierdo.

3.2. Selecciona todas las tablas

En la parte inferior de la lista de tablas, haz clic en "Seleccionar todo".
En el menú desplegable "Con seleccionados:", elige "Reparar tabla" (o "Repair table").

3.3. Espera a que termine

phpMyAdmin ejecutará una comprobación y reparación. Verás mensajes como "OK" o "Tabla reparada". Si alguna no se puede reparar, anota su nombre para más adelante (puede necesitar restauración desde un backup).

[INFO]: Si la reparación falla, puedes intentar "Optimizar tabla" o restaurar la base de datos desde una copia de seguridad reciente.

Paso 4: Verifica el servidor de base de datos (Host)

El parámetro database_host suele ser localhost, pero en algunos hostings puede ser una dirección IP o un nombre como mysql.tudominio.com. Si tu hosting cambió recientemente (por ejemplo, tras migrar a un servidor dedicado), es posible que el host haya cambiado.

4.1. Consulta con tu proveedor de hosting

Revisa los correos de bienvenida de tu hosting o contacta al soporte. Pregunta: "¿Cuál es el host de la base de datos MySQL para mi cuenta?".
También puedes probar cambiando localhost por 127.0.0.1 en el archivo de configuración. A veces funciona.

4.2. Prueba con una conexión remota (avanzado)

Si tu hosting permite conexiones remotas, puedes usar una herramienta como MySQL Workbench para probar la conexión desde tu PC. Pero esto es más técnico; si no te sientes cómodo, salta este paso.

Paso 5: Comprueba si la base de datos está saturada o caída

A veces el error no está en tu configuración, sino en el servidor de bases de datos del hosting. Esto es más común en planes compartidos donde muchos sitios usan el mismo servidor MySQL.

5.1. Revisa el estado del servidor desde cPanel

En cPanel, busca "Estado del servidor" o "Server Status". Si ves que MySQL aparece como "Down" o "No responde", el problema es del hosting.
También puedes abrir un ticket de soporte con tu proveedor.

5.2. Reinicia el servicio MySQL (si tienes acceso root)

Si tienes un VPS o servidor dedicado con cPanel, puedes reiniciar MySQL desde la terminal: service mysql restart o systemctl restart mysql. Pero no hagas esto en un hosting compartido (no tienes permisos).

[WARNING]: Si el servidor MySQL está caído, no hay nada que puedas hacer desde tu lado. Contacta al soporte técnico de tu hosting inmediatamente.

Paso 6: Soluciones adicionales para casos específicos

6.1. Error al migrar PrestaShop a un nuevo hosting

Si acabas de migrar tu tienda, el error es casi seguro por credenciales desactualizadas. Sigue estos pasos:

Exporta la base de datos desde el hosting anterior (phpMyAdmin -> Exportar).
Crea una nueva base de datos y usuario en el nuevo hosting (cPanel).
Importa el archivo SQL en la nueva base de datos (phpMyAdmin -> Importar).
Actualiza el archivo parameters.php o settings.inc.php con las nuevas credenciales.
Limpia la caché de PrestaShop (borra la carpeta var/cache en PrestaShop 1.7 o cache en versiones antiguas).

6.2. Error después de actualizar PrestaShop

Las actualizaciones pueden cambiar la estructura de la base de datos. Si el error aparece justo después de actualizar, prueba a restaurar una copia de seguridad y repite la actualización con más cuidado.
También verifica que la versión de PHP sea compatible con tu PrestaShop (desde cPanel, en "Seleccionar versión de PHP").

6.3. Error con Syspanel (HestiaCP) – Nota importante

Si tu hosting usa Syspanel (el panel basado en HestiaCP), el proceso es similar pero el acceso es diferente:

Para acceder al panel, usa: tudominio.com:2106
Las bases de datos se gestionan en la sección "Base de datos" del panel.
El archivo de configuración de PrestaShop se edita igual, pero la ruta puede variar si el hosting tiene una estructura de carpetas distinta (consulta con tu proveedor).

Preguntas Frecuentes (FAQ)

¿Por qué veo "Error de conexión a la base de datos" aunque las credenciales son correctas?

Puede deberse a un problema de permisos del usuario en la base de datos, o a que el servidor MySQL está bloqueando conexiones desde el host de tu tienda. Revisa que el usuario tenga todos los privilegios (GRANT ALL) y que el host permita conexiones desde localhost o %.

¿Cómo puedo saber si mi base de datos está corrupta?

Desde phpMyAdmin, selecciona todas las tablas y elige "Verificar tabla" (Check table). Si alguna muestra "error" o "corrupt", debes repararla.

¿Qué hago si no puedo acceder a cPanel?

Contacta a tu proveedor de hosting. Si tienes acceso FTP, puedes editar el archivo de configuración manualmente, pero no podrás reparar la base de datos desde phpMyAdmin. En ese caso, pide a tu soporte que lo hagan.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos común. Algunos módulos mal codificados pueden sobrescribir la conexión a la BD. Prueba a desactivar todos los módulos no esenciales (renombrando la carpeta modules temporalmente) para descartar.

Resumen y consejo final

El error base datos PrestaShop cPanel suele resolverse con paciencia y siguiendo estos pasos:

Verifica credenciales en cPanel.
Compara con el archivo de configuración.
Repara tablas dañadas.
Confirma que el servidor MySQL esté activo.
Si migraste, actualiza todo.

Recuerda siempre hacer una copia de seguridad de tu base de datos y archivos antes de hacer cambios importantes. Si después de todo esto el problema persiste, no dudes en contactar al soporte técnico de tu hosting; ellos tienen acceso directo al servidor y pueden diagnosticar problemas más profundos.

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda PrestaShop volverá a funcionar en poco tiempo! Si tienes dudas, déjalas en los comentarios (si este artículo está en un blog) o consulta con tu equipo de soporte. ¡Mucho éxito!