Errores comunes en PrestaShop en Plesk y cómo solucionarlos

Introducción: ¿Por qué aparecen errores en PrestaShop en Plesk?

Si gestionas una tienda online con PrestaShop alojada en un servidor con panel Plesk, es probable que en algún momento te encuentres con algún error inesperado. No te preocupes, es algo normal. La combinación de PrestaShop (un software muy potente pero exigente) y Plesk (un panel de control muy completo) puede generar algunos conflictos comunes, sobre todo por temas de configuración del servidor, permisos de archivos o versiones de PHP.

Este artículo está pensado para que, como usuario sin experiencia técnica, puedas identificar y solucionar los errores PrestaShop más frecuentes en un entorno Plesk. Te guiaremos paso a paso, con un lenguaje claro y ejemplos prácticos. Al final, también encontrarás una sección FAQ PrestaShop que responde a las dudas más habituales.

Vamos a ello.

## Error 500 Internal Server Error en PrestaShop

Este es, sin duda, uno de los errores PrestaShop más temidos. Aparece de repente y no da mucha información. Generalmente, la causa está en un archivo .htaccess corrupto, un módulo incompatible o un problema de memoria PHP.

### Solución paso a paso

Genera un nuevo archivo .htaccess desde el panel de administración de PrestaShop.
Ve a Configuración de la tienda > Tráfico y SEO > SEO y URL.
Haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo automáticamente.
Aumenta el límite de memoria PHP desde Plesk.
- Accede a Plesk y ve a tu dominio.
- Busca la sección "PHP Settings" (Configuración de PHP).
- Aumenta memory_limit a al menos 256M (o 512M si tu tienda tiene muchos productos).
- También es recomendable subir max_execution_time a 300 y upload_max_filesize a 64M.
Desactiva módulos recién instalados.
Si el error apareció tras instalar un módulo, accede a tu tienda por FTP o desde el administrador de archivos de Plesk y renombra la carpeta del módulo en /modules/ (por ejemplo, cambia micodigo a micodigo_old). Esto lo desactivará temporalmente.

[INFO] Si no puedes acceder al panel de administración, puedes editar el archivo .htaccess directamente desde el administrador de archivos de Plesk. Busca en la raíz de tu dominio y renómbralo a .htaccess_old. Luego intenta acceder a tu tienda; si funciona, ya sabes que el problema estaba ahí.

## Error de conexión a la base de datos (Error establishing a database connection)

Este error suele aparecer cuando PrestaShop no puede comunicarse con la base de datos MySQL. Las causas más comunes son cambios en la contraseña de la base de datos o un fallo en el servidor de bases de datos.

### Solución paso a paso

Verifica los datos de conexión en el archivo app/config/parameters.php.
Accede a tu dominio desde el administrador de archivos de Plesk.
Busca el archivo parameters.php en la carpeta app/config/.
Ábrelo y comprueba que los valores de database_host, database_name, database_user y database_password son correctos.
Comprueba que la base de datos está activa en Plesk.
- Ve a "Bases de datos" en Plesk.
- Asegúrate de que la base de datos de tu tienda aparece y no está bloqueada.
- Puedes probar la conexión usando phpMyAdmin (desde la misma sección de bases de datos en Plesk).
Reinicia el servicio de MySQL desde Plesk (si tienes acceso).
En algunos planes de hosting, puedes reiniciar servicios desde "Herramientas y ajustes" > "Servicios".
Busca "MySQL" y haz clic en reiniciar.

[WARNING] Si cambiaste la contraseña de la base de datos recientemente y olvidaste actualizarla en PrestaShop, este error es casi seguro. Edita el archivo parameters.php con la nueva contraseña.

## Error de página en blanco (White Screen of Death)

La temida pantalla en blanco sin ningún mensaje. Esto suele deberse a un error de PHP que está oculto por la configuración de errores.

### Solución paso a paso

Activa la visualización de errores de PHP temporalmente.
- Accede al archivo config/defines.inc.php en la raíz de tu PrestaShop.
- Busca la línea: define('_PS_MODE_DEV_', false);
- Cámbiala a: define('_PS_MODE_DEV_', true);
- Ahora recarga tu tienda. Verás los errores concretos en la pantalla.
Identifica el error y actúa en consecuencia.
Los errores más comunes que verás son:
- Allowed memory size exhausted: Aumenta memory_limit en la configuración de PHP de Plesk.
- Call to undefined function: Puede ser un módulo que necesita una extensión PHP. Actívala desde "PHP Settings" en Plesk (por ejemplo, curl, gd, mbstring).
- Parse error: Hay un error de sintaxis en algún archivo. Revisa si has modificado algún archivo recientemente.
Una vez solucionado, vuelve a poner define('_PS_MODE_DEV_', false); para que los errores no se muestren a tus clientes.

[TIP] Si no puedes editar archivos, puedes añadir estas líneas al archivo .htaccess para ver errores:
php_flag display_errors on
php_value error_reporting 32767

## Errores relacionados con la caché y las plantillas

PrestaShop usa un sistema de caché muy agresivo. A veces, al actualizar un tema o módulo, los cambios no se ven porque la caché guarda versiones antiguas.

### Solución paso a paso

Limpia la caché desde el panel de administración.
Ve a Configuración avanzada > Rendimiento.
Haz clic en "Limpiar la caché" (tanto la de Smarty como la de memoria).
Borra la carpeta var/cache/ manualmente (si no tienes acceso al panel).
Usa el administrador de archivos de Plesk o FTP.
Elimina todo el contenido de la carpeta var/cache/ (no la carpeta en sí, solo su interior).
Desactiva la caché temporalmente para pruebas.
En la misma página de Rendimiento, cambia "Caché" a "No".

[INFO] Si cambiaste el tema y ves la página en blanco o con errores, puede que el nuevo tema no sea compatible con tu versión de PrestaShop. Vuelve al tema por defecto desde la base de datos (tabla ps_configuration, campo PS_CATALOG_MODE). Si no te sientes seguro, contacta con soporte.

## Error al subir imágenes o productos (límite de tamaño)

Este error suele mostrar un mensaje como "El archivo es demasiado grande" o "Error al subir la imagen". La causa es un límite bajo en la configuración de PHP.

### Solución paso a paso

Aumenta los límites desde Plesk.
- En "PHP Settings", busca upload_max_filesize y post_max_size.
- Sube ambos a 64M o 128M si trabajas con imágenes de alta resolución.
- También revisa max_execution_time y ponlo a 300.
Comprueba los límites de PrestaShop.
En el panel de administración, ve a Configuración avanzada > Rendimiento.
Busca "Tamaño máximo de archivo para subir" y ajústalo.
Si usas un CDN o servidor externo, revisa sus límites.
Algunos servicios de almacenamiento tienen sus propias restricciones.

[WARNING] No subas upload_max_filesize a valores extremadamente altos (como 1GB) porque podría saturar el servidor. 64MB suele ser más que suficiente para una tienda online.

## FAQ PrestaShop: Preguntas frecuentes sobre errores en Plesk

Aquí tienes las respuestas a las dudas más comunes que recibimos en soporte técnico.

### ¿Por qué mi tienda PrestaShop se vuelve muy lenta en Plesk?

La lentitud suele deberse a:

PHP demasiado antiguo: Asegúrate de usar PHP 7.4 o superior (PHP 8.x es recomendado).
Caché desactivada: Actívala en Rendimiento.
Módulos mal optimizados: Revisa los módulos instalados y desactiva los que no uses.
Base de datos sin optimizar: Usa phpMyAdmin desde Plesk para reparar y optimizar tablas.

### ¿Cómo actualizar PrestaShop en Plesk sin perder datos?

Haz una copia de seguridad completa desde Plesk (archivos y base de datos).
Descarga la última versión de PrestaShop desde la web oficial.
Sube los archivos (sin sobrescribir la carpeta app/config/ ni la base de datos).
Accede a /install/ y sigue el asistente de actualización.
Elimina la carpeta /install/ tras finalizar.

[INFO] Si tu versión es muy antigua (1.6 o anterior), es más seguro contratar a un profesional. Las actualizaciones grandes pueden romper el tema o los módulos.

### ¿Qué hago si no puedo acceder al panel de administración de PrestaShop?

Prueba a limpiar la caché del navegador o usar otro navegador.
Accede mediante la URL directa: tudominio.com/admin1234 (donde admin1234 es el nombre de tu carpeta de administración).
Si el error persiste, revisa el archivo .htaccess (como explicamos antes).
Restablece la contraseña de administrador desde la base de datos (tabla ps_employee).

### ¿Cómo soluciono el error "El token de seguridad ha caducado"?

Este error ocurre al iniciar sesión en el panel de administración. Suele deberse a:

Problemas de cookies: Limpia las cookies del navegador.
IP dinámica: Si tu IP cambia constantemente, PrestaShop puede rechazar la sesión. En Plesk, puedes desactivar la verificación de IP en Configuración avanzada > Administración.
Servidor con alta latencia: Aumenta max_execution_time en PHP.

### Mi tienda muestra "Error 503 Service Unavailable" ¿qué hago?

Un error 503 suele indicar que el servidor está sobrecargado o que hay un plugin de seguridad bloqueando el acceso. Prueba a:

Desactivar temporalmente los módulos de seguridad (como firewall).
Revisar el archivo error.log en la carpeta var/logs/ de PrestaShop.
Contactar con tu proveedor de hosting si el error persiste, ya que puede ser un problema de recursos del servidor.

## Consejos finales para evitar errores PrestaShop en Plesk

Mantén todo actualizado: PrestaShop, módulos, temas y la versión de PHP en Plesk.
Haz copias de seguridad semanales: Desde Plesk puedes programarlas automáticamente.
Usa PHP 8.0 o superior: Es más rápido y seguro. En Plesk, cambia la versión en "PHP Settings".
Evita módulos no oficiales: Muchos errores vienen de módulos descargados de fuentes no confiables.
Si usas un panel diferente como Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106, y la estructura de archivos es similar, pero la gestión de bases de datos puede variar ligeramente.

[TIP] Si después de seguir todos estos pasos el error persiste, no dudes en contactar con el soporte técnico de tu hosting. A veces el problema está en la configuración del servidor y no en tu tienda.

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que la mayoría de los errores PrestaShop en Plesk tienen solución y no requieren conocimientos avanzados. ¡Ánimo con tu tienda online!