Errores comunes de PrestaShop en Plesk y cómo solucionarlos

Cuando trabajas con PrestaShop alojado en un servidor gestionado con Plesk, es habitual encontrarse con algunos problemas típicos que pueden frenar tu tienda online. No te preocupes: la mayoría de estos errores tienen una solución sencilla si sabes dónde mirar. En este artículo te explico, paso a paso, cómo resolver los errores comunes de PrestaShop en un entorno Plesk, con un enfoque práctico y sin tecnicismos innecesarios. Al final, tendrás una guía de referencia rápida para mantener tu tienda funcionando sin sobresaltos.

¿Por qué ocurren errores en PrestaShop con Plesk?

PrestaShop es una plataforma potente, pero su configuración depende de muchos factores: permisos de archivos, memoria PHP, módulos desactivados, versiones de software, etc. Plesk es un panel de control excelente para gestionar tu hosting, pero a veces sus valores predeterminados no son los ideales para PrestaShop. Por eso, al migrar o instalar la tienda, pueden aparecer pantallas en blanco, errores 500, problemas con las imágenes o fallos en el carrito de compra.

La buena noticia es que casi todos estos errores se corrigen desde el propio Plesk, sin necesidad de ser un experto en Linux. Solo necesitas acceso al panel y seguir unos pasos muy claros.

Error 500 o pantalla blanca en PrestaShop (White Screen of Death)

Este es, sin duda, el error más temido. La pantalla en blanco suele deberse a un límite de memoria PHP insuficiente o a un módulo incompatible.

Solución paso a paso

Accede a Plesk y ve a la sección de tu dominio donde tienes instalado PrestaShop.
Busca "Configuración de PHP" o "PHP Settings". En muchos planes de Plesk aparece directamente en el menú del dominio.
Aumenta los siguientes valores:
- memory_limit: mínimo 256M (recomendado 512M).
- max_execution_time: 300 segundos.
- max_input_vars: 5000 o más.
- upload_max_filesize: 64M.
- post_max_size: 64M.
Guarda los cambios y reinicia el servicio de PHP desde el propio panel (suele haber un botón "Reiniciar PHP" o "Apply Changes").

[TIP] Si después de esto sigues viendo la pantalla blanca, activa el modo debug de PrestaShop. Edita el archivo /config/defines.inc.php y cambia _PS_MODE_DEV_ a true. Así verás el error real en lugar de una pantalla en blanco.

Error de conexión a la base de datos

PrestaShop no puede conectar con MySQL o MariaDB. Esto puede ocurrir tras un cambio de contraseña, una migración o porque la base de datos se ha corrompido.

Solución paso a paso

En Plesk, ve a "Bases de datos" dentro de tu dominio.
Comprueba que la base de datos y el usuario existen. Si no, créalos de nuevo.
Si la base de datos existe pero no conecta, restablece la contraseña del usuario desde Plesk (opción "Cambiar contraseña").

Luego, actualiza el archivo /app/config/parameters.php de PrestaShop con los nuevos datos:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_nueva_contraseña',

Guarda el archivo y prueba de nuevo.

[INFO] Si usas Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106 y la gestión de bases de datos es similar, aunque el panel se ve diferente.

Imágenes que no se cargan o aparecen rotas

Las imágenes de productos, categorías o módulos no se muestran. Esto suele deberse a permisos incorrectos en las carpetas de imágenes o a la falta de la librería GD en PHP.

Solución paso a paso

En Plesk, ve a "Configuración de PHP" y asegúrate de que la extensión gd está habilitada. Si no aparece, actívala desde el selector de extensiones.
Conecta por FTP o desde el administrador de archivos de Plesk y ve a la carpeta img/ de tu PrestaShop.
Cambia los permisos de toda la carpeta img/ a 755 (o 775 si tu servidor lo requiere). Haz lo mismo con la subcarpeta tmp/.
Regenera las miniaturas desde el panel de administración de PrestaShop: Parámetros de la tienda > Imágenes > Regenerar miniaturas.

[WARNING] No pongas permisos 777 en carpetas de producción, ya que es un riesgo de seguridad. Con 755 suele ser suficiente.

Error "No se puede escribir en la carpeta cache" o "No se puede escribir en el directorio de archivos temporales"

PrestaShop necesita permisos de escritura en varias carpetas para funcionar correctamente. Si no los tiene, aparecen estos mensajes.

Solución paso a paso

Desde el administrador de archivos de Plesk o por FTP, localiza las siguientes carpetas en la raíz de PrestaShop:
- /cache
- /log
- /img/tmp
- /upload
- /download
- /themes/default/cache (o el nombre de tu tema)
Cambia los permisos de cada una a 755 (o 775 si tu servidor lo exige).
Si el error persiste, revisa el propietario de los archivos. En Plesk puedes cambiar el propietario desde la opción "Cambiar propietario" en el administrador de archivos. Debe coincidir con el usuario del dominio (suele ser algo como dominio_ftp).

[TIP] Si tienes dudas sobre qué permisos usar, consulta la documentación oficial de PrestaShop. En general, 755 para carpetas y 644 para archivos es la norma.

Problemas con el carrito de compra: no se añaden productos o se vacía solo

Esto puede deberse a cookies mal configuradas, problemas con la sesión PHP o conflictos con módulos de pago.

Solución paso a paso

En Plesk, ve a "Configuración de PHP" y asegúrate de que session.save_path está definido y tiene permisos de escritura. Si no, puedes cambiarlo a una ruta como /tmp.
Borra las cookies del navegador y prueba de nuevo.
Desactiva todos los módulos de pago y transporte temporalmente desde el panel de administración de PrestaShop para descartar conflictos.
Si el error persiste, accede a "Parámetros avanzados > Rendimiento" en PrestaShop y limpia la caché.

[INFO] En algunos casos, el problema está en el módulo de pago. Prueba a actualizarlo o reinstalarlo desde el marketplace de PrestaShop.

Errores al actualizar PrestaShop o al instalar módulos

Las actualizaciones fallan por límites de tiempo de ejecución, falta de espacio en disco o permisos insuficientes.

Solución paso a paso

Aumenta los valores de PHP como indicamos en el primer punto: max_execution_time a 600 segundos y memory_limit a 512M.
Comprueba el espacio en disco desde Plesk en la sección de "Estadísticas del dominio". Si está lleno, libera espacio o contacta con tu proveedor.
Si el error es de permisos, asegúrate de que toda la carpeta de PrestaShop tenga permisos 755 (carpetas) y 644 (archivos), excepto las carpetas de escritura mencionadas antes.
Desactiva temporalmente el modo de producción en PrestaShop desde "Parámetros avanzados > Rendimiento" y ponlo en modo desarrollo.

[WARNING] Nunca fuerces una actualización manual si no tienes un backup reciente. Siempre haz una copia de seguridad completa desde Plesk (opción "Backup Manager") antes de cualquier cambio importante.

Error "El archivo no se ha podido subir" al cargar imágenes o productos

Esto suele deberse a límites de tamaño de archivo o a la configuración de PHP.

Solución paso a paso

En Plesk, ve a "Configuración de PHP" y aumenta upload_max_filesize y post_max_size a 64M o más.
Si tu PrestaShop tiene un límite interno, ve a "Parámetros de la tienda > Imágenes" y aumenta el tamaño máximo permitido.
Comprueba que la carpeta /upload tiene permisos 755 y que no está llena.

[TIP] Si usas un servidor compartido, el proveedor puede tener límites globales. En ese caso, contacta con soporte para que los aumenten.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop se vuelve lento después de unos meses?

Suele deberse a una base de datos muy grande sin limpiar, caché desactivada o módulos pesados. En Plesk puedes activar la caché de PHP (OPcache) desde la configuración de PHP. También es recomendable limpiar la tabla ps_log y desactivar logs innecesarios desde el panel de PrestaShop.

¿Cómo sé qué versión de PHP tengo en Plesk?

En Plesk, ve a tu dominio y busca "Configuración de PHP". Allí verás la versión actual. PrestaShop 1.7 necesita PHP 7.1 o superior, y la versión 8.0 es recomendada para las últimas versiones.

¿Puedo usar Syspanel (HestiaCP) para gestionar PrestaShop?

Sí, Syspanel (antes HestiaCP) también permite gestionar bases de datos y configurar PHP. El puerto de acceso es el 2106. La interfaz es diferente a Plesk, pero los conceptos son los mismos: permisos, memoria PHP y extensiones. Si tienes dudas, busca guías específicas de Syspanel para PrestaShop.

¿Qué hago si no veo la opción de cambiar permisos en Plesk?

En Plesk, la opción de permisos está en el administrador de archivos. Selecciona la carpeta o archivo, haz clic en "Cambiar permisos" y elige 755 para carpetas y 644 para archivos. Si no aparece, prueba a usar un cliente FTP como FileZilla.

¿Es necesario reiniciar algo después de cambiar la configuración de PHP?

Sí, después de modificar los valores de PHP en Plesk, suele aparecer un botón "Reiniciar PHP" o "Apply Changes". Si no lo ves, espera unos minutos o reinicia el servicio desde la sección de "Servicios" del panel.

Conclusión

Los errores comunes de PrestaShop en un entorno Plesk no tienen por qué ser un dolor de cabeza. Con unos pocos ajustes en la configuración de PHP, permisos de archivos y una gestión básica de la base de datos, puedes resolver la mayoría de los problemas. Recuerda siempre hacer copias de seguridad antes de cualquier cambio y mantener tu PrestaShop actualizado.

Si después de seguir estos pasos el error persiste, puede ser un problema más específico del servidor o de algún módulo. En ese caso, no dudes en contactar con tu proveedor de hosting o con la comunidad de PrestaShop. Con paciencia y método, tu tienda online volverá a funcionar como un reloj.