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

Corregir el error 'No se puede conectar a la base de datos' en PrestaShop

Actualizado el 15 de febrero de 2026

¡Hola! Si estás leyendo esto, es muy probable que hayas intentado abrir tu tienda PrestaShop y te hayas encontrado con un mensaje tan frustrante como críptico: "No se puede conectar a la base de datos". No te preocupes, es uno de los errores más comunes en el mundo del hosting y, en la gran mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en informática.

En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles de este problema. Actuaremos como detectives digitales para encontrar al culpable y, lo más importante, te daré las herramientas y los pasos exactos para arreglar BD PrestaShop y que tu tienda vuelva a funcionar en pocos minutos.

Vamos a ello. Respira hondo, porque vamos a resolverlo juntos.

¿Qué significa exactamente "No se puede conectar a la base de datos"?

Antes de lanzarnos a tocar archivos, es fundamental entender qué está pasando. Imagina que tu tienda PrestaShop es una biblioteca enorme y llena de estanterías (productos, pedidos, clientes). Esa biblioteca es tu base de datos.

El mensaje de error aparece cuando el "bibliotecario" (el código de PrestaShop) intenta abrir la puerta de la biblioteca con una llave (las credenciales de acceso) y descubre que la cerradura ha cambiado, la puerta está bloqueada o, simplemente, la biblioteca se ha mudado de edificio (servidor).

En términos técnicos, PrestaShop no puede establecer una conexión con el servidor MySQL o MariaDB donde se almacenan todos tus datos. Esto puede deberse a tres grandes razones:

  1. Credenciales incorrectas: El archivo de configuración de PrestaShop tiene un usuario, contraseña o nombre de base de datos que ya no coinciden con los reales.
  2. Servidor de base de datos caído o sobrecargado: El servidor donde vive tu base de datos está apagado, reiniciándose o ha superado su límite de conexiones.
  3. Archivos corruptos o movidos: Algún archivo esencial de PrestaShop se ha dañado, o tu web se ha movido a un nuevo hosting sin actualizar los datos de conexión.

Primeros pasos: Diagnóstico rápido (Antes de tocar nada)

A veces, la solución es más sencilla de lo que parece. Antes de entrar en el código, prueba estos pasos rápidos. Te sorprenderá la cantidad de veces que uno de estos trucos resuelve el error conexión base datos PrestaShop.

1. Espera unos minutos y recarga

Los servidores de bases de datos a veces se reinician por mantenimiento o por un pico de tráfico. Espera entre 5 y 10 minutos y recarga tu tienda. Puede que el problema sea temporal y se resuelva solo.

2. Revisa el estado de tu hosting

Si tu web está alojada en un servicio compartido, es posible que el proveedor esté teniendo incidencias. Visita la página de estado de tu proveedor (si la tiene) o busca en Twitter/Redes sociales si hay reportes masivos de caídas. Si el problema es de tu proveedor, solo te queda esperar.

3. Prueba a entrar en el Panel de Administración (Back Office)

Intenta acceder a /admin o la URL de tu panel de administración de PrestaShop. Si ni siquiera el panel carga y te da el mismo error, el problema es global. Si el panel carga pero la tienda no, el problema puede estar en una caché corrupta.

Soluciones definitivas: Cómo arreglar la conexión a la BD

Si los pasos anteriores no han funcionado, es hora de arremangarse. Vamos a explorar las soluciones técnicas, ordenadas de la más sencilla a la más compleja.

Solución 1: Verificar y corregir el archivo parameters.php (La causa más común)

PrestaShop guarda la "llave" de acceso a la base de datos en un archivo llamado parameters.php. Si este archivo tiene datos incorrectos, tu tienda no podrá conectarse jamás. Es el primer lugar donde debemos mirar.

¿Cómo accedo al archivo?

Necesitas un administrador de archivos. Puedes usar el Administrador de Archivos de tu cPanel o un cliente FTP como FileZilla.

  1. Conéctate a tu hosting y navega hasta la carpeta raíz de tu tienda (normalmente public_html o www).
  2. Busca la carpeta app/config.
  3. Dentro, encontrarás el archivo parameters.php. Antes de editarlo, descarga una copia de seguridad a tu ordenador.

¿Qué debo buscar?

Abre el archivo con un editor de texto plano (como el Bloc de notas o Sublime Text). Busca las líneas que dicen database_host, database_name, database_user y database_password.

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

¿Cómo sé si son correctos?

Esta es la parte clave. Debes asegurarte de que estos datos coinciden exactamente con los de tu servidor de bases de datos. Puedes verificarlos en tu panel de control de hosting (cPanel, Plesk, etc.).

  • En cPanel: Busca la sección "Bases de datos MySQL". Ahí verás los nombres de las bases de datos y los usuarios. Si no recuerdas la contraseña, puedes crear una nueva para ese usuario.

[WARNING] No confundas el usuario de tu hosting (el que usas para entrar al cPanel) con el usuario de la base de datos. Son cosas diferentes.

¿Cómo lo corrijo?

Si ves que algún dato es incorrecto, corrígelo, guarda el archivo y súbelo de nuevo a la carpeta app/config (sobrescribiendo el antiguo). Luego, intenta cargar tu tienda.

[TIP] Si no sabes cuál es la contraseña, la forma más segura es cambiarla desde tu cPanel. Ve a "Bases de datos MySQL", busca el usuario de tu BD y haz clic en "Cambiar contraseña". Pon una nueva y actualízala en el archivo parameters.php.

Solución 2: El servidor de la base de datos no es "localhost"

En muchos hostings, especialmente en los profesionales o en la nube, el servidor de la base de datos no es localhost. Puede ser una dirección IP como 127.0.0.1 o un nombre de servidor como mysql.midominio.com o db12345678.hostingcloud.com.

¿Cómo lo verifico?

  1. Ve a tu cPanel o panel de control.
  2. Busca la sección de "Bases de datos MySQL".
  3. A menudo, el panel te muestra el "Servidor" o "Host" de la base de datos. Si dice algo distinto a localhost, ese es el valor que debes usar.

¿Cómo lo arreglo?

  1. Edita el archivo parameters.php (como en el paso anterior).
  2. Cambia el valor de database_host por el que te indica tu proveedor de hosting.
  3. Guarda y sube el archivo.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso a su panel de control se realiza a través del puerto 2106 (ej. https://tu-dominio.com:2106). Dentro de Syspanel, busca la sección de "Bases de Datos" para ver el host correcto, que suele ser localhost, pero es bueno confirmarlo.

Solución 3: Reparar las tablas dañadas de la base de datos

A veces, el problema no es de acceso, sino de integridad. Las tablas de tu base de datos pueden estar dañadas o corruptas, impidiendo que PrestaShop lea la información. Esto puede pasar por cortes de luz, errores del servidor o actualizaciones fallidas.

¿Cómo lo arreglo con phpMyAdmin?

phpMyAdmin es una herramienta que te permite gestionar tu base de datos desde el navegador. Está disponible en casi todos los hostings.

  1. Accede a tu cPanel y busca el icono de phpMyAdmin (o "Bases de Datos MySQL" y luego el botón de phpMyAdmin).
  2. En el panel izquierdo, selecciona la base de datos de tu PrestaShop.
  3. Verás una lista de todas las tablas. Marca todas con la casilla de verificación en la parte inferior.
  4. En el menú desplegable que dice "Con seleccionados", elige la opción "Reparar tabla" (o "Repair Table").
  5. Espera a que el proceso termine. Te aparecerá un mensaje de éxito o error. Si hay errores, repite el proceso o intenta "Optimizar tabla" también.

Este proceso es seguro y no borra datos, solo intenta arreglar la estructura de las tablas.

Solución 4: Reconstruir el archivo .htaccess (Solución para errores de caché)

Un archivo .htaccess corrupto puede causar comportamientos extraños, incluidos errores de conexión a la base de datos, aunque parezca ilógico. A veces, el problema es una mezcla de caché y redirecciones.

¿Cómo lo arreglo?

  1. Conéctate por FTP o al Administrador de Archivos.
  2. Busca en la raíz de tu instalación de PrestaShop el archivo .htaccess. Ojo, es un archivo oculto. Deberás activar la opción "Mostrar archivos ocultos" en tu cliente FTP o en el administrador de archivos.
  3. Descarga una copia de este archivo a tu ordenador por seguridad.
  4. Ahora, borra el archivo .htaccess del servidor.
  5. Ve a tu tienda y recarga. PrestaShop debería regenerar el archivo automáticamente. Si lo hace, el problema está resuelto.

[WARNING] Si tu tienda no regenera el archivo, puede que necesites hacerlo manualmente. En el Back Office de PrestaShop (si puedes acceder), ve a Parámetros Avanzados > Rendimiento y activa la opción "Forzar la compilación de las plantillas" y guarda. Luego desactívala y guarda de nuevo. Esto suele forzar la regeneración.

Solución 5: Aumentar el límite de memoria de PHP

Este error a veces es un "falso amigo". No es que no haya conexión, sino que PHP se queda sin memoria para procesar la solicitud y muestra ese mensaje genérico.

¿Cómo lo arreglo?

  1. Busca el archivo settings.inc.php en la carpeta config de tu PrestaShop. (Antes se llamaba settings.inc.php, ahora se usa parameters.php).
  2. Si no lo encuentras, crea un archivo llamado php.ini en la raíz de tu web.
  3. Añade o modifica la siguiente línea:
memory_limit = 256M
  1. Si no puedes crear un php.ini, intenta añadir esta línea al archivo config/defines.inc.php de PrestaShop, justo después de la línea que define _PS_MODE_DEV_:
ini_set('memory_limit', '256M');

Guarda los cambios y vuelve a intentarlo.

Solución 6: ¿Te has mudado de hosting? Actualiza los datos

Si recientemente cambiaste de proveedor de hosting o moviste tu web de un servidor a otro, es muy probable que el archivo parameters.php esté desactualizado. Los datos de la base de datos en tu nuevo hosting son casi seguro diferentes.

¿Qué hago?

  1. Accede a tu nuevo cPanel y localiza la base de datos que hayas creado para esta web.
  2. Anota el nombre de la base de datos, el usuario y la contraseña.
  3. Edita el archivo parameters.php en tu nueva instalación con estos nuevos datos. Este es el paso más importante en una migración.

Preguntas Frecuentes (FAQ)

P: He probado todo y sigue sin funcionar. ¿Qué más puedo hacer?

R: Si has llegado hasta aquí y nada funciona, el problema puede ser más profundo. Te recomiendo contactar con el soporte técnico de tu proveedor de hosting. Ellos pueden verificar si el servicio MySQL/MariaDB está activo en el servidor y revisar los logs de errores por ti. Es posible que haya un problema a nivel de servidor que solo ellos pueden solucionar.

P: ¿Perderé mis productos o clientes si hago estos cambios?

R: No. Todos los pasos que hemos visto (editar parameters.php, reparar tablas, borrar .htaccess) no borran datos. Solo corrigen la conexión o la estructura de las tablas. Tus productos, pedidos y clientes están a salvo.

P: ¿Puedo evitar este error en el futuro?

R: Sí, en parte. Te recomiendo:

  • Realizar copias de seguridad periódicas de tu base de datos y archivos.
  • No cambiar la contraseña de la BD sin actualizar inmediatamente el parameters.php.
  • Mantener PrestaShop actualizado a la última versión estable.
  • Evitar instalar módulos de fuentes no confiables, ya que pueden corromper archivos.

P: ¿Qué significa exactamente "mysqli" en el error?

R: Es el nombre del controlador (driver) que usa PHP para hablar con la base de datos MySQL. Si el error menciona "mysqli", confirma que el problema es específicamente con la conexión a la base de datos y no con otra parte del sistema.

P: Mi hosting usa Syspanel (HestiaCP). ¿Es diferente?

R: La lógica es la misma, pero la interfaz cambia. En Syspanel, busca la sección "Bases de Datos" en el menú lateral. Allí podrás ver el nombre de la BD, el usuario y la contraseña. Recuerda que para entrar a Syspanel, la URL es https://tu-dominio.com:2106. La gestión de archivos también está disponible dentro de Syspanel, en la sección "Administrador de Archivos".

Conclusión

El error "No se puede conectar a la base de datos" en PrestaShop puede ser desalentador, pero como has visto, la mayoría de las veces tiene una solución clara y a tu alcance. Hemos recorrido desde lo más simple (esperar) hasta lo más técnico (editar archivos de configuración), pasando por la reparación de la base de datos.

Recuerda siempre hacer una copia de seguridad antes de modificar cualquier archivo. Con paciencia y siguiendo esta guía, tu tienda volverá a estar en línea en poco tiempo. Si el problema persiste, no dudes en contactar con tu proveedor de hosting; para eso están. ¡Mucha suerte y que tus ventas no se detengan!

¿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