Error de conexión a base de datos en PrestaShop: Solución (cPanel/Plesk)

¡Vaya, qué susto! Estás en medio de la tienda online, intentando entrar al panel de administración de PrestaShop o quizás un cliente te acaba de llamar porque la web muestra un mensaje en blanco o un error crítico que dice algo como "No se puede conectar a la base de datos".

Respira hondo. Este es uno de los errores más comunes en PrestaShop, pero también uno de los que tiene solución más directa si sabes dónde mirar. La buena noticia es que, en la gran mayoría de los casos, no has perdido tus productos ni tus pedidos. Los datos siguen ahí, en el servidor de MySQL; simplemente hay un problema de comunicación entre tu tienda (PHP) y el motor de base de datos.

En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles y, lo más importante, cómo solucionar el error de conexión a la base de datos en PrestaShop, tanto si tu hosting usa cPanel como si usa Plesk. Al final, tendrás un plan de acción claro para volver a estar online.

¿Por qué aparece el error "No se puede conectar a la base de datos"?

Antes de lanzarnos a tocar archivos, es fundamental entender qué significa este mensaje. PrestaShop necesita tres datos para conectarse a MySQL: el servidor de base de datos (normalmente localhost), el nombre de usuario y la contraseña. Esos datos están guardados en un archivo de configuración llamado parameters.php (en versiones modernas) o settings.inc.php (en versiones antiguas).

Cuando ves el error error conexión base de datos PrestaShop, significa que PHP ha intentado usar esos datos y MySQL los ha rechazado o no ha podido establecer la comunicación. Las causas más habituales son:

Cambio de contraseña de la base de datos (manual o por caducidad).
Cambio de servidor o de plan de hosting (y los datos no se actualizaron).
Corrupción del archivo parameters.php.
Problemas con el servidor MySQL (caído, sobrecargado o bloqueado).
Errores de caché en PrestaShop que guardan datos antiguos de conexión.

Vamos a atacar cada una de ellas, primero con la solución más sencilla y luego con las más técnicas.

Fase 1: La solución rápida y no destructiva (Borrar caché)

A veces, el error no es real. PrestaShop guarda archivos de caché que almacenan configuraciones temporales. Si la base de datos ha cambiado ligeramente o hubo un corte de luz, la caché puede estar apuntando a datos obsoletos.

¿Cómo limpiar la caché manualmente?

No necesitas acceder a la base de datos para esto, solo al administrador de archivos de tu hosting.

Accede a tu panel de control (cPanel o Plesk) y abre el Administrador de Archivos.
Navega hasta la raíz de tu tienda PrestaShop (la carpeta pública, normalmente public_html).
Busca la carpeta llamada var/cache (en PrestaShop 1.7 y 1.8) o cache (en PrestaShop 1.6).
Dentro de esa carpeta, encontrarás subcarpetas como dev o prod. Entra en la que corresponda a tu entorno (normalmente prod).
Selecciona todos los archivos dentro de esa carpeta y bórralos. No borres la carpeta en sí, solo su contenido (archivos .php o .cache).

[TIP] Si no ves archivos, activa la opción "Mostrar archivos ocultos" en la configuración del Administrador de Archivos.

Después de borrar la caché, intenta recargar tu tienda. Si el error persiste, el problema es más profundo y vamos a por la causa raíz.

Fase 2: Verificar los datos de acceso en cPanel y Plesk

Esta es la causa más frecuente. PrestaShop no conecta a MySQL porque la contraseña que tiene guardada ya no es válida. Para solucionarlo, debemos comprobar los datos actuales y luego actualizarlos en el archivo de configuración.

Paso A: Localizar las credenciales correctas en cPanel

Inicia sesión en tu cPanel.
Busca la sección "Bases de Datos" y haz clic en "Bases de Datos MySQL".
Verás una lista de bases de datos y los usuarios asociados a ellas. Anota el nombre de la base de datos (suele tener un prefijo como tuusuario_mitienda) y el nombre de usuario (ej. tuusuario_dbuser).
Si no recuerdas la contraseña, cPanel te permite cambiarla. Haz clic en "Cambiar contraseña" junto al usuario. IMPORTANTE: Anota la nueva contraseña, la necesitaremos en el siguiente paso.

Paso B: Localizar las credenciales correctas en Plesk

Inicia sesión en tu Plesk.
Ve a la sección "Bases de Datos" en el menú de la izquierda (bajo tu dominio).
Verás el nombre de la base de datos. Haz clic en ella para ver los detalles.
Plesk te muestra el usuario asociado. Para cambiar la contraseña, ve a "Cambiar contraseña" dentro de la configuración de la base de datos o del usuario.

[WARNING] Si cambias la contraseña en cPanel/Plesk, tienes que actualizarla también en PrestaShop. Si no, el error seguirá apareciendo, porque PrestaShop sigue intentando usar la contraseña antigua.

Fase 3: Actualizar el archivo de configuración (parameters.php)

Ahora que tienes las credenciales correctas (o las que acabas de cambiar), toca decírselo a PrestaShop. Vamos a editar el archivo clave.

Para PrestaShop 1.7, 1.8 y 9.x (Recomendado)

El archivo se llama parameters.php y se encuentra en la carpeta app/config/.

Vuelve al Administrador de Archivos de tu hosting.
Navega a public_html/app/config/.
Busca el archivo parameters.php. Haz clic derecho y selecciona "Editar" (o "Edit").
Se abrirá un editor de texto. Busca la sección que se ve similar a esto:

'database_host' => 'localhost',
'database_name' => 'tuusuario_mitienda',
'database_user' => 'tuusuario_dbuser',
'database_password' => 'tu_contraseña_antigua',

Reemplaza los valores con los que has verificado en el paso anterior. Presta mucha atención a las comillas simples y al punto y coma al final de cada línea.

[CRÍTICO] No elimines ninguna línea ni cambies el formato. Solo cambia el texto dentro de las comillas.

Guarda los cambios (Ctrl+S) y cierra el editor.

Para PrestaShop 1.6 (Versiones antiguas)

En versiones antiguas, el archivo se llama settings.inc.php y está en la carpeta config/.

Ve a public_html/config/settings.inc.php.
Edítalo de la misma manera. Busca definiciones como define('_DB_SERVER_', 'localhost');, define('_DB_NAME_', '...');, define('_DB_USER_', '...'); y define('_DB_PASSWD_', '...');.
Actualiza los valores entre comillas simples.

Fase 4: Solucionar el error "PrestaShop no conecta a MySQL" por IP de servidor

A veces, el problema no es la contraseña, sino que el servidor de base de datos no es localhost. En hosts modernos o en configuraciones con bases de datos remotas (muy común en Plesk con servidores separados), el host puede ser una dirección IP o un nombre de dominio interno (ej. mysql.example.com).

¿Cómo saber cuál es el host correcto?

En cPanel: Normalmente es localhost, pero si tu hosting usa un servidor de bases de datos separado, cPanel te lo indica en la sección "Bases de Datos MySQL" como "Host remoto" o en el correo de bienvenida.
En Plesk: Ve a la base de datos y en "Configuración" verás el "Servidor de base de datos" (ej. localhost o db.localhost).

Si ves que el valor es diferente, edita el archivo parameters.php y cambia 'database_host' => 'localhost' por la IP o el nombre del servidor que te indica tu proveedor.

[INFO] En Plesk, a menudo el host es localhost pero el puerto puede ser diferente (ej. 3307). Si ves un campo 'database_port', asegúrate de que coincida con el puerto de tu servidor MySQL (el estándar es 3306).

Fase 5: Comprobar el estado del servicio MySQL (El servidor está caído)

Si los datos son correctos y el archivo está bien, el problema puede ser que el motor de base de datos esté caído. Esto puede pasar por sobrecarga, mantenimiento o un fallo del proveedor.

¿Cómo comprobarlo en cPanel?

Busca la sección "Métricas" o "Estado del Servidor" en la pantalla principal de cPanel.
Busca el servicio "MySQL" (o MariaDB). Si aparece en rojo o con un icono de alerta, está caído.

¿Cómo comprobarlo en Plesk?

En el panel principal de Plesk, ve a "Herramientas y Ajustes".
Busca "Estado del Servidor" o "Servicios" en la menú de la izquierda.
Verifica que el servicio mysql o mariadb esté en estado "activo" o "running".

¿Qué hacer si está caído?

Reinícialo: En cPanel, a veces puedes reiniciarlo desde "Restaurar Servicios" (si tu plan lo permite). En Plesk, ve a "Servicios", selecciona MySQL y haz clic en "Reiniciar".
Contacta al soporte: Si no tienes permisos para reiniciar (lo más común en hosting compartido), abre un ticket de soporte con tu proveedor inmediatamente. Es la única forma de solucionarlo.

[WARNING] No intentes "reiniciar" el servidor completo desde tu panel si no sabes lo que haces. Podrías causar más caídas.

Fase 6: Reparar tablas corruptas de la base de datos

Otra causa del error solución error base de datos PrestaShop es que una tabla de la base de datos se haya corrompido (por ejemplo, tras una copia de seguridad fallida o un corte de energía). Cuando MySQL intenta leer una tabla corrupta, puede devolver un error de conexión genérico.

Reparación rápida desde phpMyAdmin

Accede a phpMyAdmin desde cPanel o Plesk.
Selecciona tu base de datos de PrestaShop (la que pusiste en parameters.php).
En la parte inferior de la lista de tablas, marca la casilla "Seleccionar todo".
En el menú desplegable de "Con selección", elige "Reparar tabla".

Esto forzará a MySQL a intentar arreglar los índices y datos dañados. Es un proceso no destructivo y muy seguro.

Fase 7: El problema de la caché de PrestaShop y el archivo .htaccess

Si has llegado hasta aquí y nada funciona, el problema puede ser la caché a nivel de servidor (Varnish, Memcached) o un archivo .htaccess corrupto.

Renombrar el .htaccess: En la raíz de public_html, busca el archivo .htaccess. Ponle un nombre temporal (ej. .htaccess_backup). Recarga la tienda. Si funciona, el problema era una regla de redirección o de PHP en ese archivo. PrestaShop lo regenerará automáticamente la próxima vez que guardes en el back-office.
Limpiar la caché de PHP: Si tu hosting usa LiteSpeed o similar, busca en cPanel la opción "MultiPHP INI Editor" o "Seleccionar versión de PHP" y simplemente guarda los cambios sin modificar nada. Esto a veces fuerza a limpiar la caché de opcode.

Fase 8: Solución avanzada (Syspanel / HestiaCP)

Si tu hosting no usa cPanel ni Plesk, sino un panel alternativo (como el que aquí llamamos Syspanel), el proceso es similar, pero con un acceso diferente.

Recuerda: Syspanel tiene su propio sistema de gestión. Para acceder a él, usa la URL https://tu-dominio.com:2106. Dentro de Syspanel, busca la sección "Bases de datos" o "Webs".

Entra en Syspanel y selecciona tu dominio.
Ve a la pestaña "Bases de Datos".
Ahí verás el usuario y el nombre de la BD. Puedes cambiar la contraseña desde ese mismo panel.
Luego, simplemente edita el archivo parameters.php como se explicó en la Fase 3.

[INFO] El puerto 2106 es el acceso estándar para Syspanel. No lo confundas con el puerto de SSH o FTP.

Preguntas Frecuentes (FAQ)

¿Por qué mi PrestaShop muestra "No se puede conectar a la base de datos" después de mover el hosting?

Es el error más típico tras una migración. Al mover los archivos, el archivo parameters.php se copia con las credenciales del hosting antiguo. Debes actualizarlo con los datos del nuevo hosting (Fase 2 y 3).

¿He perdido mis productos si veo este error?

No. El error de conexión es solo de comunicación. Tus productos, clientes y pedidos están en las tablas de MySQL. Una vez que arregles la conexión, todo volverá a aparecer.

¿Puedo evitar este error en el futuro?

Sí. Te recomiendo:

No cambiar la contraseña de la BD a menos que sea absolutamente necesario.
Hacer copias de seguridad de la base de datos y del archivo parameters.php antes de cualquier cambio.
Si cambias la contraseña, actualiza el archivo inmediatamente después.

El error dice "La conexión fue rechazada" en lugar de "No se puede conectar". ¿Es diferente?

Sí, es un matiz. "Conexión rechazada" suele significar que el servidor MySQL está activo pero no acepta conexiones desde esa IP o puerto. Revisa el database_host (Fase 4) y si tu hosting usa un firewall que bloquea el puerto 3306.

Conclusión: Plan de acción resumido

Si el error te sigue dando dolores de cabeza, ve en este orden:

Limpia la caché de PrestaShop (Fase 1). Es gratis y rápido.
Verifica y actualiza las credenciales en parameters.php (Fase 2 y 3). Es la causa del 80% de los casos.
Comprueba el estado del servidor MySQL (Fase 5). Si está caído, contacta al soporte.
Repara las tablas desde phpMyAdmin (Fase 6).
Renombra el .htaccess para descartar conflictos (Fase 7).

Este error de PrestaShop base de datos cPanel o Plesk es un dolor de cabeza, pero con estos pasos, en menos de 15 minutos deberías tener tu tienda operativa de nuevo. Si después de todo esto sigue fallando, el problema es del servidor y es hora de llamar a tu proveedor de hosting, mencionando que ya has verificado los datos y el estado de las tablas. ¡Mucho ánimo y a vender!