Solucionar error de base de datos en PrestaShop con cPanel

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí, seguramente tu tienda PrestaShop ha dejado de funcionar y ves un mensaje como “Error de conexión a la base de datos” o “Link to database cannot be established”. No te preocupes, es un problema común y solucionable. En esta guía te explicaré paso a paso cómo resolver el error de conexión a base de datos en PrestaShop usando cPanel. Vamos a ello.

¿Por qué ocurre este error en PrestaShop?

El error de conexión a base de datos en PrestaShop suele deberse a que el archivo de configuración app/config/parameters.php (o config/settings.inc.php en versiones antiguas) tiene datos incorrectos o porque la base de datos en sí tiene problemas. Las causas más frecuentes son:

Cambiaste la contraseña de la base de datos en cPanel.
Moviste tu tienda a otro servidor o cuenta de hosting.
La base de datos se ha dañado o está corrupta.
El usuario de la base de datos no tiene permisos suficientes.
El servidor MySQL se ha reiniciado o está sobrecargado.

Voy a guiarte para que verifiques cada punto. Recuerda: siempre trabaja con calma y, si puedes, haz una copia de seguridad antes de modificar archivos.

Requisitos previos

Antes de empezar, asegúrate de tener acceso a:

cPanel de tu hosting (el panel de control donde gestionas tu sitio).
Gestor de archivos o un cliente FTP (como FileZilla).
phpMyAdmin (dentro de cPanel) para revisar la base de datos.
Una copia de seguridad reciente de tu tienda y base de datos. Si no la tienes, hazla ahora desde cPanel > “Copias de seguridad”.

[WARNING] No modifiques archivos sin respaldo. Un error puede dejar tu tienda inaccesible.

Paso 1: Verifica los datos de conexión en el archivo de configuración

El primer lugar donde revisar es el archivo que guarda los datos de acceso a la base de datos. Dependiendo de la versión de PrestaShop, el archivo se encuentra en una ruta u otra.

Para PrestaShop 1.7 y superiores (recomendado)

Accede a cPanel > Administrador de archivos (o mediante FTP) y navega hasta la carpeta raíz de tu tienda (por ejemplo, public_html o tu-dominio). Luego ve a:

app/config/parameters.php

Ábrelo con el editor de texto de cPanel (clic derecho > “Editar”). Busca estas líneas:

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

Anota estos valores. Si ves algo como 'database_host' => '127.0.0.1' también es válido. Lo importante es que coincidan con los datos reales de tu base de datos en cPanel.

Para PrestaShop 1.6 y anteriores

El archivo es config/settings.inc.php en la raíz. Busca líneas como:

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

[TIP] Si no encuentras los archivos, asegúrate de que no estén ocultos. En cPanel, activa la opción “Mostrar archivos ocultos” (dotfiles).

Paso 2: Compara con los datos reales de cPanel

Ahora ve a cPanel > Bases de datos MySQL. Allí verás una lista de bases de datos y usuarios. Asegúrate de que:

El nombre de la base de datos (database_name) exista exactamente igual (incluyendo mayúsculas/minúsculas y el prefijo de usuario, por ejemplo tucpanel_tienda).
El usuario (database_user) esté creado y tenga todos los privilegios sobre esa base de datos.
La contraseña sea correcta. Si no la recuerdas, puedes cambiarla desde cPanel > Bases de datos MySQL > “Cambiar contraseña”.

Si los datos no coinciden, edita el archivo parameters.php o settings.inc.php con los valores correctos. Guarda los cambios.

[INFO] En cPanel, los nombres de bases de datos y usuarios suelen tener un prefijo con tu nombre de usuario de cPanel (ej: usuario_bd). No olvides incluirlo.

Paso 3: Verifica que el servidor de base de datos esté funcionando

A veces el servidor MySQL está caído o sobrecargado. Para comprobarlo:

En cPanel, busca “Estado del servidor” o “MySQL” en la sección de “Información del servidor”.
También puedes usar phpMyAdmin (en cPanel). Si se abre sin errores, el servidor funciona.
Si no puedes acceder a phpMyAdmin, contacta a tu proveedor de hosting.

Si el servidor está bien, pasamos al siguiente paso.

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

Un usuario sin permisos completos también produce este error. Para otorgar todos los privilegios:

En cPanel, ve a Bases de datos MySQL.
En la sección “Usuarios en bases de datos”, busca tu usuario y base de datos.
Haz clic en “Administrar privilegios” (o “Añadir usuario a la base de datos” si no está asignado).
Marca TODOS LOS PRIVILEGIOS (o “ALL PRIVILEGES”) y guarda.

[WARNING] Si usas un hosting compartido, algunos proveedores restringen ciertos privilegios. En ese caso, contacta a soporte.

Paso 5: Repara la base de datos si está corrupta

A veces la base de datos se daña por cortes de energía o errores. Para repararla:

Abre phpMyAdmin desde cPanel.
Selecciona tu base de datos (en el panel izquierdo).
Marca la casilla “Seleccionar todo” (o elige todas las tablas).
En el menú desplegable “Con seleccionados:”, elige “Reparar tabla”.
Espera a que termine. Si hay errores graves, verás un mensaje.

Si la reparación falla, puedes intentar restaurar una copia de seguridad desde cPanel > “Copias de seguridad” > “Restaurar una copia de seguridad de la base de datos”.

Paso 6: Verifica el archivo .htaccess (si el error persiste)

En casos raros, el error puede estar relacionado con la redirección. Asegúrate de que el archivo .htaccess en la raíz de PrestaShop no esté corrupto. Si tienes dudas, renómbralo a .htaccess_old y luego ve a Parámetros de la tienda > Tráfico y SEO > URL en el back office de PrestaShop (si puedes acceder) y guarda de nuevo para regenerarlo.

Si no puedes acceder al back office, puedes descargar un .htaccess limpio de la instalación original de PrestaShop y subirlo.

Paso 7: Prueba con valores alternativos para el host

Si todo lo anterior falla, prueba cambiando 'database_host' de 'localhost' a '127.0.0.1' o viceversa. Algunos servidores requieren una dirección IP explícita. También puedes preguntar a tu hosting si usan un host remoto (por ejemplo, mysql.tudominio.com).

Paso 8: Contacta a tu proveedor de hosting

Si después de todos estos pasos el error persiste, es posible que haya un problema en el servidor (como límites de conexión, firewall o MySQL detenido). Proporciónales la siguiente información:

Mensaje de error exacto.
Pasos que ya realizaste.
Captura de pantalla del error (si es posible).

[TIP] Muchos hostings tienen soporte 24/7. No dudes en pedir ayuda.

Preguntas frecuentes (FAQ)

¿Por qué veo el error después de cambiar la contraseña de la base de datos?

Porque el archivo de configuración de PrestaShop aún tiene la contraseña anterior. Sigue el Paso 1 y 2 para actualizarla.

¿Puedo usar un editor de texto como Notepad++ para modificar parameters.php?

Sí, pero asegúrate de guardar el archivo sin formato (UTF-8 sin BOM) y súbelo por FTP. Es más seguro usar el editor de cPanel.

¿Qué hago si no tengo acceso a cPanel?

Pide a tu proveedor de hosting que te dé acceso o que ellos mismos verifiquen los datos de conexión. También puedes usar FTP para editar los archivos, pero necesitarás la contraseña de la base de datos.

¿El error puede deberse a un plugin o tema?

Sí, pero es menos común. Si el error aparece después de instalar un módulo, desactívalo renombrando la carpeta modules/nombre_modulo a modules/nombre_modulo_old mediante FTP.

¿Cómo evito este error en el futuro?

Guarda siempre las contraseñas en un gestor de contraseñas.
Haz copias de seguridad periódicas (automáticas si es posible).
Antes de cambiar datos de la base de datos, actualiza primero el archivo de configuración.

Resumen final

El error de conexión a base de datos en PrestaShop se soluciona generalmente verificando y corrigiendo los datos en parameters.php o settings.inc.php, asegurando que el usuario tenga permisos y que la base de datos no esté dañada. Con cPanel tienes todas las herramientas necesarias: Administrador de archivos, phpMyAdmin y Bases de datos MySQL.

Si sigues esta guía paso a paso, en la mayoría de los casos recuperarás tu tienda en pocos minutos. Recuerda mantener la calma y trabajar con respaldos. ¡Mucho éxito con tu PrestaShop!

[INFO] ¿Usas Syspanel (antes HestiaCP)? El acceso a la base de datos es similar, pero el puerto de administración es el 2106. En ese panel busca “Base de datos” y luego “phpMyAdmin” para gestionar tus tablas.

Si tienes más dudas, puedes dejar un comentario o contactar a nuestro equipo de soporte. ¡Estamos para ayudarte!