Errores de conexión a base de datos en PrestaShop | Soluciones

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los problemas más frustrantes que puedes encontrar al gestionar tu tienda online con PrestaShop: los errores de conexión a la base de datos.

Cuando tu tienda no puede hablar con la base de datos, el resultado suele ser una pantalla en blanco o un mensaje de error crítico que impide que tus clientes compren. Pero no te preocupes, la mayoría de estos errores tienen solución y en esta guía te voy a explicar paso a paso cómo identificarlos y arreglarlos.

Vamos a empezar desde lo más básico para que, incluso si no eres un experto técnico, puedas entender qué está pasando y cómo solucionarlo.

¿Por qué aparece un error de conexión a la base de datos en PrestaShop?

El error base de datos PrestaShop es un problema común que puede deberse a varias causas. La base de datos es como el cerebro de tu tienda: almacena productos, clientes, pedidos, configuraciones y todo lo que hace funcionar tu negocio. Si la conexión falla, PrestaShop no puede acceder a esa información y se bloquea.

Las razones más habituales son:

Credenciales incorrectas: El archivo de configuración tiene usuario, contraseña o nombre de base de datos equivocados.
Servidor MySQL caído: El servicio de base de datos no está funcionando en tu servidor.
Host de base de datos erróneo: La dirección del servidor MySQL no es la correcta (por ejemplo, usar localhost cuando debería ser una IP remota).
Problemas de permisos: El usuario de la base de datos no tiene permisos suficientes para acceder o modificar datos.
Sobrecarga del servidor: Demasiadas conexiones simultáneas o un pico de tráfico que satura el motor de base de datos.
Archivos de configuración corruptos: El archivo app/config/parameters.php está dañado o tiene errores de sintaxis.

Primeros pasos: Cómo diagnosticar el problema

Antes de lanzarnos a soluciones avanzadas, vamos a hacer un diagnóstico rápido. Esto te ahorrará tiempo y te ayudará a entender qué está fallando.

1. Revisa el mensaje de error exacto

Cuando tu tienda muestre un error, anota el mensaje completo. Por ejemplo, puede decir:

"Link to database cannot be established"
"Error de conexión a la base de datos"
"SQLSTATE[HY000] [2002] Connection refused"

Estos códigos te darán pistas clave. El código 2002 suele indicar que el servidor MySQL no está accesible, mientras que 1045 señala credenciales incorrectas.

2. Accede al panel de control de tu hosting

Necesitarás entrar al panel de administración de tu servidor. Si usas un panel como Syspanel (el antiguo HestiaCP), recuerda que la dirección de acceso es tudominio.com:2106. Allí podrás gestionar bases de datos, usuarios y servicios.

3. Verifica que el servicio MySQL esté activo

Desde Syspanel (puerto 2106), busca la sección de "Servicios" o "Base de datos". Deberías ver el estado de MySQL (o MariaDB, que es su variante). Si aparece como "detenido" o "inactivo", ese es tu problema.

[WARNING] Si el servicio está detenido, no podrás conectar hasta que lo reinicies. Hazlo desde el panel o contacta con tu soporte de hosting si no tienes acceso.

Soluciones paso a paso para los errores más comunes

## Error de credenciales incorrectas (código 1045)

Este es el error más frecuente. Ocurre cuando el usuario, la contraseña o el nombre de la base de datos que PrestaShop está usando no coinciden con los reales.

### Paso 1: Localiza el archivo de configuración

PrestaShop guarda los datos de conexión en el archivo app/config/parameters.php. Puedes acceder a él mediante FTP (FileZilla, por ejemplo) o desde el gestor de archivos de tu panel de hosting.

### Paso 2: Abre el archivo y verifica los datos

Busca estas líneas (los valores exactos pueden variar):

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

Asegúrate de que coincidan exactamente con los datos de tu base de datos. Un error típico es copiar un espacio en blanco al final de la contraseña.

### Paso 3: Corrige y guarda

Si encuentras algún dato incorrecto, corrígelo. Guarda el archivo y vuelve a cargar tu tienda.

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde Syspanel (puerto 2106) en la sección de bases de datos. Luego actualiza el archivo parameters.php con la nueva contraseña.

## Error de host de base de datos (código 2002)

Este error aparece cuando PrestaShop no puede encontrar el servidor MySQL. Puede ser porque el host está mal escrito o porque el servidor no está accesible.

### Solución 1: Usa "localhost" si tu base de datos está en el mismo servidor

En la mayoría de los hostings compartidos, la base de datos y el sitio web están en el mismo servidor. Por lo tanto, el valor correcto para database_host es localhost o 127.0.0.1.

### Solución 2: Si usas un servidor remoto, verifica la IP

Si tu base de datos está en un servidor diferente (por ejemplo, un servicio externo como Amazon RDS), asegúrate de que la IP o el nombre de host sean correctos. También necesitarás que el firewall del servidor MySQL permita conexiones desde la IP de tu tienda.

### Solución 3: Comprueba el puerto

Por defecto, MySQL usa el puerto 3306. Si tu servidor usa otro puerto, deberás añadirlo en el archivo de configuración. Busca la línea database_port en parameters.php y ajústala.

'database_port' => '3306',

[INFO] Si no ves la línea del puerto, puedes añadirla manualmente. PrestaShop la usará si está definida.

## Problemas de permisos de usuario

A veces las credenciales son correctas, pero el usuario no tiene permisos para acceder a la base de datos o para realizar ciertas operaciones (como crear tablas).

### Paso 1: Accede a la gestión de usuarios de la base de datos

Desde Syspanel (puerto 2106), ve a la sección de bases de datos y busca la opción de "Usuarios". Allí verás qué privilegios tiene el usuario que usa PrestaShop.

### Paso 2: Otorga todos los privilegios

Para que PrestaShop funcione correctamente, el usuario necesita permisos como SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX y DROP. Si no los tiene, puedes marcarlos todos (o seleccionar "Todos los privilegios").

### Paso 3: Guarda los cambios y prueba

Después de actualizar los permisos, recarga tu tienda. Si el error persiste, puede que necesites regenerar el archivo de configuración.

## Servidor MySQL sobrecargado o caído

Si el servicio MySQL se cae por sobrecarga o por un error interno, tu tienda no podrá conectar.

### Solución 1: Reinicia el servicio desde el panel

En Syspanel (puerto 2106), busca la opción de "Servicios" y localiza MySQL o MariaDB. Haz clic en "Reiniciar". Espera unos segundos y vuelve a cargar tu tienda.

### Solución 2: Optimiza las consultas

Si el problema es recurrente, puede que tu base de datos tenga consultas lentas o mal optimizadas. PrestaShop tiene un modo de mantenimiento que puedes activar para evitar que los clientes vean errores. Luego, desde el back office, puedes ir a "Parámetros de la tienda" > "Rendimiento" y activar opciones como "Cache de MySQL" o "Combinar archivos CSS/JS".

### Solución 3: Aumenta los límites de conexión

Si tu hosting lo permite, puedes aumentar el número máximo de conexiones a MySQL. Esto se hace desde el archivo de configuración de MySQL (my.cnf), pero no siempre está disponible en hosting compartido. En ese caso, contacta con tu proveedor.

Errores específicos de PrestaShop y cómo solucionarlos

## El error "Link to database cannot be established"

Este mensaje genérico suele aparecer cuando PrestaShop no puede establecer la conexión inicial. Las causas principales son las que ya vimos: credenciales incorrectas, host erróneo o servicio caído.

### Solución rápida:

Ve a tu panel de hosting y verifica que MySQL esté activo.
Revisa el archivo parameters.php y comprueba que todos los datos sean correctos.
Si todo parece bien, prueba a cambiar database_host de localhost a 127.0.0.1 o viceversa.
También puedes probar a desactivar el modo de depuración de PrestaShop para ver más detalles: añade define('_PS_MODE_DEV_', true); en el archivo config/defines.inc.php y recarga la tienda. Verás un mensaje de error más detallado.

[WARNING] No olvides quitar esa línea después de solucionar el error, ya que el modo de depuración muestra información sensible a los visitantes.

## Error después de migrar o cambiar de hosting

Si has movido tu tienda a un nuevo servidor, es muy común que la conexión falle porque los datos de la base de datos han cambiado.

### Paso 1: Exporta e importa la base de datos correctamente

Asegúrate de que la base de datos esté completa en el nuevo servidor. Puedes usar phpMyAdmin (disponible en Syspanel, puerto 2106) para exportar la base de datos antigua e importarla en la nueva.

### Paso 2: Actualiza el archivo de configuración

Después de la migración, edita app/config/parameters.php con los nuevos datos de conexión (host, nombre, usuario y contraseña) del nuevo servidor.

### Paso 3: Limpia la caché de PrestaShop

A veces la caché guarda datos antiguos. Desde el back office de PrestaShop (si puedes acceder), ve a "Parámetros de la tienda" > "Rendimiento" y haz clic en "Limpiar caché". Si no puedes acceder, borra manualmente la carpeta var/cache mediante FTP.

## Error de "Too many connections"

Este error ocurre cuando el servidor MySQL alcanza el límite de conexiones simultáneas. Es común en tiendas con mucho tráfico o cuando hay procesos mal cerrados.

### Solución 1: Aumenta el límite de conexiones

Si tienes acceso al archivo de configuración de MySQL (my.cnf), busca la línea max_connections y aumenta el valor (por ejemplo, a 500). Luego reinicia MySQL.

En hosting compartido, esta opción suele estar limitada. En ese caso, contacta con tu proveedor y pide que aumenten el límite.

### Solución 2: Cierra conexiones inactivas

Desde phpMyAdmin, puedes ejecutar la consulta SHOW PROCESSLIST; para ver las conexiones activas. Si ves muchas en estado "Sleep" o "Query", puedes matarlas con KILL ID;. Pero esto es una solución temporal.

### Solución 3: Optimiza los módulos y temas

Algunos módulos o temas mal programados pueden abrir muchas conexiones y no cerrarlas. Revisa los módulos instalados y desactiva los que no uses. También puedes activar la "Caché de MySQL" en el back office para reducir el número de consultas.

Preguntas frecuentes (FAQ)

¿Cómo sé si mi base de datos está funcionando?

Desde Syspanel (puerto 2106), en la sección de "Servicios", verás el estado de MySQL. También puedes usar herramientas como phpMyAdmin para intentar conectarte. Si phpMyAdmin funciona, el problema está en la configuración de PrestaShop.

¿Puedo cambiar la contraseña de la base de datos sin romper mi tienda?

Sí, pero debes actualizar el archivo app/config/parameters.php con la nueva contraseña. Si no lo haces, PrestaShop no podrá conectar.

¿Qué hago si no tengo acceso al panel de hosting?

Contacta con tu proveedor de hosting. Ellos pueden verificar el estado del servicio MySQL y ayudarte a restablecer credenciales. Si tienes acceso FTP, al menos puedes revisar el archivo de configuración.

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

Sí, algunos módulos mal codificados pueden saturar la base de datos o usar conexiones incorrectas. Prueba a desactivar módulos recientemente instalados desde el back office (si puedes acceder) o renombrando la carpeta modules mediante FTP para desactivarlos todos temporalmente.

¿Cómo evito estos errores en el futuro?

Realiza copias de seguridad periódicas de tu base de datos.
Mantén PrestaShop y sus módulos actualizados.
Monitorea el rendimiento del servidor con herramientas como Google PageSpeed Insights o las estadísticas de tu hosting.
Si tu tienda crece, considera migrar a un hosting más potente o a un servidor dedicado.

Conclusión

Los errores de conexión a la base de datos en PrestaShop pueden parecer graves, pero en la mayoría de los casos tienen solución con unos pocos pasos. Recuerda siempre:

Revisa el mensaje de error.
Verifica que el servicio MySQL esté activo.
Comprueba las credenciales en app/config/parameters.php.
Asegúrate de que el usuario tenga permisos suficientes.
Si todo falla, limpia la caché y reinicia el servicio.

Con esta guía, ya estás preparado para solucionar errores PrestaShop relacionados con la conexión MySQL PrestaShop. Si el problema persiste, no dudes en contactar con tu soporte técnico, pero ahora ya sabes por dónde empezar.

¡Espero que tu tienda vuelva a funcionar en poco tiempo! Si tienes más dudas, aquí estoy para ayudarte.