Cómo solucionar error de base de datos en PrestaShop | FAQ

¿Te ha aparecido el temido mensaje de "Error de conexión a la base de datos" en tu tienda PrestaShop? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. Este error suele deberse a que PrestaShop no puede comunicarse con MySQL, el motor que guarda todos tus productos, clientes y pedidos.

En esta guía extensa, te explicaré paso a paso cómo solucionar el error base de datos PrestaShop. Vamos a cubrir desde lo más básico (revisar contraseñas) hasta lo más técnico (reparar tablas dañadas). Todo explicado como si estuviéramos al teléfono, sin tecnicismos raros.

¿Por qué aparece este error?

Antes de lanzarnos a arreglarlo, es útil entender por qué ocurre. La conexión MySQL PrestaShop falla por varias razones:

Credenciales incorrectas: El archivo de configuración de PrestaShop tiene usuario, contraseña o nombre de base de datos equivocados.
Servidor MySQL caído: El servicio de base de datos no está funcionando (por ejemplo, tras una actualización del sistema o un fallo del servidor).
Tablas dañadas: Después de un corte de luz, un plugin conflictivo o una importación masiva, algunas tablas pueden corromperse.
Límites de conexión: El servidor tiene muchas conexiones abiertas y rechaza nuevas.
Problemas de permisos: El usuario de MySQL no tiene acceso a la base de datos correcta.

Vamos a atacar cada posible causa por orden de probabilidad.

Paso 1: Verifica que el servicio MySQL esté funcionando

Este es el primer paso. Si MySQL no está corriendo, nada funcionará.

Si tienes acceso a un panel de control (cPanel, Syspanel, etc.):

Accede a tu panel de hosting. Por ejemplo, si usas Syspanel (el antiguo HestiaCP), recuerda que el puerto de acceso es el 2106 (ejemplo: https://tudominio.com:2106).
Busca la sección de Servicios o Base de datos.
Verifica que el servicio MySQL o MariaDB esté en verde (activo).
Si está rojo o detenido, haz clic en Iniciar o Reiniciar.

Si tienes acceso por SSH (terminal):

Ejecuta este comando para ver el estado:

sudo systemctl status mysql

Si no está activo, ejecuta:

sudo systemctl start mysql

[TIP] Si el servicio se apaga solo, puede ser por falta de memoria. Revisa los logs con sudo journalctl -u mysql para ver errores.

Paso 2: Revisa las credenciales en el archivo de configuración

PrestaShop guarda los datos de conexión en un archivo llamado app/config/parameters.php. A veces, al mover la tienda o cambiar la contraseña de la base de datos, este archivo se queda desactualizado.

Cómo acceder al archivo:

Conéctate a tu servidor vía FTP (FileZilla, por ejemplo) o al administrador de archivos de tu panel.
Navega a la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Busca la carpeta app/config/ y dentro el archivo parameters.php.

Qué debes revisar:

Abre el archivo con un editor de texto (Bloc de notas, Sublime Text, etc.) y busca estas líneas:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_tu_bd',
'database_password' => 'contraseña_de_tu_bd',

database_host: Normalmente es localhost, pero si tu base de datos está en otro servidor, debe ser la IP o el dominio.
database_name, database_user, database_password: Deben coincidir exactamente con los datos que te proporcionó tu hosting. Un error común es copiar un espacio en blanco al final de la contraseña.

[WARNING] Si cambias la contraseña aquí, asegúrate de que también la cambies en el panel de control de tu hosting (phpMyAdmin, Syspanel, etc.). Deben ser idénticas.

Paso 3: Prueba la conexión desde phpMyAdmin

Si los datos parecen correctos, pero el error persiste, prueba a conectarte manualmente.

Accede a phpMyAdmin desde tu panel de control (en Syspanel suele estar en "Base de datos" -> "phpMyAdmin").
Inicia sesión con el mismo usuario y contraseña que pusiste en parameters.php.
Si no puedes entrar, el problema son las credenciales. Si sí puedes, el problema está en PrestaShop o en el servidor.

[INFO] Si no recuerdas la contraseña, puedes resetearla desde el panel de control. En Syspanel, ve a "Base de datos" -> "Editar usuario" y establece una nueva.

Paso 4: Repara las tablas de la base de datos

Las tablas dañadas son una causa frecuente de errores de conexión intermitentes. PrestaShop puede mostrar "Error de conexión" aunque el servidor esté bien.

Desde phpMyAdmin:

Selecciona la base de datos de tu PrestaShop (a la izquierda).
Marca todas las tablas (clic en "Seleccionar todo").
En el menú desplegable "Con seleccionados", elige Reparar tabla.
Espera a que termine. Si hay errores, te aparecerán en rojo.

Desde la línea de comandos (SSH):

Ejecuta:

mysqlcheck -u usuario -p --auto-repair nombre_de_tu_bd

Te pedirá la contraseña y automáticamente reparará las tablas dañadas.

Paso 5: Aumenta el límite de conexiones a MySQL

Si tienes muchos visitantes o módulos que hacen consultas constantes, puedes superar el límite de conexiones simultáneas. Esto provoca que nuevas conexiones (como la de PrestaShop) sean rechazadas.

Cómo aumentarlo (si tienes acceso root):

Conéctate por SSH.
Edita el archivo de configuración de MySQL:

sudo nano /etc/mysql/my.cnf

Busca la línea max_connections y cámbiala a un valor más alto, por ejemplo:

max_connections = 500

Guarda y reinicia MySQL:

sudo systemctl restart mysql

[WARNING] No pongas un número excesivo (más de 1000) si tu servidor tiene poca RAM, podrías saturarlo.

Si usas hosting compartido:

No podrás modificar este valor. Contacta con soporte y pídeles que lo aumenten o que optimicen tu sitio.

Paso 6: Limpia la caché de PrestaShop

A veces, PrestaShop guarda en caché una conexión fallida y sigue mostrando el error aunque ya esté solucionado.

Desde el administrador (si puedes acceder):

Ve a Parámetros avanzados -> Rendimiento.
Haz clic en Limpiar caché (el botón naranja).

Si no puedes acceder al administrador:

Borra manualmente la carpeta var/cache dentro de la raíz de PrestaShop. Puedes hacerlo por FTP. No te preocupes, se regenerará sola.

Paso 7: Verifica los permisos del usuario de MySQL

El usuario que usa PrestaShop debe tener todos los privilegios sobre la base de datos. Si alguien los cambió (por seguridad o error), la conexión fallará.

Desde phpMyAdmin:

Ve a la pestaña Cuentas de usuario (o "Privilegios").
Busca el usuario que usa PrestaShop.
Haz clic en Editar privilegios.
Marca Seleccionar todo y guarda.

Desde Syspanel:

Ve a "Base de datos" -> "Editar base de datos".
Asegúrate de que el usuario esté vinculado a la base de datos correcta y tenga permisos completos.

Paso 8: Revisa el archivo .htaccess (por si hay redirecciones extrañas)

Un .htaccess corrupto puede redirigir las peticiones a la base de datos y provocar errores.

Conecta por FTP.
Renombra el archivo .htaccess a htaccess_old (en la raíz de PrestaShop).
Prueba a cargar tu tienda. Si funciona, el problema estaba ahí. Luego puedes regenerarlo desde el back office (Parámetros avanzados -> SEO y URLs -> Guardar).

Preguntas frecuentes (FAQ)

¿Por qué sigo viendo el error después de cambiar la contraseña?

Asegúrate de que el archivo parameters.php se haya guardado correctamente. A veces los editores de texto añaden caracteres invisibles. Usa un editor como Notepad++ o VS Code.

¿El error puede deberse a un plugin o módulo?

Sí. Si instalaste un módulo justo antes del error, desactívalo renombrando su carpeta en /modules. Por ejemplo, cambia mimodulo a mimodulo_desactivado.

¿Qué hago si no tengo acceso al panel de control ni a FTP?

Contacta con tu proveedor de hosting. Ellos pueden reiniciar MySQL o revisar los logs por ti. Diles que tienes un error base de datos PrestaShop y que necesitas que verifiquen el servicio.

¿Es seguro editar el archivo parameters.php?

Sí, siempre que no borres nada más. Solo modifica las líneas de conexión. Haz una copia de seguridad antes por si acaso.

Resumen final

El error de conexión a la base de datos en PrestaShop suele resolverse en minutos si sigues estos pasos en orden:

Verifica que MySQL esté activo.
Revisa las credenciales en parameters.php.
Prueba la conexión con phpMyAdmin.
Repara las tablas dañadas.
Aumenta el límite de conexiones si es necesario.
Limpia la caché.
Revisa permisos del usuario de base de datos.
Comprueba el .htaccess.

Si después de todo esto el problema persiste, puede que sea un fallo del servidor o un conflicto con algún módulo. En ese caso, no dudes en pedir ayuda a tu hosting o a un desarrollador.

[TIP] Para evitar este error en el futuro, programa copias de seguridad periódicas de tu base de datos y mantén PrestaShop y sus módulos actualizados.

Espero que esta guía te haya sido de ayuda. ¡Tu tienda volverá a funcionar en poco tiempo!