Error de base de datos en PrestaShop cPanel: Solución

¡Hola! Soy tu técnico de soporte amigable. 😊

Entiendo que ver un error de base de datos en tu tienda PrestaShop puede ser frustrante, especialmente si no tienes experiencia técnica. Pero no te preocupes, es un problema muy común y, por lo general, tiene una solución sencilla.

En este artículo, te guiaré paso a paso para solucionar el temido error base datos PrestaShop cPanel. Aprenderás a diagnosticar por qué falla la conexión MySQL PrestaShop y cómo aplicar las soluciones más efectivas para solucionar DB PrestaShop.

Vamos a ello.

¿Qué significa este error y por qué aparece?

Cuando PrestaShop no puede conectar con su base de datos, normalmente ves un mensaje como "Error de conexión a la base de datos" o "Link to database cannot be established". Esto impide que tu tienda funcione.

Las causas más comunes son:

Credenciales incorrectas en el archivo de configuración.
El servidor MySQL está caído o no responde.
El usuario de la base de datos no tiene permisos adecuados.
El archivo settings.inc.php está dañado o mal configurado.
Problemas con el hosting (cPanel o Syspanel).

Vamos a revisar cada una.

Paso 1: Accede a tu panel de control (cPanel)

Primero, inicia sesión en tu panel de control. Si usas cPanel, la URL suele ser algo como tudominio.com/cpanel o te la proporcionó tu proveedor de hosting.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), accede a través de tudominio.com:2106 con tus credenciales.

Paso 2: Verifica que el servidor MySQL esté funcionando

A veces el problema es que el servicio MySQL se ha detenido.

En cPanel:

Busca la sección "Servicios" o "MySQL".
Haz clic en "MySQL Database Status" o similar.
Si ves un mensaje verde que dice "Running", está bien. Si está rojo o dice "Stopped", debes reiniciarlo.

Para reiniciar MySQL en cPanel:

Ve a "Administración de servicios" (Service Manager).
Busca "MySQL" en la lista.
Marca la casilla y haz clic en "Restart".

[WARNING] Si no ves esta opción, contacta a tu proveedor de hosting. No intentes reiniciar servicios si no estás seguro.

Paso 3: Revisa las credenciales en el archivo settings.inc.php

Este archivo contiene los datos de conexión a tu base de datos. Es el corazón de la configuración.

¿Dónde está?

En la raíz de tu instalación de PrestaShop, dentro de la carpeta config/. La ruta completa suele ser:

/public_html/config/settings.inc.php

Cómo editarlo:

Desde cPanel, usa el Administrador de Archivos (File Manager).
Navega a public_html/config/.
Busca el archivo settings.inc.php.
Haz clic derecho y selecciona "Editar" (o "Code Editor").

Dentro verás líneas como estas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_usuario_bd');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');

¿Qué debes verificar?

_DB_SERVER_: normalmente es localhost. Si tu hosting usa un servidor remoto, te lo indicarán.
_DB_NAME_: el nombre exacto de tu base de datos (suele ser usuario_nombrebd).
_DB_USER_: el usuario de la base de datos (suele ser usuario_nombreusuario).
_DB_PASSWD_: la contraseña correcta.

[TIP] Si no recuerdas estos datos, puedes obtenerlos desde cPanel en "MySQL Databases". Allí verás listadas tus bases de datos y usuarios.

Si cambiaste algo, guarda los cambios.

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

A veces el usuario existe pero no tiene permisos para acceder a la base de datos.

En cPanel:

Ve a "MySQL Databases".
Desplázate hasta "Usuarios en bases de datos".
Verás una tabla con los usuarios y las bases de datos asignadas.
Si tu usuario no aparece junto a tu base de datos, debes asignarlo:
- En "Agregar usuario a la base de datos", selecciona el usuario y la base de datos.
- Marca "TODOS LOS PRIVILEGIOS" (All Privileges).
- Haz clic en "Hacer cambios".

[WARNING] Si el usuario no existe, créalo primero en "Agregar nuevo usuario".

Paso 5: Comprueba si el archivo settings.inc.php está dañado

A veces el archivo se corrompe o tiene errores de sintaxis.

Solución:

Haz una copia de seguridad del archivo actual (descárgalo o renómbralo a settings.inc.php.backup).
Descarga una copia limpia desde tu instalación original de PrestaShop (misma versión).
Sube el archivo limpio a la carpeta config/.
Edítalo y coloca tus credenciales correctas (como en el Paso 3).

[INFO] Si no tienes una copia limpia, puedes generarla desde el instalador de PrestaShop, pero es más seguro pedir ayuda a tu hosting.

Paso 6: Verifica que el host MySQL sea correcto

Si tu hosting usa un servidor MySQL remoto (no localhost), debes cambiarlo en el archivo settings.inc.php.

¿Cómo saberlo?

En cPanel, en "MySQL Databases", a veces aparece la dirección del servidor (ej: mysql.tudominio.com).
Pregunta a tu proveedor de hosting.

Si es remoto, cambia _DB_SERVER_ de localhost a la dirección que te den.

Paso 7: Prueba la conexión manualmente (opcional)

Si aún tienes dudas, puedes probar la conexión desde phpMyAdmin (herramienta incluida en cPanel).

En cPanel, busca "phpMyAdmin".
Inicia sesión con las credenciales de tu base de datos.
Si puedes acceder, la conexión funciona. Si no, revisa los pasos anteriores.

[TIP] Si phpMyAdmin no abre, el problema puede ser del hosting. Contacta a soporte.

Paso 8: Verifica la versión de PHP y PrestaShop

A veces, una versión incompatible de PHP causa errores de conexión.

En cPanel:

Ve a "Seleccionar versión de PHP" (Select PHP Version).
Asegúrate de que la versión sea compatible con tu PrestaShop (ej: PrestaShop 1.7 funciona bien con PHP 7.4 u 8.0).
Si cambiaste la versión, reinicia el servicio.

[WARNING] No uses PHP 8.2 o superior si tu PrestaShop es antiguo, puede dar errores.

Paso 9: Revisa los logs de errores

Los logs pueden darte pistas precisas.

En cPanel:

Ve a "Registros de errores" (Error Log).
Busca errores relacionados con "MySQL", "database" o "PDO".
Copia el mensaje y compártelo con tu hosting si no entiendes.

Paso 10: Contacta a tu proveedor de hosting

Si después de todo esto el error persiste, es probable que sea un problema del servidor.

Qué decirles:

"Tengo un error base datos PrestaShop cPanel en mi tienda."
"Ya verifiqué credenciales, permisos y el archivo settings.inc.php."
"El servicio MySQL parece caído o no responde."

Ellos podrán revisar el servidor y solucionarlo.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error después de mover mi tienda a otro hosting?

Es muy común. Al cambiar de hosting, las credenciales de la base de datos cambian. Debes actualizar el archivo settings.inc.php con los nuevos datos.

¿Puedo perder datos si edito settings.inc.php?

No, mientras no borres la base de datos. Siempre haz una copia de seguridad antes de editar.

¿Qué hago si olvidé la contraseña de la base de datos?

En cPanel, ve a "MySQL Databases", busca tu usuario y haz clic en "Cambiar contraseña". Luego actualiza settings.inc.php.

¿El error puede deberse a un plugin o tema?

Sí, aunque es raro. Si el error aparece después de instalar un módulo, desactívalo desde la base de datos (cambiando el estado en phpMyAdmin).

¿Syspanel es lo mismo que cPanel?

No, pero funciona similar. En Syspanel (antes HestiaCP), accedes por el puerto 2106 (ej: tudominio.com:2106). Allí también tienes herramientas para gestionar bases de datos.

Resumen final

Para solucionar DB PrestaShop, sigue este orden:

Verifica que MySQL esté funcionando.
Revisa credenciales en settings.inc.php.
Asegura permisos del usuario.
Comprueba que el archivo no esté dañado.
Prueba la conexión en phpMyAdmin.
Revisa la versión de PHP.
Si nada funciona, pide ayuda a tu hosting.

Recuerda que la paciencia es clave. La mayoría de las veces es un error de tipeo o un servicio caído.

Espero que este artículo te haya sido útil. Si tienes más dudas, no dudes en dejar un comentario o contactar a soporte. ¡Buena suerte con tu tienda! 🚀