Error de conexión a la base de datos en PrestaShop: soluciones

¿Qué significa exactamente el error "PrestaShop no se conecta a la base de datos"?

Cuando intentas abrir tu tienda online y te encuentras con un mensaje parecido a "Error de conexión a la base de datos" o "PrestaShop no conecta", lo primero que debes saber es que no es el fin del mundo. Este error es uno de los más comunes en el mundo del comercio electrónico 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 programación.

PrestaShop necesita comunicarse constantemente con una base de datos MySQL (o MariaDB) para funcionar. Ahí es donde se guardan tus productos, clientes, pedidos, configuraciones y absolutamente todo lo que hace que tu tienda funcione. Si esa comunicación se interrumpe, la tienda se queda "paralizada" y muestra ese temido mensaje.

En este artículo, vamos a desglosar todas las causas posibles y te voy a dar soluciones paso a paso, desde las más simples hasta las más avanzadas. Al final, tendrás un plan de acción claro para que tu tienda vuelva a estar operativa en cuestión de minutos. Vamos a ello.

Los 5 culpables más habituales del error conexión base de datos PrestaShop

Antes de ponernos manos a la obra, es importante que entiendas qué es lo que suele fallar. Cuando aparece el error conexión base de datos PrestaShop, normalmente el problema está en uno de estos cinco puntos:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos no coinciden con los que realmente existen.
Servidor de base de datos caído: El servicio MySQL o MariaDB se ha detenido o está sobrecargado.
Archivo de configuración dañado: El archivo parameters.php (donde PrestaShop guarda los datos de conexión) está mal configurado o tiene caracteres extraños.
Problemas de permisos: El usuario de la base de datos no tiene los permisos necesarios para acceder desde el servidor donde está alojada tu tienda.
Cambios en el hosting: Has migrado de servidor, cambiado de plan o el proveedor ha modificado algo sin avisarte.

Vamos a ir uno por uno, pero antes, respira. Casi todo tiene arreglo y no necesitas ser un hacker para lograrlo.

Paso 1: Verifica que el servidor de base de datos está en marcha

El primer paso es el más lógico. Si el servidor de MySQL está apagado, por mucho que configures bien tu PrestaShop, no va a conectar. Esto es especialmente común en entornos de hosting compartido o en servidores VPS administrados.

Si tienes un panel de control tipo cPanel o Plesk

Entra en tu panel de control y busca la sección de "Bases de datos MySQL". Normalmente verás un listado con todas las bases de datos y su estado. Si alguna aparece como "detenida" o "inactiva", actívala desde ahí.

Si tienes un servidor VPS o dedicado con acceso SSH

Conéctate por SSH y ejecuta el siguiente comando para ver el estado del servicio:

systemctl status mysql

O si usas MariaDB:

systemctl status mariadb

Si el servicio está inactivo, lo arrancas con:

systemctl start mysql

Y para que se inicie automáticamente en cada reinicio:

systemctl enable mysql

[TIP]: Si no sabes qué es SSH o no te sientes cómodo usándolo, contacta con tu proveedor de hosting y pídeles que verifiquen el estado del servicio MySQL. Es una petición muy habitual y suelen resolverlo en minutos.

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

Si el servidor de base de datos está funcionando, el siguiente sospechoso es el archivo de configuración. PrestaShop guarda los datos de conexión en un archivo llamado parameters.php que se encuentra en la carpeta app/config/ de tu instalación.

Cómo localizar y revisar el archivo

Accede a tu hosting mediante FTP o el administrador de archivos de tu panel. Navega hasta la carpeta raíz de tu tienda y busca la ruta app/config/parameters.php. Ábrelo con un editor de texto plano (nada de Word, usa Notepad++ o similar).

Dentro verás una estructura similar a esta:

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

Qué debes comprobar

database_host: Normalmente es localhost, pero en algunos hostings puede ser una dirección IP o un nombre de servidor como mysql.tudominio.com. Verifica que coincide con lo que te ha dado tu proveedor.
database_name: El nombre exacto de la base de datos. Cuidado con las mayúsculas y los guiones bajos.
database_user: El usuario que tiene acceso a esa base de datos.
database_password: La contraseña de ese usuario.

Un error muy común es que, al copiar y pegar la contraseña, se añadan espacios invisibles o caracteres extraños. Te recomiendo que borres la contraseña y la escribas a mano, o que la copies desde el panel de control de tu hosting directamente.

Si el archivo está corrupto

Si el archivo parameters.php está vacío, con caracteres raros o no existe, tienes dos opciones:

Restaurar desde una copia de seguridad: Si tienes una copia reciente de tu tienda, restaura este archivo.
Reconfigurar la conexión: PrestaShop tiene un asistente de instalación que también sirve para reparar. Accede a tudominio.com/install y elige la opción de "Actualizar" o "Reparar". Esto regenerará el archivo de configuración.

[WARNING]: Antes de tocar cualquier archivo de configuración, haz siempre una copia de seguridad. Un pequeño error tipográfico puede dejar tu tienda completamente inaccesible.

Paso 3: Comprueba las credenciales directamente en MySQL

A veces el problema no está en PrestaShop, sino en que las credenciales que tienes guardadas ya no son válidas. Esto puede pasar si alguien cambió la contraseña de la base de datos desde el panel de hosting.

Cómo verificar las credenciales manualmente

Desde tu panel de control (cPanel, Plesk, o el que uses), entra en la sección de bases de datos MySQL. Ahí verás el listado de bases de datos y los usuarios asociados. Revisa que:

La base de datos existe.
El usuario existe.
El usuario está asignado a esa base de datos.
El usuario tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

Si no estás seguro de que la contraseña sea correcta, la forma más sencilla de probarlo es usando la herramienta phpMyAdmin que suele venir incluida en todos los paneles de hosting.

Abre phpMyAdmin desde tu panel.
En la pantalla de inicio, intenta iniciar sesión con el usuario y la contraseña que tienes en tu parameters.php.
Si no te deja entrar, la contraseña es incorrecta.

En ese caso, desde el panel de hosting puedes cambiar la contraseña de la base de datos. Luego actualiza el archivo parameters.php con la nueva contraseña.

[INFO]: Algunos proveedores de hosting tienen políticas de seguridad que obligan a cambiar contraseñas periódicamente. Si tu tienda funcionaba ayer y hoy falla, revisa si te han enviado un correo sobre un cambio de contraseña.

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

Este es un paso que mucha gente pasa por alto. Aunque el usuario y la contraseña sean correctos, si el usuario no tiene permisos suficientes, la conexión fallará.

En cPanel, dentro de la sección de bases de datos MySQL, verás una opción para "Gestionar permisos de usuario". Asegúrate de que el usuario tiene marcados todos los privilegios (ALL PRIVILEGES).

Si estás en un entorno más técnico, puedes ejecutar este comando desde phpMyAdmin o desde la terminal:

GRANT ALL PRIVILEGES ON tu_base_de_datos.* TO 'tu_usuario'@'localhost';
FLUSH PRIVILEGES;

Esto le otorga todos los permisos al usuario sobre la base de datos específica.

Paso 5: Soluciona el error "PrestaShop no conecta" tras una migración o cambio de hosting

Este es un caso muy típico. Has movido tu tienda a un nuevo servidor, o has cambiado de plan de hosting, y ahora todo está roto. El error conexión base de datos PrestaShop aparece porque el archivo parameters.php sigue apuntando a los datos antiguos del servidor anterior.

Qué hacer en este caso

Obtén los nuevos datos de conexión: Tu nuevo proveedor de hosting te habrá dado un nombre de base de datos, usuario y contraseña nuevos. Normalmente están en el panel de control o en el correo de bienvenida.
Actualiza el archivo parameters.php: Edita el archivo con los nuevos datos.
Revisa el host: En el nuevo hosting, el host de la base de datos puede ser localhost o un nombre como mysql.nuevohosting.com. Verifica esto con tu proveedor.
Importa la base de datos: Si no has importado la base de datos al nuevo servidor, hazlo. Desde el panel de control, usa phpMyAdmin o la herramienta de importación para subir el archivo .sql de tu antigua base de datos.

[WARNING]: Si estás usando un panel de control como Syspanel, recuerda que el acceso al panel se realiza a través del puerto 2106. Esto puede ser relevante si necesitas gestionar las bases de datos desde el panel. No lo confundas con el puerto 3306 que es el de MySQL.

Paso 6: Comprueba si hay problemas con el prefijo de las tablas

PrestaShop usa un prefijo para las tablas de la base de datos (por defecto es ps_). Si ese prefijo no coincide con el que realmente usan tus tablas, la conexión fallará.

En el archivo parameters.php verás la línea:

'database_prefix' => 'ps_',

Verifica en phpMyAdmin que las tablas de tu base de datos empiezan por ps_. Si ves que empiezan por otro prefijo (por ejemplo shop_), cambia el valor en el archivo de configuración.

Paso 7: Solución avanzada: activa el modo de depuración de PrestaShop

Si has probado todo lo anterior y sigues sin saber qué pasa, PrestaShop tiene un modo de depuración que te mostrará el error exacto en lugar del mensaje genérico.

Para activarlo, edita el archivo defines.inc.php que se encuentra en la carpeta config/ de tu instalación.

Busca esta línea:

define('_PS_MODE_DEV_', false);

Y cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo y vuelve a cargar tu tienda. Ahora verás un mensaje de error mucho más detallado que te indicará exactamente qué está fallando. Una vez resuelto el problema, vuelve a poner el valor en false para no mostrar información sensible a los visitantes.

[TIP]: Anota el mensaje de error exacto que aparece y búscalo en Google junto con "solución error MySQL". En la mayoría de los casos, encontrarás que alguien más ha tenido el mismo problema y ha compartido la solución.

Solución paso a paso resumida (checklist rápido)

Para que no te pierdas, aquí tienes un resumen de todo el proceso en orden lógico:

Verifica el estado del servidor MySQL en tu panel de hosting.
Revisa el archivo parameters.php en app/config/.
Comprueba las credenciales en phpMyAdmin.
Asegúrate de que los permisos del usuario son correctos.
Si has migrado, actualiza los datos de conexión y revisa el prefijo de las tablas.
Activa el modo de depuración para obtener más información.
Contacta con tu proveedor de hosting si nada de lo anterior funciona.

Preguntas frecuentes (FAQ) sobre el error conexión base de datos PrestaShop

¿Por qué me aparece este error de repente si mi tienda funcionaba bien?

Las causas más comunes son: el proveedor de hosting ha cambiado la contraseña de la base de datos, el servicio MySQL se ha reiniciado y no ha arrancado correctamente, o se ha superado el límite de conexiones simultáneas al servidor de bases de datos.

¿Puedo perder mis datos si intento arreglar este error?

Si solo modificas el archivo parameters.php o los permisos, no perderás datos. Eso sí, nunca borres la base de datos ni intentes crear una nueva sin antes hacer una copia de seguridad. Tus productos, clientes y pedidos están ahí.

¿Necesito ser un programador para solucionarlo?

No. La mayoría de las soluciones son acceder a tu panel de hosting, revisar unos datos y actualizar un archivo. Si te sientes perdido, siempre puedes contactar con el soporte de tu hosting y pedir ayuda con el error conexión base de datos PrestaShop.

¿Cuánto tiempo tarda en solucionarse?

Normalmente, entre 10 y 30 minutos. Si el problema es del servidor, puede que necesites esperar a que tu proveedor lo resuelva, pero suele ser rápido.

¿Qué es eso de "Syspanel" y el puerto 2106?

Syspanel es un panel de control de hosting que utilizan algunos proveedores para gestionar tus sitios web, bases de datos y dominios. Se accede a través del navegador usando el puerto 2106. Si tu hosting usa Syspanel, es probable que tengas que entrar ahí para gestionar tu base de datos y solucionar el problema.

Conclusión: tu tienda puede volver a la vida en minutos

El error "PrestaShop no se conecta a la base de datos" es angustiante, pero como has visto, tiene muchas soluciones al alcance de tu mano. Desde comprobar que el servidor MySQL está activo hasta revisar el archivo de configuración, cada paso te acerca más a tener tu tienda operativa de nuevo.

La clave está en ir paso a paso, sin saltarte ninguno, y sobre todo, no entrar en pánico. Si después de seguir toda esta guía el problema persiste, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso directo a los servidores y pueden diagnosticar el problema en cuestión de minutos.

Recuerda que la prevención es la mejor medicina: haz copias de seguridad periódicas de tu base de datos y de tus archivos. Así, si algo falla en el futuro, podrás restaurar tu tienda en cuestión de minutos sin depender de soluciones complejas.

Espero que este artículo te haya sido de gran ayuda. Si has resuelto tu problema, ¡enhorabuena! Y si te ha quedado alguna duda, repasa las secciones anteriores o busca ayuda específica en los foros de la comunidad de PrestaShop. Tu tienda y tus clientes te lo agradecerán.