Cómo solucionar el error de conexión a la base de datos en PrestaShop en Plesk

¡Hola! Soy el técnico de soporte. Si estás leyendo esto, probablemente te has encontrado con el temido error de conexión a la base de datos en PrestaShop alojado en Plesk. No te preocupes, es uno de los problemas más comunes y, por suerte, tiene solución. En esta guía te explicaré paso a paso cómo identificarlo y arreglarlo, incluso si no eres un experto en hosting.

¿Qué significa este error y por qué ocurre?

Cuando tu tienda PrestaShop muestra un mensaje como "Error de conexión a la base de datos", significa que tu sitio web no puede comunicarse con la base de datos donde se almacenan productos, pedidos y configuraciones. Esto puede deberse a varias razones, desde un cambio de contraseña hasta un problema en el servidor.

En Plesk, la gestión de bases de datos es bastante sencilla, pero a veces pequeños cambios pueden romper la conexión. Vamos a ver las causas más frecuentes y cómo solucionarlas.

[INFO] Este error puede aparecer tanto en el frontend (la tienda visible) como en el backend (el panel de administración). No importa dónde lo veas, los pasos para solucionarlo son los mismos.

Paso 1: Verifica que la base de datos exista y esté activa

Lo primero es asegurarte de que la base de datos que usa PrestaShop siga existiendo en tu panel de Plesk.

¿Cómo hacerlo en Plesk?

Inicia sesión en tu panel de Plesk (normalmente accedes a través de https://tudominio.com:8443 o la URL que te haya proporcionado tu proveedor).
Busca la sección Bases de datos (suele estar en el menú de la izquierda o en la pestaña "Sitios web y dominios").
Revisa la lista de bases de datos. Deberías ver una que corresponda a tu PrestaShop (normalmente tiene un nombre como prestashop_xxxx o similar).
Si la base de datos no aparece, puede que la hayas eliminado accidentalmente. En ese caso, necesitarás restaurarla desde una copia de seguridad o crearla de nuevo (y luego importar los datos).

Si la base de datos existe pero está inactiva (por ejemplo, el servicio MySQL no se está ejecutando), contacta a tu proveedor de hosting, ya que es un problema del servidor.

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

La mayoría de las veces, el error se debe a que las credenciales (usuario, contraseña, nombre de la base de datos) en el archivo de configuración de PrestaShop no coinciden con las reales.

¿Dónde está ese archivo?

En la raíz de tu instalación de PrestaShop, busca el archivo app/config/parameters.php. Si usas una versión anterior a la 1.7, puede ser config/settings.inc.php. Ábrelo con un editor de texto (Notepad, Sublime Text, etc.) o desde el administrador de archivos de Plesk.

¿Qué debes revisar?

Busca estas líneas (en parameters.php se verán así):

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_base',
'database_user' => 'usuario_de_la_base',
'database_password' => 'contraseña_de_la_base',

Pasos a seguir:

Confirma el nombre de la base de datos: En Plesk, ve a la sección Bases de datos y copia exactamente el nombre que aparece (incluyendo mayúsculas, minúsculas y guiones bajos).
Verifica el usuario: Asegúrate de que el usuario existe y tiene permisos sobre esa base de datos. En Plesk, puedes ver los usuarios asociados a cada base de datos.
Revisa la contraseña: El error más común es que la contraseña haya cambiado (por ejemplo, si la restableciste desde Plesk). Si no la recuerdas, puedes cambiarla desde Plesk:
- En la sección Bases de datos, haz clic en el nombre de tu base.
- Busca la opción Cambiar contraseña o Editar usuario.
- Anota la nueva contraseña y actualízala en el archivo parameters.php.

[WARNING] Si cambias la contraseña desde Plesk, asegúrate de actualizarla también en el archivo de configuración de PrestaShop. De lo contrario, el error persistirá.

Paso 3: Verifica la conexión desde Plesk (prueba rápida)

Una forma sencilla de saber si el problema es de PrestaShop o del servidor es probar la conexión manualmente desde Plesk.

¿Cómo hacerlo?

En Plesk, ve a Bases de datos y selecciona tu base de datos.
Busca la opción phpMyAdmin (suele ser un botón o enlace). Esto abrirá una herramienta web para gestionar la base.
Si phpMyAdmin se abre sin problemas y ves las tablas, la base de datos funciona correctamente. Entonces el error está en la configuración de PrestaShop.
Si phpMyAdmin muestra un error de conexión, entonces el problema es del servidor (por ejemplo, el servicio MySQL está caído). Contacta a tu proveedor de hosting.

Paso 4: Revisa el host de la base de datos (local vs remoto)

En la mayoría de los casos, el host de la base de datos es localhost. Sin embargo, en algunos entornos de Plesk (especialmente en servidores compartidos) puede ser necesario usar una dirección IP o un nombre de host específico.

¿Cómo saberlo?

En Plesk, ve a la sección Bases de datos y haz clic en el nombre de tu base. Busca el campo Servidor o Host. Si dice localhost, déjalo así. Si aparece una IP (ej. 127.0.0.1 o una IP pública), úsala en el archivo de configuración.

[TIP] Si tienes dudas, consulta con tu proveedor de hosting. Ellos saben qué valor debe ir en database_host.

Paso 5: Comprueba los permisos del usuario de la base de datos

A veces el usuario tiene acceso a la base de datos, pero no todos los permisos necesarios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Esto puede causar errores extraños.

Cómo verificar y corregir permisos en Plesk:

En la sección Bases de datos, haz clic en el nombre de tu base.
Busca la opción Usuarios o Administrar usuarios.
Verás una lista de usuarios asociados. Haz clic en el que usa PrestaShop.
Asegúrate de que tenga marcados todos los permisos (o al menos los básicos: SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, ALTER, DROP).
Si no están todos, actívalos y guarda los cambios.

Paso 6: Revisa el archivo .htaccess (en casos raros)

Si después de todo lo anterior el error persiste, puede que el archivo .htaccess de PrestaShop esté bloqueando la conexión. Esto es poco común, pero vale la pena revisarlo.

¿Qué hacer?

Accede al administrador de archivos de Plesk (o usa FTP).
Busca el archivo .htaccess en la raíz de tu PrestaShop.
Renómbralo temporalmente a .htaccess_old para desactivarlo.
Recarga tu tienda. Si el error desaparece, el problema está en ese archivo. Puedes regenerarlo desde el panel de administración de PrestaShop (en Parámetros de la tienda > Tráfico y SEO > URL amigables, y guarda sin cambios).

Paso 7: Restaura una copia de seguridad (solución de emergencia)

Si nada funciona y tienes una copia de seguridad reciente de tu base de datos, puedes restaurarla. Esto es especialmente útil si el error apareció después de un cambio que hiciste.

Cómo restaurar en Plesk:

Ve a Bases de datos y selecciona tu base.
Busca la opción Importar o Restaurar.
Sube el archivo .sql de tu copia de seguridad.
Una vez restaurada, verifica que las credenciales en parameters.php sigan siendo las mismas.

[INFO] Si no tienes copia de seguridad, contacta a tu proveedor de hosting. Algunos ofrecen backups automáticos.

FAQ: Preguntas frecuentes sobre este error

1. ¿Por qué aparece este error después de migrar mi tienda a otro servidor?

Es muy común. Al migrar, cambian los nombres de las bases de datos, usuarios y contraseñas. Debes actualizar el archivo parameters.php con los nuevos datos. Además, asegúrate de que la base de datos esté importada correctamente.

2. ¿Puedo solucionarlo sin acceder a Plesk?

Si no tienes acceso a Plesk, necesitarás usar FTP o el panel de archivos de tu hosting para editar el archivo parameters.php. También puedes pedir a tu proveedor que verifique las credenciales.

3. ¿El error puede deberse a un plugin o tema?

Sí, aunque es menos frecuente. Si el error aparece después de instalar un módulo, desactívalo renombrando su carpeta en /modules/ (por ejemplo, cambia mimodulo a mimodulo_old). Luego recarga la tienda.

4. ¿Qué hago si veo el error "El servidor MySQL no responde"?

Eso indica un problema del servidor. Contacta a tu proveedor de hosting inmediatamente. No es algo que puedas solucionar desde el panel de PrestaShop.

5. ¿Cómo evito que esto vuelva a pasar?

Haz copias de seguridad periódicas de tu base de datos y archivos.
Anota las credenciales en un lugar seguro.
Evita cambiar contraseñas sin actualizar el archivo de configuración.

Conclusión: No entres en pánico, todo tiene solución

El error de conexión a la base de datos en PrestaShop en Plesk es frustrante, pero siguiendo estos pasos podrás resolverlo en la mayoría de los casos. Recuerda que la clave está en verificar las credenciales, los permisos y el estado de la base de datos.

Si después de todo esto el problema persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen acceso directo al servidor y pueden ayudarte más rápido.

[TIP] Para futuras referencias, guarda esta guía. Te será útil si alguna vez cambias de servidor o actualizas PrestaShop.

¡Espero que tu tienda vuelva a funcionar en pocos minutos! Si tienes más dudas, déjalas en los comentarios (si este artículo está en un blog) o consulta con tu proveedor. ¡Buena suerte!