🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Cómo resolver el error 'No se puede conectar a la base de datos' en PrestaShop (cPanel)

Actualizado el 2 de noviembre de 2025

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

Cuando visitas tu tienda PrestaShop y ves el temido mensaje "No se puede conectar a la base de datos", no significa que tu tienda haya desaparecido ni que hayas perdido tus productos. Simplemente indica que PrestaShop no puede comunicarse con MySQL, que es el motor donde se guardan tus productos, clientes, pedidos y configuraciones.

Este problema es uno de los más comunes en PrestaShop, sobre todo cuando trabajas con un panel de control como cPanel. Las causas pueden variar desde un cambio de contraseña hasta un ataque malintencionado, pasando por archivos de configuración corruptos o problemas con el servidor de bases de datos.

Lo bueno es que, en la mayoría de los casos, puedes solucionarlo tú mismo siguiendo una serie de pasos lógicos y sin necesidad de ser un experto en programación. A continuación, te explico cómo resolver el error prestashop no conecta mysql de forma clara y paso a paso.

Antes de empezar: prepara tu información

Para solucionar el error base datos prestashop, necesitarás tener a mano algunos datos que seguramente ya tienes:

  • Acceso a tu panel de control de hosting (cPanel, Syspanel, Plesk, etc.)
  • El nombre de tu base de datos
  • El usuario de la base de datos
  • La contraseña de ese usuario
  • El nombre del servidor de base de datos (normalmente "localhost")

Si no recuerdas alguno de estos datos, no te preocupes. Te enseñaré a encontrarlos en los siguientes pasos.

[INFO] Si tu hosting usa Syspanel (la alternativa a cPanel que algunos proveedores ofrecen), el acceso se realiza a través del puerto 2106. El proceso de gestión de bases de datos es muy similar al de cPanel.

Paso 1: Verifica que el servicio MySQL esté activo

A veces el problema no está en tu tienda, sino en que el servidor de bases de datos se ha detenido o está reiniciándose. Esto es más común de lo que parece.

En cPanel:

  1. Inicia sesión en tu cPanel
  2. Busca la sección "Métricas" o "Estado del servidor"
  3. Verifica que MySQL aparezca como "en ejecución"

En Syspanel:

  1. Accede a Syspanel usando el puerto 2106 (por ejemplo: https://tu-dominio.com:2106)
  2. Busca la opción "Servicios" o "Estado del servidor"
  3. Comprueba que MySQL/MariaDB esté activo

Si el servicio está detenido, actívalo desde el mismo panel. Si no puedes hacerlo, contacta con tu proveedor de hosting, ya que puede tratarse de un problema de infraestructura.

Paso 2: Revisa el archivo de configuración de PrestaShop

El archivo que controla la conexión a la base de datos en PrestaShop se llama parameters.php y se encuentra en la carpeta app/config/. Antes de la versión 1.7, este archivo se llamaba settings.inc.php y estaba en la carpeta config/.

Cómo revisarlo:

  1. Accede a tu hosting mediante FTP o el administrador de archivos del cPanel
  2. Navega hasta public_html/app/config/ (o public_html/config/ si usas una versión antigua)
  3. Descarga el archivo parameters.php y ábrelo con un editor de texto como Notepad++

Dentro de este archivo, busca las líneas que definen la conexión:

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

Verifica que estos datos coincidan exactamente con los que tienes en tu panel de hosting. Un error muy común es que la contraseña haya cambiado o que el nombre de la base de datos incluya un prefijo que no esté bien escrito.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (una comilla mal puesta, un punto y coma olvidado) puede dejar tu tienda completamente inaccesible. Si no estás seguro, haz una copia de seguridad antes de modificar nada.

Paso 3: Comprueba las credenciales desde cPanel

Si los datos del archivo parecen correctos pero el error prestashop no conecta mysql persiste, es posible que las credenciales hayan cambiado sin que te des cuenta.

En cPanel:

  1. Ve a la sección "Bases de datos MySQL"
  2. Anota el nombre exacto de tu base de datos (suele tener un prefijo como usuario_basededatos)
  3. Anota el nombre del usuario de la base de datos
  4. Si no recuerdas la contraseña, puedes cambiarla desde aquí (botón "Cambiar contraseña")

En Syspanel:

  1. Accede con el puerto 2106
  2. Busca "Bases de datos" o "MySQL"
  3. Sigue el mismo proceso para ver o resetear credenciales

Una vez que tengas los datos correctos, actualiza el archivo parameters.php con la nueva información y guarda los cambios.

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

En ocasiones el usuario existe y la contraseña es correcta, pero no tiene los privilegios necesarios para acceder a la base de datos. Esto puede pasar después de una migración o una restauración.

En cPanel:

  1. Ve a "Bases de datos MySQL"
  2. Busca la sección "Añadir usuario a la base de datos"
  3. Asegúrate de que tu usuario esté asociado a tu base de datos
  4. Si ya está asociado, revisa los privilegios marcando la opción "TODOS LOS PRIVILEGIOS"

En Syspanel:

  1. Accede al gestor de bases de datos
  2. Localiza tu base de datos y verifica que el usuario tenga privilegios completos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.)

Una vez que los permisos estén correctos, prueba de nuevo a cargar tu tienda.

Paso 5: Comprueba que el puerto y el host sean correctos

Normalmente, en entornos de hosting compartido, el host de la base de datos es localhost. Sin embargo, algunos proveedores utilizan un host externo o un puerto diferente.

Dónde verificar:

  1. En cPanel, busca la sección "Información del servidor" o "Detalles de conexión"
  2. Si tu proveedor usa un host externo, verás algo como mysql.tudominio.com
  3. En ese caso, actualiza el campo database_host en el archivo parameters.php

[TIP] Si tu hosting usa Syspanel, la información del servidor de base de datos suele estar en la misma página principal. Recuerda que el acceso al panel es por el puerto 2106.

Paso 6: Revisa los logs de error de MySQL

Si después de todos estos pasos el error base datos prestashop continúa, es hora de mirar los registros del servidor. Esto te dará pistas más concretas sobre qué está fallando.

En cPanel:

  1. Ve a "Registros de errores" o "Error Logs"
  2. Busca la sección de MySQL
  3. Fíjate en mensajes como "Access denied" (acceso denegado) o "Unknown database" (base de datos desconocida)

En Syspanel:

  1. Accede al panel por el puerto 2106
  2. Busca "Logs" o "Registros"
  3. Revisa los errores relacionados con MySQL

Los mensajes de error te dirán exactamente qué está fallando: si es la contraseña, si el usuario no existe, si la base de datos no se encuentra, etc.

Paso 7: Soluciona el error de conexión con el archivo de caché

A veces, aunque los datos de conexión sean correctos, PrestaShop guarda una caché de la configuración antigua que impide la conexión. Esto es especialmente común después de mover la tienda de servidor.

Solución:

  1. Conecta por FTP o el administrador de archivos
  2. Elimina la carpeta var/cache/ (en PrestaShop 1.7) o cache/ (en versiones anteriores)
  3. Si no puedes eliminar la carpeta completa, borra su contenido

Después de esto, intenta acceder a tu tienda. Es posible que tarde unos segundos más en cargar la primera vez, ya que tendrá que regenerar la caché.

[WARNING] No elimines la carpeta var/cache/ si tu tienda está en producción y no tienes acceso de respaldo. En caso de duda, haz una copia de seguridad primero.

Paso 8: Verifica si hay un ataque o un archivo modificado

En algunos casos, el error prestashop no conecta mysql puede ser síntoma de que alguien ha modificado tus archivos o ha inyectado código malicioso. Esto es más común de lo que parece en tiendas online.

Qué hacer:

  1. Revisa la fecha de modificación del archivo parameters.php
  2. Compara el contenido con una copia original de PrestaShop
  3. Busca archivos sospechosos en la carpeta modules/ o themes/ que no reconozcas

Si encuentras algo raro, restaura los archivos desde una copia de seguridad limpia o reinstala PrestaShop conservando los datos de la base de datos.

Paso 9: Prueba la conexión directamente con un script

Para confirmar si el problema es de PrestaShop o de la conexión en sí, puedes crear un pequeño script de prueba. Esto te ayudará a aislar el problema.

Crea un archivo llamado testdb.php en la raíz de tu sitio:

<?php
$host = 'localhost';
$user = 'tu_usuario';
$pass = 'tu_contraseña';
$db = 'tu_base_datos';

$conn = mysqli_connect($host, $user, $pass, $db);
if (!$conn) {
    die('Error: ' . mysqli_connect_error());
}
echo '¡Conexión exitosa a la base de datos!';
mysqli_close($conn);
?>

Guarda el archivo y accede a tudominio.com/testdb.php. Si ves el mensaje de éxito, el problema está en la configuración de PrestaShop. Si ves un error, el problema está en las credenciales o en el servidor.

Después de la prueba, elimina este archivo para evitar riesgos de seguridad.

Paso 10: Restaura desde una copia de seguridad

Si nada de lo anterior funciona, la solución más rápida y segura es restaurar tu tienda desde una copia de seguridad reciente. Todos los hosting serios ofrecen copias automáticas.

En cPanel:

  1. Ve a "Copias de seguridad" o "Backup"
  2. Restaura la copia más reciente de tus archivos y base de datos
  3. Asegúrate de que la copia sea anterior al momento en que empezó el error

En Syspanel:

  1. Accede por el puerto 2106
  2. Busca la sección de copias de seguridad
  3. Sigue el mismo proceso de restauración

[TIP] Si no tienes copias recientes, contacta con tu proveedor de hosting. Ellos suelen tener copias de seguridad internas y pueden ayudarte a restaurar tu tienda.

Preguntas frecuentes sobre el error de conexión a la base de datos

¿Por qué aparece este error después de cambiar la contraseña de MySQL?

Es muy común. Si cambiaste la contraseña en cPanel o en Syspanel, debes actualizarla también en el archivo parameters.php. De lo contrario, PrestaShop seguirá intentando conectarse con la contraseña anterior.

¿El error puede ser por un problema del servidor?

Sí. A veces el servidor MySQL se cae o está en mantenimiento. Verifica primero que el servicio esté activo en tu panel de control antes de tocar nada más.

¿Puedo perder mis datos si modifico el archivo de configuración?

No, modificar parameters.php no afecta a tus datos. Solo cambia los datos de conexión. Tus productos, pedidos y clientes siguen en la base de datos.

¿Qué hago si mi hosting usa Syspanel?

Syspanel es la alternativa a cPanel que ofrecen algunos proveedores. El acceso se realiza a través del puerto 2106. El proceso de gestión de bases de datos es muy similar: busca la sección de bases de datos MySQL, revisa credenciales y privilegios, y sigue los mismos pasos que te he explicado.

¿Debo contactar con mi proveedor de hosting?

Si después de seguir todos los pasos el error persiste, sí. Es posible que haya un problema en el servidor que solo ellos puedan solucionar. Explícales claramente que tu PrestaShop no conecta con MySQL y qué pasos has seguido.

Conclusión y consejos finales

El error "No se puede conectar a la base de datos" en PrestaShop puede ser frustrante, pero en la gran mayoría de los casos tiene solución. Los pasos que te he explicado cubren las causas más habituales: desde credenciales incorrectas hasta problemas de permisos o archivos de configuración corruptos.

Recuerda siempre trabajar con calma y hacer copias de seguridad antes de modificar archivos importantes. Si tu hosting usa Syspanel, no olvides que el acceso es por el puerto 2106 y que el proceso es prácticamente el mismo que en cPanel.

Para prevenir futuros problemas, te recomiendo:

  • Anotar las credenciales de tu base de datos en un lugar seguro
  • Hacer copias de seguridad periódicas de tu tienda
  • Mantener PrestaShop actualizado a la última versión
  • No cambiar contraseñas sin actualizar el archivo de configuración

Con estos consejos y siguiendo los pasos de esta guía, podrás solucionar el error base datos prestashop y volver a tener tu tienda online funcionando en poco tiempo. Si te has quedado con alguna duda, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting.

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel