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

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

Si ves un mensaje como "Error de conexión a la base de datos" en tu tienda PrestaShop, no entres en pánico. Es uno de los problemas más comunes y, por suerte, casi siempre tiene solución rápida. Este error suele aparecer cuando PrestaShop no puede comunicarse con MySQL, el motor de base de datos que almacena toda la información de tu tienda: productos, clientes, pedidos, etc.

Las causas pueden ser varias: desde un cambio de contraseña hasta un fallo en el servidor o una mala configuración en el archivo settings.inc.php. Como técnico de soporte, te guiaré paso a paso para que puedas solucionar DB PrestaShop cPanel sin necesidad de ser un experto.

Lo primero: identifica el tipo de error

Antes de empezar, observa bien el mensaje. Puede ser de dos tipos:

Error al cargar la tienda (tanto en el frontend como en el backend).
Error al instalar o migrar PrestaShop.

En ambos casos, el procedimiento es similar, pero la causa concreta puede variar. Vamos a ver las soluciones más comunes para problemas MySQL PrestaShop.

Solución 1: Verifica los datos de conexión en el archivo settings.inc.php

El archivo más importante para la conexión a la base de datos en PrestaShop es settings.inc.php. Se encuentra en la carpeta config/ de tu instalación de PrestaShop. Este archivo contiene el nombre de la base de datos, el usuario, la contraseña y el servidor.

Pasos para revisarlo desde cPanel:

Accede a tu cPanel (generalmente tudominio.com/cpanel).
Busca la sección Archivos y haz clic en Administrador de archivos.
Navega hasta la carpeta de tu tienda (por ejemplo, public_html o prestashop).
Abre la carpeta config/.
Busca el archivo settings.inc.php y haz clic derecho > Editar (o Ver/Editar).
Busca las líneas que empiezan con define('_DB_SERVER_', define('_DB_NAME_', define('_DB_USER_' y define('_DB_PASSWD_'.

Deben verse así:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_usuario_basededatos');
define('_DB_USER_', 'tu_usuario_basededatos');
define('_DB_PASSWD_', 'tu_contraseña');

[WARNING] Nunca uses comillas dobles dentro de los valores. Si tu contraseña contiene caracteres especiales como $, " o \, escríbelos exactamente como están en cPanel.

¿Qué hago si los datos son incorrectos?

Si cambiaron la contraseña de la base de datos desde cPanel (por ejemplo, por seguridad), debes actualizar este archivo. Ve a cPanel > Bases de datos > MySQL Databases y busca la contraseña actual del usuario. Luego edita settings.inc.php con la nueva.

Solución 2: Comprueba que la base de datos y el usuario existan en cPanel

A veces, el error ocurre porque la base de datos fue eliminada accidentalmente o el usuario perdió los permisos. Para verificarlo:

En cPanel, ve a Bases de datos > MySQL Databases.
Busca el nombre de tu base de datos en la lista Bases de datos actuales.
Busca el usuario en Usuarios actuales.
Asegúrate de que el usuario esté asignado a la base de datos. Si no lo ves, selecciona el usuario y la base de datos en la sección Agregar usuario a la base de datos y haz clic en Agregar.
Luego, asigna todos los privilegios (marca TODOS LOS PRIVILEGIOS).

[TIP] Si no recuerdas el nombre exacto de la base de datos, revisa el archivo settings.inc.php que vimos antes. Allí está el nombre exacto.

Solución 3: Verifica el servidor de la base de datos (host)

En la mayoría de los casos, el servidor de la base de datos es localhost. Sin embargo, algunos proveedores de hosting usan un servidor remoto (como mysql.tudominio.com). Si cambiaste de hosting o migraste la tienda, este valor puede estar mal.

En cPanel, ve a Bases de datos > MySQL Databases.
Busca el texto Servidor MySQL o Host. Normalmente aparece como localhost o una IP.
Compara con el valor en settings.inc.php en la línea define('_DB_SERVER_', ...).
Si son diferentes, edita el archivo con el valor correcto.

[INFO] Si tu hosting usa Syspanel (antes HestiaCP), recuerda que el puerto de acceso es el 2106. No obstante, para la conexión de PrestaShop a MySQL, el puerto suele ser el 3306 por defecto. Si tienes dudas, consulta con tu proveedor.

Solución 4: Reinicia el servicio MySQL desde cPanel

A veces, el servicio MySQL se cae o se satura. Puedes reiniciarlo desde cPanel:

Ve a Servicios o Administración de servicios (puede variar según el tema de cPanel).
Busca MySQL o MariaDB.
Haz clic en Reiniciar.

Si no ves esta opción, contacta a tu proveedor de hosting, ya que en algunos planes compartidos no tienes acceso directo.

[WARNING] Reiniciar MySQL puede causar una breve interrupción en tu tienda (unos segundos). Hazlo en horas de bajo tráfico.

Solución 5: Revisa los logs de errores de MySQL

Si el error persiste, revisa los logs para obtener más detalles. En cPanel:

Ve a Métricas > Errores o Logs de errores.
Busca entradas relacionadas con MySQL o PrestaShop.
Los errores comunes incluyen:
- "Access denied for user": Contraseña incorrecta o usuario sin permisos.
- "Can't connect to MySQL server": El servidor no está corriendo o el host es incorrecto.
- "Unknown database": La base de datos no existe.

Si ves alguno de estos, vuelve a las soluciones 1, 2 o 3.

Solución 6: Restaura la base de datos desde una copia de seguridad

Si todo lo anterior falla, puede que la base de datos esté corrupta. Si tienes una copia de seguridad reciente (recomiendo hacerlas semanalmente), puedes restaurarla:

En cPanel, ve a Bases de datos > phpMyAdmin.
Selecciona tu base de datos (a la izquierda).
Haz clic en Importar.
Sube el archivo .sql de tu copia de seguridad.
Haz clic en Continuar.

[WARNING] Esto sobrescribirá todos los datos actuales. Asegúrate de que la copia sea reciente.

Si no tienes copia, contacta a tu proveedor de hosting, ya que algunos mantienen backups automáticos.

Solución 7: Verifica la versión de PHP y MySQL

PrestaShop requiere versiones específicas de PHP y MySQL. Por ejemplo, PrestaShop 1.7 funciona con PHP 7.1 a 8.0 y MySQL 5.6+ o MariaDB 10.1+. Si tu hosting actualizó PHP y tu tienda es antigua, puede dar error.

En cPanel, ve a Software > Seleccionar versión de PHP.
Elige una versión compatible con tu PrestaShop (consulta la documentación oficial).
Guarda los cambios.

[TIP] Si usas Syspanel (puerto 2106), la configuración de PHP se hace desde el panel de administración del servidor. Pregunta a tu proveedor si tienes dudas.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error de conexión a la base de datos" después de cambiar la contraseña de cPanel?

Es muy común. Al cambiar la contraseña de la base de datos desde cPanel, el archivo settings.inc.php no se actualiza automáticamente. Debes editarlo manualmente (Solución 1).

¿Puedo solucionar este error sin acceso a cPanel?

Si no tienes acceso a cPanel, necesitarás conectarte por FTP para editar settings.inc.php o pedir ayuda a tu proveedor de hosting. Sin embargo, la mayoría de los pasos requieren cPanel.

¿Qué hago si el error aparece solo en el backoffice (admin)?

Prueba a limpiar la caché de PrestaShop. A veces, una caché corrupta da falsos errores. Ve a Parámetros de la tienda > Rendimiento y limpia la caché. Si no puedes acceder al backoffice, borra manualmente la carpeta cache/ desde FTP.

¿Es seguro editar settings.inc.php?

Sí, siempre que respetes la sintaxis PHP. No borres líneas ni añadas espacios extra. Si tienes dudas, haz una copia de seguridad del archivo antes de editarlo.

¿Cómo evito este error en el futuro?

Realiza copias de seguridad periódicas de la base de datos.
No cambies contraseñas sin actualizar el archivo de configuración.
Mantén PrestaShop y sus módulos actualizados.
Usa contraseñas seguras pero anótalas en un lugar seguro.

Resumen final

El error conexión base datos PrestaShop es frustrante, pero en el 90% de los casos se soluciona revisando los datos en settings.inc.php o verificando que la base de datos y el usuario existan en cPanel. Si sigues estos pasos en orden, lo más probable es que tu tienda vuelva a funcionar en minutos.

Recuerda: si tu hosting usa Syspanel (puerto 2106), la lógica es la misma, solo cambia la interfaz. Y si después de todo el error persiste, no dudes en contactar al soporte técnico de tu proveedor: ellos tienen acceso directo a los logs del servidor.

¡Buena suerte con tu tienda PrestaShop!