🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solución: Error de conexión a la base de datos en PrestaShop (Plesk)

Actualizado el 4 de mayo de 2026

Cuando tu tienda en PrestaShop se cae de repente y en lugar de tu catálogo ves un mensaje críptico sobre la conexión a la base de datos, el susto está garantizado. No te preocupes, es uno de los errores más comunes en el mundo del eCommerce y, en la mayoría de los casos, tiene una solución sencilla. Como tu técnico de soporte de confianza, voy a guiarte paso a paso para diagnosticar y resolver este problema específicamente en un entorno Plesk.

A lo largo de esta guía extensa, desglosaremos el famoso error base de datos prestashop, las causas más frecuentes del prestashop error conexion y, sobre todo, las soluciones prácticas para el plesk prestashop error. Al final, también veremos cómo prevenir el mysql prestashop error en el futuro.


¿Por qué ocurre este error?

Antes de lanzarnos a tocar archivos, es fundamental entender qué significa este fallo. PrestaShop guarda toda su información (productos, clientes, pedidos, configuración) en un servidor MySQL. Para funcionar, necesita una "llave" que conecta el código de la tienda con esa base de datos. Esa llave es un archivo llamado parameters.php que se encuentra en la carpeta app/config/.

Cuando PrestaShop no puede usar esa llave, aparece el temido mensaje: "Error de conexión a la base de datos". Esto puede deberse a tres motivos principales:

  1. Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos.
  2. El servidor MySQL está caído: El servicio de base de datos no está corriendo en el servidor.
  3. Cambios en el entorno: Por ejemplo, si has migrado tu tienda a un nuevo servidor o has cambiado el puerto de conexión.

En un panel Plesk, estos problemas suelen estar relacionados con la gestión de cuentas de usuario y bases de datos. Vamos a atacarlos uno por uno.


Paso 1: Verifica que el servicio MySQL esté activo (El más común)

El plesk prestashop error más habitual no es culpa de tu tienda, sino del motor de la base de datos. Si el servicio MySQL está detenido, ninguna aplicación conectará.

Cómo comprobarlo en Plesk

  1. Accede a tu panel de Plesk (normalmente en https://tu-dominio.com:8443).
  2. En el menú lateral izquierdo, busca la sección "Herramientas y ajustes" (o "Tools & Settings").
  3. Dentro de esa sección, busca el apartado "Servidor" y haz clic en "Servicios" (Services).
  4. Busca en la lista el servicio llamado mysql o mariadb. Asegúrate de que el estado sea "Activo" o "Running".

[WARNING] Si el servicio aparece detenido, intenta iniciarlo haciendo clic en el icono de "play" o "Iniciar". Si no se inicia o se detiene solo, contacta con tu proveedor de hosting, ya que el problema puede ser de hardware o configuración del servidor.


Paso 2: Encuentra y revisa tus credenciales en Plesk

Si el servicio está activo, el siguiente paso es verificar que los datos de acceso son correctos. Plesk guarda la información de la base de datos en un lugar específico. Necesitas el nombre de la base, el usuario y la contraseña.

Localizando los datos en Plesk

  1. En el panel principal de Plesk, ve a "Sitios web y dominios".
  2. Busca tu dominio y haz clic en "Bases de datos" (o "Databases").
  3. Verás una lista de bases de datos. Anota el nombre exacto de la base de datos de tu PrestaShop (suele ser algo como miusuario_prestashop).
  4. Al lado, verás el nombre de usuario de la base de datos (normalmente miusuario_prestashop).
  5. Si no recuerdas la contraseña, tendrás que hacer clic en el icono de "Cambiar contraseña" (normalmente un candado o lápiz) para restablecerla. ¡Apúntala!

[INFO] En Plesk, es muy fácil confundirse con los nombres. A veces el prefijo del usuario y el de la base son diferentes. Asegúrate de copiar ambos exactamente, incluyendo mayúsculas y minúsculas.


Paso 3: Editar el archivo parameters.php (La solución manual)

Ahora viene la parte más delicada. Vamos a comprobar que PrestaShop tiene guardadas esas credenciales correctas en su configuración. Este archivo es el que mencionábamos al principio.

Accediendo al archivo

  1. Abre tu gestor de archivos en Plesk (sección "Administrador de archivos").
  2. Navega hasta httpdocs (o la carpeta raíz donde instalaste PrestaShop).
  3. Entra en la carpeta app, luego en config.
  4. Busca el archivo llamado parameters.php. Haz clic derecho sobre él y selecciona "Editar en el editor de texto".

¿Qué debo buscar dentro del archivo?

Verás un código PHP con una estructura similar a esta:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'USUARIO_NOMBREDB',
'database_user' => 'USUARIO_NOMBREDB',
'database_password' => 'TU_CONTRASEÑA',

[WARNING] Este es el corazón del error base de datos prestashop. Compara los valores de database_name, database_user y database_password con los que anotaste en el Paso 2. Deben coincidir EXACTAMENTE.

¿Qué hago si no coinciden?

  1. Modifica las líneas con los valores correctos.
  2. Guarda el archivo (Ctrl+S o el botón de guardar).
  3. Vuelve a cargar tu tienda.

[TIP] Si después de guardar el error persiste, prueba a borrar los archivos de caché. En la misma carpeta app, busca la carpeta cache y dentro de ella prod. Elimina el contenido de esa carpeta (en algunos casos, los permisos de escritura pueden provocar que se guarde la configuración antigua).


Paso 4: Verificar los permisos de la base de datos (Privilegios)

A veces, la conexión es correcta, pero el usuario de la base de datos no tiene permisos suficientes para leer o escribir. Esto genera un mysql prestashop error intermitente o directamente el fallo de conexión.

Cómo otorgar privilegios en Plesk

  1. Vuelve a la sección "Bases de datos" en tu dominio.
  2. Haz clic en el nombre de tu base de datos.
  3. Busca la pestaña "Usuarios" (o "Users").
  4. Verás el usuario asociado. Marca la casilla de "Todos los privilegios" o asegúrate de que al menos estén marcadas las opciones de SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX y DROP.
  5. Guarda los cambios.

[INFO] Un error típico es que al crear la base de datos en Plesk, solo se le otorguen permisos de "Solo lectura". Si has hecho una restauración reciente de una copia de seguridad, este es un motivo muy común del fallo.


Paso 5: Comprobación avanzada: El puerto de conexión

PrestaShop, por defecto, intenta conectarse al puerto 3306. En servidores Plesk modernos, a veces el MySQL se configura para escuchar en un puerto diferente o se utiliza un socket local. Esto es menos frecuente pero ocurre.

¿Cómo saber si el puerto es el problema?

En el archivo parameters.php que ya has editado, verás la línea 'database_port' => '3306'.

  1. Mantén el puerto como 3306.
  2. Si el error persiste, contacta con tu proveedor de hosting y pregunta si el MySQL usa un puerto personalizado.
  3. Si es así, cambia el valor en el archivo y guarda.

[TIP] Si tu hosting usa un socket, a veces basta con poner 'database_host' => 'localhost' en lugar de una IP específica (como 127.0.0.1). Prueba ambas opciones.


Paso 6: Forzar la regeneración de la caché

PrestaShop es muy "testarudo" con la caché. Aunque edites los archivos, a veces sigue usando los datos antiguos en memoria. Para forzar que tu tienda lea el nuevo archivo parameters.php, haz lo siguiente:

  1. En el "Administrador de archivos" de Plesk, navega a httpdocs/var/cache/.
  2. Dentro, verás carpetas como dev y prod.
  3. Borra todo el contenido de la carpeta prod (y dev si existe). No borres la carpeta en sí, solo los archivos de dentro.
  4. Espera unos segundos y recarga tu tienda.

[WARNING] Si al borrar la caché recibes un error de "permiso denegado", significa que los archivos tienen permisos de solo lectura. Deberás cambiar los permisos de la carpeta var y sus subcarpetas a 755 (lectura, escritura y ejecución para el usuario, lectura y ejecución para el grupo y otros). En Plesk, puedes hacerlo con el botón "Cambiar permisos" en la barra superior del administrador de archivos.


Paso 7: El problema de la migración de servidores

Si este error apareció justo después de mudar tu web de un servidor a otro, el problema es casi seguro el archivo parameters.php. Cuando migramos, copiamos los archivos pero no siempre recordamos que las contraseñas de las bases de datos cambian en el nuevo panel.

En este caso, repite el Paso 2 y el Paso 3 con especial atención. Es el escenario clásico para el prestashop error conexion tras una migración.


Solución alternativa: El modo de mantenimiento

Mientras intentas arreglar el plesk prestashop error, tu tienda está mostrando un mensaje feo a los clientes. Una buena práctica es activar el modo de mantenimiento para que los visitantes vean un mensaje amigable mientras tú trabajas.

¿Cómo activarlo sin entrar al panel?

  1. Ve al "Administrador de archivos".
  2. En la raíz de httpdocs, busca el archivo config/defines.inc.php.
  3. Ábrelo y busca la línea:
    define('_PS_MODE_DEV_', false);
  4. Cámbiala por:
    define('_PS_MODE_DEV_', true);
  5. Guarda y recarga la web. Verás el error detallado en pantalla. Importante: Esto no arregla el error, solo te da más información. Una vez solucionado, vuelve a ponerlo en false.

Preguntas Frecuentes (FAQ)

Para finalizar, respondo a las dudas más habituales que me llegan sobre este tema:

1. ¿Puedo arreglar el error base de datos prestashop sin acceso a Plesk?

No. Necesitas al menos acceso al panel de control (Plesk) para verificar las credenciales o al servidor FTP para editar el archivo parameters.php. Sin eso, no podrás cambiar la contraseña ni ver los nombres de usuario.

2. ¿Qué significa exactamente "mysqli_real_connect(): (HY000/1045): Access denied"?

Este es un subtipo del mysql prestashop error. Significa que el usuario y la contraseña que has puesto en parameters.php no son válidos para ese servidor MySQL. Revisa el Paso 2 y el Paso 3 de nuevo. Es un problema de autenticación, no de conexión.

3. ¿Por qué me piden cambiar la contraseña de la base de datos en Plesk si yo no la he tocado?

Plesk a veces fuerza un cambio de contraseña por políticas de seguridad o porque el administrador del servidor lo ha renovado. Si no recuerdas la contraseña actual, la única opción es restablecerla desde el panel y actualizar el archivo parameters.php con la nueva.

4. ¿Debo cambiar el puerto de MySQL en Plesk?

No. A menos que tu proveedor de hosting te lo indique explícitamente, el puerto por defecto 3306 es el correcto. Cambiarlo sin conocimiento puede romper otras aplicaciones.

5. ¿Puedo evitar este error en el futuro?

Sí. Te recomiendo:

  • Anotar las credenciales en un gestor de contraseñas cada vez que crees una base de datos.
  • No usar "localhost" a menos que sea necesario; a veces usar la IP 127.0.0.1 evita conflictos con el socket de Plesk.
  • Hacer copias de seguridad de la base de datos y de los archivos parameters.php antes de cualquier cambio en el servidor.

Conclusión

El error base de datos prestashop en Plesk puede parecer un monstruo, pero como has visto, es un problema lógico de configuración. Siguiendo estos pasos en orden (verificar servicio, revisar credenciales, editar archivos y limpiar caché), resolverás el prestashop error conexion en la mayoría de los casos.

Si has llegado hasta aquí y el error persiste, no dudes en contactar con tu soporte técnico. A veces el problema está en un firewall del servidor o en una tabla corrupta que requiere reparación desde la línea de comandos, algo que solo un administrador del sistema puede hacer. Pero el 90% de las veces, la solución está en este artículo.

[TIP] La paciencia es clave. Ve paso a paso, no saltes directamente a borrar archivos. Cada cambio que hagas, pruébalo recargando la tienda en una ventana de incógnito para evitar la caché de tu navegador.

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda volverá a estar en línea en un abrir y cerrar de ojos!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel