Errores de conexión a base de datos en PrestaShop (cPanel): solución rápida

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

Cuando tu tienda PrestaShop muestra un mensaje como "Error de conexión a la base de datos", "Link to database cannot be established" o "PrestaShop could not connect to the database", el problema casi siempre está relacionado con los datos de acceso a MySQL, la configuración del archivo parameters.php o el estado del servidor de bases de datos.

Este error es uno de los más comunes cuando trabajas con PrestaShop en cPanel, y la buena noticia es que en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto. A continuación, te explico paso a paso cómo diagnosticar y resolver el error conexión base datos PrestaShop de forma rápida y efectiva.

Primero: entiende qué está pasando

PrestaShop guarda todos sus productos, pedidos, clientes y configuración en una base de datos MySQL. Para conectarse a ella, necesita un "usuario", una "contraseña", un "nombre de base de datos" y un "servidor" (normalmente localhost). Toda esa información está en un archivo llamado parameters.php, ubicado en la carpeta app/config/ de tu instalación.

Cuando ves el PrestaShop cPanel error, significa que PrestaShop no puede autenticarse con esos datos o que el servidor de bases de datos no está respondiendo. Las causas más habituales son:

Cambiaste la contraseña de MySQL en cPanel y no actualizaste el archivo.
Migraste tu tienda a otro hosting y los datos son antiguos.
La base de datos fue eliminada o el usuario perdió privilegios.
El servicio MySQL está caído o saturado.
El archivo parameters.php tiene permisos incorrectos o está dañado.

Vamos a revisar cada una de estas posibilidades.

Paso 1: Verifica si tu base de datos existe y está activa en cPanel

Antes de tocar nada, accede a tu panel de control cPanel. Normalmente lo encuentras en tudominio.com/cPanel o a través del enlace que te dio tu proveedor de hosting.

Dentro de cPanel, busca la sección "Bases de datos MySQL" o "MySQL Databases". Ahí podrás ver:

El nombre de tus bases de datos (suelen tener un prefijo como tuusuario_nombrebasedatos).
Los usuarios asociados a cada base.
Los privilegios de cada usuario.

Comprueba esto:

¿Existe tu base de datos? Si no aparece, puede haber sido eliminada por error. Si tienes una copia de seguridad, puedes restaurarla desde cPanel o desde phpMyAdmin.
¿El usuario está asignado a la base? A veces, al migrar o al crear un usuario nuevo, no se asigna correctamente. Si el usuario no está en la lista de la base de datos, PrestaShop no podrá conectarse.
¿Los privilegios son correctos? El usuario debe tener TODOS LOS PRIVILEGIOS sobre la base de datos. Si solo tiene de lectura, verás errores raros como "SELECT command denied".

[WARNING] No confundas el nombre de la base de datos con el nombre de usuario. En cPanel, los nombres suelen llevar un prefijo común, pero no son lo mismo. Por ejemplo: miusuario_tienda (base) y miusuario_admin (usuario).

Paso 2: Revisa el archivo parameters.php

Si la base existe y el usuario tiene privilegios, el siguiente paso es verificar que PrestaShop esté usando los datos correctos. Para ello, necesitas acceder al archivo parameters.php.

¿Cómo acceder al archivo?

Entra a cPanel → Administrador de archivos (File Manager).
Ve a la carpeta public_html (o la carpeta donde esté instalada tu tienda).
Navega hasta app/config/.
Busca el archivo parameters.php. Haz clic derecho → Editar (o Edit).

Verás un contenido similar a este:

'database_host' => 'localhost',
'database_name' => 'tuusuario_tienda',
'database_user' => 'tuusuario_admin',
'database_password' => 'tucontraseña',

Qué debes comprobar:

database_host: normalmente es localhost, pero en algunos hostings puede ser 127.0.0.1 o un servidor remoto tipo mysql.tudominio.com. Si no estás seguro, usa localhost como valor por defecto.
database_name: debe coincidir exactamente con el nombre de la base en cPanel, incluyendo el prefijo. Un error típico es escribir el nombre sin el prefijo.
database_user: igual que el anterior, debe coincidir exactamente con el usuario de MySQL.
database_password: aquí está el problema más común. Si cambiaste la contraseña recientemente en cPanel, este archivo sigue teniendo la anterior.

Cómo corregirlo:

Si encuentras algún dato incorrecto, corrígelo y guarda el archivo.
Si no sabes cuál es la contraseña actual, puedes cambiarla desde cPanel en Bases de datos MySQL → Cambiar contraseña para ese usuario. Luego actualiza parameters.php con la nueva.

[TIP] Haz una copia de seguridad de parameters.php antes de editarlo. Si algo sale mal, puedes restaurar la copia desde el mismo File Manager.

Paso 3: Comprueba que el servicio MySQL está activo

A veces el problema no es de configuración, sino que el servidor de bases de datos está caído o reiniciándose. Esto es más común en hostings compartidos.

Cómo verificarlo:

En cPanel, busca la sección "Estado del servidor" o "Server Status". Ahí verás si MySQL está corriendo.
Si no encuentras esa opción, crea un archivo PHP temporal en public_html llamado test.php con el siguiente contenido:

<?php
$conn = @mysqli_connect('localhost', 'tuusuario', 'tucontraseña', 'tubasedatos');
if ($conn) {
    echo "Conexión exitosa";
} else {
    echo "Error: " . mysqli_connect_error();
}
?>

Ábrelo en tu navegador (tudominio.com/test.php). Si ves "Conexión exitosa", el servidor está bien y el problema es de PrestaShop. Si ves un error de conexión, el problema es del servidor o de los datos.

[WARNING] Borra el archivo test.php después de usarlo. Dejarlo en el servidor es un riesgo de seguridad grave.

Paso 4: Revisa si el archivo .htaccess está causando problemas

En algunos casos, un .htaccess corrupto o con reglas incorrectas puede interferir con la conexión a la base de datos, especialmente si estás usando redirecciones o reglas de reescritura mal configuradas.

Qué hacer:

Ve al File Manager y busca el archivo .htaccess en la raíz de tu instalación.
Renómbralo a .htaccess_backup (esto lo desactiva temporalmente).
Intenta acceder a tu tienda.

Si la tienda carga correctamente (puede que sin URLs amigables), entonces el .htaccess era el problema. Puedes regenerarlo desde el panel de administración de PrestaShop en Parámetros avanzados → Rendimiento → Regenerar .htaccess.

[INFO] Si no puedes acceder al panel de administración, puedes generar un .htaccess básico de PrestaShop buscando en la documentación oficial o pidiendo ayuda a tu hosting.

Paso 5: Verifica los permisos de archivos y carpetas

Los permisos incorrectos también pueden provocar el error conexión base datos PrestaShop. PrestaShop necesita permisos de lectura y escritura en ciertas carpetas para funcionar correctamente.

Permisos recomendados:

Archivos: 644
Carpetas: 755
El archivo parameters.php debe ser 644 o 640, nunca 777 (aunque algunos hostings lo piden así por compatibilidad).

Puedes cambiar permisos desde el File Manager haciendo clic derecho sobre el archivo o carpeta → Permisos (o Change Permissions).

[WARNING] No pongas permisos 777 en todos los archivos. Es un riesgo de seguridad enorme. Usa los permisos estándar que te recomiendo.

Paso 6: Revisa los logs de error de PrestaShop

PrestaShop guarda registros de errores que pueden darte pistas más precisas sobre el fallo. Para acceder a ellos:

Ve a public_html/var/logs/ (en versiones recientes) o public_html/log/ (en versiones antiguas).
Busca archivos con nombres como prod.log o *.log y ábrelos.
Busca líneas que contengan "database", "SQL", "connection" o "PDO".

Un ejemplo típico de error en el log sería:

[2024-01-15 10:30:00] request.CRITICAL: Uncaught PHP Exception Doctrine\DBAL\Exception\ConnectionException: "An exception occurred in the driver: SQLSTATE[HY000] [1045] Access denied for user 'usuario'@'localhost'"

Este mensaje te dice exactamente que el usuario o la contraseña son incorrectos.

Paso 7: Solución rápida con WP-CLI o SSH (si tienes acceso)

Si tu hosting te da acceso a SSH o a WP-CLI (aunque PrestaShop no usa WP-CLI, sí puedes usar comandos MySQL), puedes probar la conexión directamente:

mysql -u tuusuario -p -h localhost tubasedatos

Si el comando te da acceso, el problema está en PrestaShop. Si te da error, el problema está en los datos o en el servidor.

Paso 8: Restaurar desde una copia de seguridad

Si nada de lo anterior funciona, es posible que tu base de datos esté corrupta o que hayas hecho cambios recientes que rompieron algo. En ese caso:

Ve a cPanel → Copias de seguridad (Backup).
Restaura la copia más reciente de tu base de datos.
Asegúrate de que el archivo parameters.php coincida con los datos de esa copia.

[INFO] Si no tienes copias de seguridad en cPanel, revisa si tu hosting las hace automáticamente. Muchos proveedores guardan copias diarias o semanales.

Paso 9: Contacta con tu proveedor de hosting

Si has probado todos los pasos anteriores y sigues con el PrestaShop cPanel error, puede que el problema esté en el servidor (como un firewall bloqueando MySQL o un límite de conexiones alcanzado). En ese caso, contacta con el soporte de tu hosting y proporciona:

El mensaje de error exacto.
Los logs de PrestaShop que encontraste.
Una captura de pantalla de la configuración de tu base de datos en cPanel.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error de conexión después de cambiar la contraseña de MySQL?

Es el motivo más común. Al cambiar la contraseña en cPanel, debes actualizar también el archivo parameters.php con la nueva contraseña. Si no lo haces, PrestaShop seguirá intentando conectarse con la antigua.

¿Qué hago si no recuerdo la contraseña de mi base de datos?

Puedes cambiarla desde cPanel en Bases de datos MySQL → Cambiar contraseña. Luego actualiza parameters.php.

¿Puedo usar `localhost` o debo usar otra dirección?

En el 99% de los casos, localhost funciona. Si tu hosting usa servidores remotos de MySQL, te lo indicarán en la documentación o en el correo de bienvenida.

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

Al migrar, los datos de conexión cambian. Debes editar parameters.php con los nuevos datos de cPanel. Además, si tu base de datos tiene un prefijo diferente, también debes actualizarlo.

¿Es peligroso editar el archivo parameters.php?

No, siempre que tengas cuidado. Haz una copia de seguridad antes de editarlo y no cambies otros valores que no sean los de conexión.

¿Qué significa "SQLSTATE[HY000] [1045] Access denied"?

Significa que el usuario o la contraseña son incorrectos. Revisa que ambos coincidan exactamente con los de cPanel.

¿Puedo usar Syspanel como alternativa a cPanel?

Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el acceso se realiza a través del puerto 2106. La lógica es similar: busca la sección de bases de datos MySQL y verifica los mismos datos (usuario, contraseña, base). El archivo parameters.php se edita igual.

Resumen final

Resolver el error conexión base datos PrestaShop es cuestión de método. Sigue este orden:

Verifica que la base existe y el usuario tiene privilegios en cPanel.
Revisa y corrige parameters.php.
Comprueba que MySQL está activo.
Desactiva temporalmente .htaccess.
Revisa permisos de archivos.
Consulta los logs de PrestaShop.
Restaura una copia si es necesario.

En la mayoría de los casos, el problema se resuelve en los pasos 1 y 2. Si no, no dudes en pedir ayuda a tu hosting, porque puede ser un problema del servidor que no puedes solucionar tú mismo.

[TIP] Para evitar futuros sustos, anota siempre los datos de conexión de tu base de datos en un lugar seguro y actualiza parameters.php cada vez que cambies la contraseña. También es buena idea hacer copias de seguridad periódicas de tu base de datos desde cPanel.

Con estos pasos, tu tienda PrestaShop volverá a estar operativa en poco tiempo.