Errores de base de datos en PrestaShop: cómo solucionarlos

Introducción: Cuando tu tienda PrestaShop no arranca

Imagina que llegas a tu oficina, abres tu navegador y esperas ver tu tienda online. Pero en lugar de productos y ofertas, aparece una pantalla en blanco o un mensaje de error crítico. Es frustrante, ¿verdad? Uno de los problemas más comunes que enfrentan los usuarios de PrestaShop es el error de conexión a la base de datos. Este error puede detener completamente tu negocio digital, impidiendo que los clientes accedan a tu catálogo o realicen compras.

En este artículo, te guiaré paso a paso para entender por qué ocurre este problema y, lo más importante, cómo solucionarlo. Soy tu técnico de soporte amigable, y voy a explicarte todo de forma sencilla, sin tecnicismos complejos. Al final, tendrás las herramientas para diagnosticar y arreglar la conexión a tu base de datos PrestaShop.

¿Qué significa "error de conexión a base de datos" en PrestaShop?

Cuando ves un mensaje como "Error de conexión a base de datos" o "MySQL error", significa que tu tienda PrestaShop no puede comunicarse con el servidor donde se almacena toda la información de tu tienda: productos, pedidos, clientes, etc. Piensa en la base de datos como el cerebro de tu tienda; sin ella, PrestaShop no puede funcionar.

Los errores típicos incluyen:

"Cannot connect to database" (No se puede conectar a la base de datos)
"Error establishing a database connection" (Error al establecer la conexión con la base de datos)
"MySQL server has gone away" (El servidor MySQL se ha ido)
"Access denied for user" (Acceso denegado para el usuario)

Estos mensajes pueden aparecer en el frontend (la parte visible de tu tienda) o en el backend (el panel de administración). No te asustes, la mayoría tienen solución.

Causas comunes del error de conexión en PrestaShop

Antes de lanzarnos a las soluciones, es útil entender qué provoca estos fallos. Las causas más frecuentes son:

Credenciales incorrectas: El usuario, la contraseña, el nombre de la base de datos o el servidor son erróneos.
Servidor MySQL caído: El servicio de base de datos no está funcionando.
Problemas de permisos: El usuario de la base de datos no tiene los privilegios necesarios.
Configuración corrupta: El archivo settings.inc.php (donde se almacenan los datos de conexión) está dañado o mal escrito.
Sobrecarga del servidor: Demasiadas conexiones simultáneas o recursos insuficientes.
Actualizaciones o migraciones fallidas: Al cambiar de hosting o actualizar PrestaShop, los datos de conexión pueden desconfigurarse.

Paso 1: Verifica el estado del servidor MySQL

Lo primero que debes hacer es asegurarte de que el servicio MySQL esté funcionando. Si usas un panel de control como Syspanel (recuerda, el puerto de acceso es el 2106), puedes hacerlo fácilmente.

Cómo comprobarlo en Syspanel (HestiaCP)

Accede a Syspanel desde tu navegador: https://tudominio.com:2106
Inicia sesión con tus credenciales de administrador.
Busca la sección "Servicios" o "Services" (normalmente en el menú lateral).
Localiza "MySQL" o "MariaDB" en la lista. Debería aparecer como "running" (ejecutándose) y con un indicador verde.
Si está detenido (rojo), haz clic en el botón "Start" o "Reiniciar".

[TIP] Si no ves la opción de reiniciar, contacta a tu proveedor de hosting. En entornos compartidos, a veces no tienes permisos para gestionar servicios.

Alternativa: Usa la línea de comandos (SSH)

Si tienes acceso SSH, puedes ejecutar:

sudo systemctl status mysql

O si usas MariaDB:

sudo systemctl status mariadb

Si el servicio no está activo, inícialo con:

sudo systemctl start mysql

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

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado settings.inc.php. Este archivo se encuentra en la carpeta config/ de tu instalación de PrestaShop.

Ubicación del archivo

/ruta/a/tu/tienda/config/settings.inc.php

Cómo editarlo

Puedes usar un editor de texto plano (como Notepad++ o Sublime Text) o un administrador de archivos desde tu panel de control. En Syspanel, ve a "Archivos" > "Administrador de archivos" y navega hasta la carpeta config.

¿Qué buscar?

Dentro del archivo, verás algo como:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña');
define('_DB_PREFIX_', 'ps_');

Asegúrate de que estos valores sean correctos:

_DB_SERVER_: Normalmente es localhost, pero si tu base de datos está en un servidor remoto, debe ser la IP o el nombre del host.
_DB_NAME_: El nombre exacto de tu base de datos (puedes verificarlo en Syspanel en la sección "Bases de datos").
_DB_USER_: El usuario asociado a la base de datos.
_DB_PASSWD_: La contraseña correspondiente.

[WARNING] Ten cuidado con caracteres especiales como comillas o apóstrofes en la contraseña. Si los contiene, escápalos con una barra invertida (\) o cámbiala temporalmente para evitar errores de sintaxis.

¿Y si no encuentras el archivo?

Si el archivo settings.inc.php no existe o está vacío, puede que tu instalación esté dañada. En ese caso, tendrás que restaurar una copia de seguridad o reinstalar PrestaShop (pero esto es un tema más avanzado).

Paso 3: Prueba la conexión manualmente

Para asegurarte de que las credenciales son correctas, puedes probar la conexión desde el propio servidor o desde una herramienta externa.

Usando phpMyAdmin (desde Syspanel)

En Syspanel, ve a "Bases de datos" y haz clic en "phpMyAdmin".
Inicia sesión con el usuario y contraseña de la base de datos.
Si puedes acceder, las credenciales son correctas. Si no, revisa los datos.

Desde la línea de comandos

Conéctate vía SSH y ejecuta:

mysql -u usuario_base_datos -p -h localhost nombre_base_datos

Te pedirá la contraseña. Si accedes sin problemas, la conexión funciona.

[INFO] Si usas un servidor remoto, reemplaza localhost por la IP o el nombre del host.

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

A veces, el usuario tiene acceso pero no los permisos suficientes para que PrestaShop funcione correctamente. Necesita al menos permisos de SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP sobre todas las tablas.

Cómo otorgar permisos desde phpMyAdmin

Abre phpMyAdmin (desde Syspanel).
Selecciona tu base de datos en el panel izquierdo.
Ve a la pestaña "Privilegios" (o "Privileges").
Busca tu usuario y haz clic en "Editar privilegios".
Marca "Seleccionar todo" y guarda los cambios.

Desde la línea de comandos

GRANT ALL PRIVILEGES ON nombre_base_datos.* TO 'usuario_base_datos'@'localhost';
FLUSH PRIVILEGES;

Paso 5: Revisa los logs de errores

Los logs de MySQL y PrestaShop pueden darte pistas precisas sobre el problema.

Logs de MySQL

En Syspanel, busca la sección "Logs" o accede por SSH a:

sudo tail -f /var/log/mysql/error.log

Logs de PrestaShop

Habilita el modo debug de PrestaShop para ver errores más detallados. Edita el archivo config/defines.inc.php y cambia:

define('_PS_MODE_DEV_', true);

Esto mostrará los errores en pantalla. Recuerda desactivarlo después.

Paso 6: Soluciones avanzadas para errores persistentes

Si nada de lo anterior funciona, prueba estas opciones:

1. Aumenta el límite de conexiones MySQL

En el archivo de configuración de MySQL (/etc/mysql/my.cnf o /etc/my.cnf), busca:

max_connections = 150

Auméntalo a 200 o 300, y reinicia MySQL.

2. Verifica la versión de PHP y MySQL

PrestaShop requiere versiones específicas de PHP y MySQL. Por ejemplo, PrestaShop 1.7 necesita PHP 7.1 a 7.4 y MySQL 5.6 o superior. Si tu hosting usa versiones antiguas, actualiza.

3. Restaura una copia de seguridad

Si el error ocurrió después de una actualización o migración, restaura una copia de seguridad de la base de datos y los archivos.

4. Contacta al soporte técnico

Si eres cliente de un hosting gestionado, ellos pueden revisar los logs del servidor y ayudarte. En Syspanel, suele haber un sistema de tickets.

Preguntas frecuentes (FAQ)

¿Por qué aparece "MySQL error" después de cambiar de hosting?

Al migrar, los datos de conexión cambian. Debes actualizar el archivo settings.inc.php con las nuevas credenciales.

¿Qué hago si el archivo settings.inc.php no existe?

Puedes crearlo manualmente con los datos correctos, o reinstalar PrestaShop. Si tienes copia de seguridad, restáurala.

¿Cómo evito este error en el futuro?

Realiza copias de seguridad periódicas.
No modifiques el archivo settings.inc.php a menos que sepas lo que haces.
Mantén actualizados PrestaShop, PHP y MySQL.
Usa contraseñas seguras pero sin caracteres problemáticos.

¿Puedo usar un plugin para solucionar el error?

No, este error es de configuración del servidor, no de un plugin. Los módulos no pueden reparar la conexión a la base de datos.

Conclusión

Los errores de conexión a la base de datos en PrestaShop pueden parecer aterradores, pero en la mayoría de los casos se resuelven con unos sencillos pasos. Recuerda: revisa primero el servicio MySQL, luego las credenciales en settings.inc.php, y finalmente los permisos y logs.

Si sigues esta guía, podrás solucionar el problema tú mismo sin necesidad de un experto. Y si te atascas, no dudes en pedir ayuda a tu proveedor de hosting o a la comunidad de PrestaShop.

[INFO] Siempre ten a mano una copia de seguridad actualizada. Es tu mejor amiga ante cualquier desastre digital.

Ahora, ve y recupera tu tienda. ¡Tu negocio te necesita!