Errores comunes de PrestaShop en Plesk y cómo solucionarlos
¿Tu tienda PrestaShop alojada en Plesk se ha vuelto lenta, muestra pantallas en blanco o errores extraños? No te preocupes. Es muy común encontrarse con problemas PrestaShop Plesk, especialmente después de una actualización, un cambio de servidor o al instalar un módulo nuevo.
En esta guía, vamos a ver los errores PrestaShop Plesk más frecuentes y te daré una PrestaShop Plesk solución paso a paso para cada uno. Todo explicado de forma sencilla, como si lo hicieras con un amigo al lado.
Vamos a ello.
1. Error 500 – Internal Server Error (Pantalla en Blanco)
Este es, sin duda, uno de los problemas PrestaShop Plesk más temidos. De repente, tu tienda deja de cargar y solo ves una página en blanco o un mensaje "500 Internal Server Error". La causa suele ser un archivo de configuración corrupto o un módulo incompatible.
Solución paso a paso:
-
Habilitar el modo debug de PrestaShop. Esto te mostrará el error real en lugar de la pantalla en blanco.
- Accede a tu panel de Plesk y ve a Administrador de archivos.
- Busca el archivo
config/defines.inc.phpen la raíz de tu PrestaShop. - Edítalo (botón derecho -> Editar en el editor de texto).
- Busca la línea:
define('_PS_MODE_DEV_', false); - Cámbiala a:
define('_PS_MODE_DEV_', true); - Guarda los cambios. Ahora, al recargar tu tienda, verás un mensaje de error detallado (por ejemplo, un error de memoria o de un archivo faltante).
-
Aumentar el límite de memoria PHP. Muchas veces el error 500 se debe a que PrestaShop se queda sin memoria.
- En Plesk, ve a Hosting y DNS > Configuración de hosting para tu dominio.
- Busca la sección Configuración de PHP.
- Aumenta el valor de
memory_limita256Mo incluso512M. También puedes subirmax_execution_timea120. - Guarda los cambios.
-
Revisar archivos .htaccess. Un
.htaccessdañado puede provocar el error 500.- En el Administrador de archivos, localiza el archivo
.htaccessen la raíz. - Renómbralo a
.htaccess_oldpara desactivarlo. - Recarga tu tienda. Si funciona, el problema está en ese archivo. Ve a tu backoffice de PrestaShop (si puedes acceder) y ve a Configuración avanzada > Rendimiento y haz clic en Guardar (esto regenerará el .htaccess correctamente).
- En el Administrador de archivos, localiza el archivo
[TIP] Si no ves el archivo
.htaccess, asegúrate de tener activada la opción "Mostrar archivos ocultos" en el Administrador de archivos de Plesk.
2. Error de Conexión a la Base de Datos
Otro clásico entre los errores PrestaShop Plesk. Tu tienda muestra un mensaje como "Cannot connect to database" o "Error de conexión a la base de datos". Normalmente ocurre al mover la tienda o cambiar la contraseña de la base de datos.
Solución paso a paso:
-
Verificar los datos de conexión en el archivo de configuración.
- Ve a Administrador de archivos en Plesk.
- Abre el archivo
app/config/parameters.php. - Busca las líneas:
'database_host' => 'localhost', 'database_name' => 'tu_basededatos', 'database_user' => 'tu_usuario', 'database_password' => 'tu_contraseña', - Asegúrate de que coinciden exactamente con los datos de tu base de datos en Plesk (puedes verlos en Bases de datos en el panel de Plesk).
-
Comprobar que el usuario tiene permisos.
- En Plesk, ve a Bases de datos.
- Selecciona la base de datos de tu PrestaShop.
- Haz clic en Añadir usuario (o edita el existente) y asegúrate de que tenga todos los privilegios marcados.
-
Probar la conexión manualmente.
- En Plesk, ve a Bases de datos y haz clic en phpMyAdmin.
- Si accedes sin problemas, la base de datos funciona. El error está en el
parameters.php. Si no accedes, el problema es de permisos o de que la base de datos no existe.
[WARNING] Ten mucho cuidado al editar
parameters.php. Un error de sintaxis (como una coma o comilla de más) romperá toda la tienda. Haz siempre una copia de seguridad antes.
3. Error "PrestaShop no puede cargar el módulo" o "Clase no encontrada"
Este error suele aparecer después de instalar un módulo nuevo o al actualizar PrestaShop. Es muy común verlo como problemas PrestaShop Plesk relacionados con la caché o archivos de módulos corruptos.
Solución paso a paso:
-
Limpiar la caché de PrestaShop.
- Desde el backoffice de tu tienda (si puedes acceder): ve a Configuración avanzada > Rendimiento y haz clic en Limpiar caché.
- Si no accedes al backoffice, hazlo manualmente: en el Administrador de archivos de Plesk, elimina todo el contenido de la carpeta
var/cache/(no la carpeta en sí, solo su interior).
-
Desactivar el módulo problemático.
- Si sabes qué módulo causa el error, renombra su carpeta en el servidor. Por ejemplo, si el módulo se llama
mimodulo, ve amodules/mimodulo/y renómbrala amimodulo_desactivado. - Esto forzará a PrestaShop a ignorarlo. Luego, desde el backoffice, puedes desinstalarlo.
- Si sabes qué módulo causa el error, renombra su carpeta en el servidor. Por ejemplo, si el módulo se llama
-
Verificar los permisos de archivos y carpetas.
- A veces los módulos no se pueden leer porque los permisos son incorrectos.
- En Plesk, selecciona toda la carpeta de tu tienda (raíz del dominio).
- Haz clic en Permisos de archivos (o Cambiar permisos).
- Aplica los permisos estándar de PrestaShop: 755 para carpetas y 644 para archivos. Puedes marcar "Recursivo" para que se aplique a todo.
[INFO] Si usas Syspanel (antes conocido como HestiaCP), recuerda que el acceso es por el puerto 2106. Allí también puedes gestionar los permisos de archivos desde el Administrador de archivos integrado.
4. Error de Carga Lenta o Timeout (504 Gateway Timeout)
¿Tu tienda tarda una eternidad en cargar y al final da error 504? Esto es típico cuando el servidor no tiene suficiente potencia o hay algún script ejecutándose eternamente. Es uno de los problemas PrestaShop Plesk que más frustran a los dueños de tiendas.
Solución paso a paso:
-
Aumentar el tiempo de ejecución de PHP.
- En Configuración de hosting de Plesk, busca
max_execution_timey súbelo a120o180.
- En Configuración de hosting de Plesk, busca
-
Optimizar la base de datos.
- Ve a Bases de datos en Plesk y abre phpMyAdmin.
- Selecciona tu base de datos y haz clic en la pestaña Operaciones.
- Busca la opción Optimizar tablas y ejecútala. Esto ayuda a que las consultas sean más rápidas.
-
Activar la caché de PrestaShop.
- En el backoffice, ve a Configuración avanzada > Rendimiento.
- En Caché, selecciona Sistema de archivos (o Memcached si tu servidor lo tiene). Esto reduce la carga en el servidor.
-
Comprobar los logs del servidor.
- En Plesk, ve a Registros (o Logs) para tu dominio.
- Revisa el archivo
error_log. Allí verás si hay un script específico que esté causando el timeout. Por ejemplo, un módulo de envío de correos o de generación de PDF.
[TIP] Si tu tienda sigue lenta, considera contratar un plan de hosting con más recursos (más RAM, CPU). A veces, el error no es de configuración sino de capacidad del servidor.
5. Error "El archivo no se puede subir" o "Error de permisos al subir imágenes"
Este error es muy común al intentar subir productos o imágenes desde el backoffice de PrestaShop. El problema suele estar en los permisos de la carpeta img o en el límite de subida de PHP.
Solución paso a paso:
-
Aumentar el límite de subida de archivos en PHP.
- En Configuración de hosting de Plesk, busca
upload_max_filesizeypost_max_size. Ponlos a64Mo128M.
- En Configuración de hosting de Plesk, busca
-
Verificar permisos de las carpetas de imágenes.
- En el Administrador de archivos, ve a la carpeta
img. - Asegúrate de que tenga permisos 755 y que el propietario sea el usuario correcto (normalmente el mismo que el del dominio).
- En el Administrador de archivos, ve a la carpeta
-
Regenerar las miniaturas (thumbnails).
- A veces el error es porque las miniaturas están corruptas.
- En el backoffice, ve a Configuración avanzada > Rendimiento y haz clic en Regenerar miniaturas (si está disponible). Si no, puedes hacerlo desde el módulo "Imágenes" en el menú de Diseño.
[WARNING] No subas imágenes de más de 2 MB. PrestaShop puede saturarse. Optimiza tus imágenes antes de subirlas.
6. Error de SSL/HTTPS (Contenido Mixto)
Después de instalar un certificado SSL en Plesk, es posible que tu tienda se vea rara: iconos rotos, estilos sin cargar, o un candado rojo en el navegador. Esto es por contenido mixto (partes de la web cargadas con HTTP en lugar de HTTPS).
Solución paso a paso:
-
Configurar HTTPS en PrestaShop.
- Ve a Configuración avanzada > Rendimiento.
- Activa la opción Usar SSL en todas las páginas.
- Guarda.
-
Forzar HTTPS desde el .htaccess.
- Edita el archivo
.htaccessen la raíz. - Añade estas líneas al principio:
RewriteEngine On RewriteCond %{HTTPS} off RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L] - Guarda. Esto redirigirá todo el tráfico a HTTPS.
- Edita el archivo
-
Actualizar las URLs en la base de datos.
- Si tienes muchas URLs HTTP almacenadas, puedes usar una consulta SQL en phpMyAdmin:
UPDATE ps_configuration SET value = 'https://tudominio.com' WHERE name = 'PS_SHOP_DOMAIN'; UPDATE ps_configuration SET value = 'https://tudominio.com' WHERE name = 'PS_SHOP_DOMAIN_SSL'; - Reemplaza
tudominio.compor tu dominio real.
- Si tienes muchas URLs HTTP almacenadas, puedes usar una consulta SQL en phpMyAdmin:
[INFO] Si usas Syspanel, el proceso es similar: desde el panel de control (puerto 2106) puedes gestionar los certificados SSL y redirecciones.
Preguntas Frecuentes (FAQ)
¿Por qué mi PrestaShop en Plesk se cae a menudo?
Puede deberse a falta de recursos del servidor, un módulo mal optimizado o picos de tráfico. Revisa los logs y considera actualizar tu plan.
¿Cómo puedo hacer una copia de seguridad de mi tienda en Plesk?
Ve a Herramientas y utilidades > Copias de seguridad en Plesk. Puedes programar copias automáticas diarias. Siempre guarda una copia antes de hacer cambios grandes.
¿Puedo instalar módulos de PrestaShop directamente desde Plesk?
No, los módulos se instalan desde el backoffice de PrestaShop. Pero puedes subir archivos manualmente al servidor usando el Administrador de archivos de Plesk.
Mi tienda da error después de actualizar PHP. ¿Qué hago?
PrestaShop necesita una versión de PHP compatible (normalmente 7.4, 8.0 o 8.1). En Configuración de hosting de Plesk, puedes cambiar la versión de PHP. Si hay errores, prueba con una versión anterior.
Conclusión
Los errores PrestaShop Plesk pueden ser frustrantes, pero la mayoría tienen una PrestaShop Plesk solución sencilla si sabes dónde mirar. Recuerda siempre:
- Habilitar el modo debug para ver el error real.
- Revisar los logs del servidor en Plesk.
- Aumentar los límites de PHP (memoria, tiempo de ejecución, subida).
- Limpiar la caché después de cualquier cambio.
Si sigues estos pasos, podrás resolver el 90% de los problemas PrestaShop Plesk que te encuentres. Y si no, siempre puedes contactar a tu proveedor de hosting o a un técnico especializado.
¡Espero que esta guía te haya sido de gran ayuda! Ahora ya sabes cómo enfrentarte a esos errores sin miedo.
