Error conexión base de datos PrestaShop en cPanel | Solución

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto es porque probablemente tu tienda PrestaShop ha mostrado el temido mensaje de error conexión PrestaShop y no sabes por dónde empezar. No te preocupes, es uno de los problemas más comunes y, con esta guía paso a paso, lo resolverás en pocos minutos. Vamos a ello.

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

Cuando PrestaShop no puede comunicarse con su base de datos, normalmente muestra un mensaje como “Error de conexión a la base de datos” o “Link to database cannot be established”. Esto puede deberse a varias causas, desde un cambio de contraseña hasta un fallo en el servidor. Lo importante es que no entres en pánico: la mayoría de las veces la solución es sencilla y no implica perder datos.

[INFO] La base de datos es donde PrestaShop guarda todos tus productos, pedidos, clientes y configuraciones. Sin ella, la tienda no puede funcionar.

Causas más comunes del error

Antes de lanzarnos a solucionarlo, identifiquemos las causas típicas:

Credenciales incorrectas en el archivo de configuración parameters.php o settings.inc.php.
El servicio de base de datos (MySQL/MariaDB) está detenido en el servidor.
El usuario de la base de datos no tiene permisos o fue eliminado.
El nombre de la base de datos o del servidor ha cambiado (por ejemplo, al migrar de hosting).
El archivo de configuración está dañado o es ilegible.
Problemas de firewall o conexión entre el servidor web y el de base de datos (si están separados).

Como trabajamos en un entorno cPanel PrestaShop (aunque también aplica a Syspanel/HestiaCP), usaremos las herramientas que nos ofrece el panel de control.

Paso 1: Verifica que el servicio MySQL/MariaDB esté activo

Lo primero es asegurarnos de que el motor de base de datos esté funcionando. En cPanel:

Inicia sesión en tu cPanel (normalmente tudominio.com/cpanel).
Busca la sección “Servicios” o “Estado del servidor”.
Localiza MySQL o MariaDB. Debe aparecer como “En ejecución” o “Running”.

Si ves que está detenido, contacta a tu proveedor de hosting para que lo reinicien. En algunos paneles como Syspanel (puerto 2106) también puedes ver el estado desde la sección de servicios.

[WARNING] No intentes reiniciar servicios si no tienes acceso root o permisos de administrador. En hosting compartido, esto solo lo puede hacer el soporte técnico.

Paso 2: Revisa las credenciales en el archivo de configuración

El error más frecuente es que las credenciales de acceso a la base de datos base de datos PrestaShop hayan cambiado o estén mal escritas. PrestaShop guarda esta información en dos archivos clave:

app/config/parameters.php (versiones modernas, 1.7+)
config/settings.inc.php (versiones antiguas, 1.6 o anteriores)

2.1 Accede al archivo mediante FTP o el administrador de archivos de cPanel

En cPanel, ve a “Administrador de archivos”.
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html).
Busca el archivo según tu versión.

2.2 Abre el archivo y verifica estos datos

En parameters.php buscarás una sección como esta:

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

En settings.inc.php es similar:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_basededatos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASS_', 'tu_contraseña');

[TIP] Si no recuerdas tus credenciales actuales, puedes consultarlas en cPanel: ve a “Bases de datos MySQL” y allí verás los usuarios y bases de datos creadas. Si no hay ninguna, tendrás que crearlas de nuevo (más adelante te explico).

¿Qué hago si las credenciales son incorrectas?
Simplemente edita el archivo con los valores correctos. Guarda los cambios y vuelve a cargar tu tienda. Si el error persiste, continúa con el siguiente paso.

Paso 3: Comprueba los permisos del usuario de la base de datos

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para acceder a la base de datos. En cPanel:

Ve a “Bases de datos MySQL”.
En la sección “Usuarios en bases de datos”, verifica que tu usuario esté asociado a la base de datos correcta.
Si no lo está, asígnalo y otórgale todos los privilegios (marca la casilla “TODOS LOS PRIVILEGIOS”).
Haz clic en “Realizar cambios”.

[INFO] En Syspanel (puerto 2106), el proceso es similar: busca “Base de datos” y luego “Asignar usuario a base de datos”.

Paso 4: Verifica que el nombre del servidor de base de datos sea correcto

La mayoría de los hosting usan localhost como servidor de base de datos. Sin embargo, algunos proveedores (como los que usan servidores separados) te dan un nombre como mysql.tudominio.com o una IP. Si cambiaste de hosting recientemente, este valor puede haber cambiado.

Si en tu cPanel ves algo como “Servidor MySQL” o “Host”, anótalo.
Edita el archivo de configuración de PrestaShop y reemplaza 'localhost' por ese valor.

Paso 5: Restaura la base de datos desde una copia de seguridad

Si los pasos anteriores no funcionan, es posible que la base de datos esté corrupta o haya sido eliminada accidentalmente. En ese caso, necesitarás restaurar una copia de seguridad.

5.1 Localiza tu copia de seguridad

En cPanel, busca “Copias de seguridad” o “Backup”.
Descarga la copia más reciente de la base de datos (suele ser un archivo .sql o .gz).

5.2 Restaura la base de datos

Ve a “phpMyAdmin” en cPanel.
Selecciona la base de datos de tu tienda (si no existe, créala con el mismo nombre).
Haz clic en “Importar”.
Sube el archivo .sql y ejecuta la importación.

[WARNING] Si no tienes copia de seguridad, contacta a tu hosting. Algunos proveedores guardan copias automáticas de los últimos 7 días.

Paso 6: Reconstruye el archivo de configuración (solución avanzada)

Si el archivo parameters.php está dañado o no se puede leer, puedes regenerarlo. Esto es más común en migraciones o actualizaciones fallidas.

6.1 Crea un archivo nuevo desde cero

Conéctate por FTP o al administrador de archivos.
Renombra el archivo actual (por ejemplo, parameters_old.php) para tener un respaldo.
Crea un nuevo archivo llamado parameters.php con el siguiente contenido (ajustando los valores):

<?php
return array(
  'database_host' => 'localhost',
  'database_port' => '3306',
  'database_name' => 'tu_basededatos',
  'database_user' => 'tu_usuario',
  'database_password' => 'tu_contraseña',
  'database_prefix' => 'ps_',
  // ... otros parámetros que puedas necesitar
);

[TIP] Puedes obtener el resto de parámetros de una instalación limpia de PrestaShop (misma versión) o del archivo parameters.php de respaldo si lo tienes.

6.2 Ajusta los permisos del archivo

Asegúrate de que el archivo tenga permisos 644 (lectura para todos, escritura solo para el propietario). En cPanel, haz clic derecho sobre el archivo y selecciona “Cambiar permisos”.

Paso 7: Verifica el firewall o conectividad (casos especiales)

En entornos donde el servidor web y el de base de datos están en máquinas diferentes (por ejemplo, hosting con servidores separados), puede haber un bloqueo de firewall. Esto es poco común en cPanel estándar, pero si usas Syspanel (puerto 2106) o un VPS, verifica:

Que el puerto 3306 (MySQL) esté abierto entre ambos servidores.
Que el host de base de datos no esté en una lista negra.

Consulta con tu proveedor si sospechas de esto.

FAQ: Preguntas frecuentes sobre el error de conexión

P: ¿Pierdo mis productos/pedidos si restauro la base de datos?
R: Sí, si restauras una copia antigua perderás los datos posteriores a esa copia. Por eso es importante tener backups frecuentes. Si solo cambiaste credenciales, no perderás nada.

P: ¿Puedo evitar este error en el futuro?
R: Sí, te recomiendo:

Hacer backups semanales de la base de datos.
Anotar las credenciales en un lugar seguro.
No modificar archivos de configuración sin hacer una copia previa.

P: ¿Qué hago si después de todo sigue el error?
R: Puede ser un problema más profundo del servidor. Contacta al soporte técnico de tu hosting y diles que has verificado credenciales, permisos y estado del servicio. Ellos podrán revisar logs del servidor.

P: ¿Esto afecta al SEO de mi tienda?
R: Sí, mientras la tienda esté caída, los motores de búsqueda pueden penalizarla. Por eso es crucial resolverlo rápido. Una vez solucionado, verifica que todo funcione y, si fue prolongado, considera notificar a Google Search Console.

Conclusión: Ya tienes las herramientas para solucionarlo

El error conexión PrestaShop es frustrante, pero siguiendo esta guía paso a paso podrás identificarlo y resolverlo. Recuerda siempre:

Revisar primero las credenciales.
Verificar que el servicio MySQL esté activo.
Tener a mano una copia de seguridad.
No modificar archivos sin respaldo.

Si tu hosting usa Syspanel (accesible por puerto 2106), los pasos son equivalentes: busca las secciones de bases de datos y archivos. Y si en algún momento te sientes perdido, recuerda que el soporte técnico de tu proveedor está para ayudarte.

¡Espero que tu tienda vuelva a funcionar en un abrir y cerrar de ojos! Si te quedó alguna duda, déjala en los comentarios (si este artículo está en un blog) o consulta con tu hosting. ¡Buena suerte!