Error 500 en PrestaShop con Plesk: soluciones rápidas | FAQ técnica

¡Hola! Soy el técnico de soporte de tu hosting. Si estás leyendo esto, probablemente te has encontrado con la temida pantalla blanca o el mensaje "Error 500 – Internal Server Error" en tu tienda PrestaShop. No te preocupes, es un problema muy común y, en la mayoría de los casos, tiene una solución sencilla. En este artículo, vamos a desglosar las causas más frecuentes del error 500 PrestaShop Plesk y te guiaré paso a paso para que puedas solucionar error 500 PrestaShop sin necesidad de ser un experto en programación.

Vamos a centrarnos en entornos con Plesk, uno de los paneles de control más utilizados. Si en algún momento mencionamos otro panel (como Syspanel, que es el nombre comercial de HestiaCP y se accede por el puerto 2106), te lo indicaré claramente. ¡Empecemos!

¿Qué es un Error 500 y por qué aparece en PrestaShop?

Un error 500 es un código de estado HTTP que significa "Error interno del servidor". Básicamente, el servidor web (Apache o Nginx) está diciendo: "Algo salió mal, pero no puedo darte más detalles sin que revises los logs". En PrestaShop, esto suele deberse a un problema con un módulo, un tema, un archivo de configuración o un límite de recursos del servidor.

Lo bueno es que, salvo raras excepciones, no has perdido tus datos. Los productos, clientes y pedidos siguen en la base de datos. Solo necesitas restaurar el acceso a la parte pública y al panel de administración.

Causas comunes del Error 500 en PrestaShop con Plesk

Antes de lanzarte a hacer cambios, es importante identificar qué puede estar provocando el error. Estas son las causas más habituales:

1. Módulo o tema incompatible o corrupto

Es la causa número uno. Instalaste un módulo nuevo, actualizaste uno existente o cambiaste el tema, y de repente todo se rompe. A veces, un módulo mal codificado o que no es compatible con tu versión de PrestaShop puede generar un error fatal de PHP que se traduce en un 500.

2. Límites de memoria PHP agotados (memory_limit)

PrestaShop es un CMS que consume bastantes recursos, especialmente si tienes muchos módulos, imágenes grandes o un catálogo extenso. Si el límite de memoria PHP es demasiado bajo (por ejemplo, 32M o 64M), el servidor no podrá ejecutar los scripts y devolverá un error 500.

3. Archivos .htaccess corruptos o incorrectos

Plesk suele gestionar el archivo .htaccess de forma automática, pero a veces una reescritura incorrecta (por ejemplo, al activar o desactivar la URL amigable) puede dejarlo inservible. Un .htaccess dañado provoca un error 500 inmediato.

4. Permisos de archivos y carpetas incorrectos

PrestaShop necesita permisos específicos para leer y escribir archivos (por ejemplo, la carpeta cache, log o config). Si después de una migración o una restauración los permisos se han cambiado, el sistema no podrá funcionar.

5. Problemas con la versión de PHP

PrestaShop tiene requisitos de versión de PHP. Por ejemplo, PrestaShop 1.6 no funciona bien con PHP 8.0 o superior. Si en Plesk cambiaste la versión de PHP (o el hosting lo hizo automáticamente), podrías estar usando una versión incompatible.

6. Conflictos con el modo de opcode cache (OPcache)

El OPcache acelera PHP, pero a veces guarda en caché versiones antiguas de archivos. Si actualizaste un módulo o el núcleo de PrestaShop, el OPcache puede seguir sirviendo el código viejo y generar un error.

7. Base de datos corrupta o con tablas dañadas

Aunque es menos frecuente, un corte de luz, un error en una actualización o un plugin de backup mal hecho pueden dañar alguna tabla de la base de datos, lo que provoca un error 500 al intentar acceder a ciertas páginas.

Paso a paso para solucionar el error 500 PrestaShop Plesk

Voy a guiarte por un proceso ordenado, desde lo más simple a lo más complejo. No saltes pasos, y sobre todo, haz siempre una copia de seguridad antes de modificar archivos.

### Paso 1: Activar el modo debug de PrestaShop (la clave del éxito)

Por defecto, PrestaShop oculta los errores PHP. Para ver el mensaje real, debes activar el modo debug. Esto es lo primero que debes hacer.

Accede a tu panel de Plesk.
Ve a Archivos o Administrador de archivos.
Navega hasta la raíz de tu tienda (normalmente httpdocs o public_html).
Busca el archivo config/defines.inc.php.
Ábrelo con el editor de texto de Plesk (no uses bloc de notas local, mejor el de Plesk).
Busca la línea que dice:
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
Guarda el archivo.

Ahora, al recargar tu tienda, en lugar de un error 500 genérico, verás un mensaje de error PHP detallado (por ejemplo, "Fatal error: Allowed memory size of 134217728 bytes exhausted..."). Este mensaje es tu mejor amigo. Anótalo o haz una captura de pantalla.

[TIP]: Si el error es tan grave que ni siquiera puedes acceder al administrador de archivos de Plesk, puedes usar FTP (FileZilla) para editar el archivo.

### Paso 2: Aumentar el límite de memoria PHP

Si el error que ves menciona memory exhausted o Allowed memory size, el problema es claro: necesitas más memoria.

En Plesk, ve a Configuración de PHP (suele estar en la sección de tu dominio).
Busca la opción memory_limit.
Cámbiala a un valor mayor. Recomendamos:
- PrestaShop 1.6: 256M
- PrestaShop 1.7 y 8.x: 512M o incluso 1024M si tienes muchos módulos.
Guarda los cambios y recarga la tienda.

[INFO]: Si no encuentras la opción, pídele a tu soporte técnico que lo haga. En Syspanel (acceso por puerto 2106), la opción está en Ajustes de PHP dentro del plan de hosting.

### Paso 3: Deshabilitar módulos problemáticos (sin acceso al BO)

Si el error no es de memoria, probablemente sea un módulo. Para deshabilitarlos sin entrar al Back Office (BO):

Conéctate por FTP o al administrador de archivos de Plesk.
Ve a la carpeta modules de tu PrestaShop.
Busca la carpeta del módulo que sospechas (el último que instalaste o actualizaste).
Renombra la carpeta, por ejemplo, añadiendo _old al final. Ejemplo: superplugin → superplugin_old.
Recarga la tienda. Si el error desaparece, ya sabes quién es el culpable.

También puedes deshabilitar módulos de forma masiva desde la base de datos (con phpMyAdmin), pero es más avanzado. Si no te sientes cómodo, mejor prueba renombrando carpetas una por una.

### Paso 4: Regenerar o eliminar el archivo .htaccess

Un .htaccess corrupto es fácil de solucionar.

En el administrador de archivos, busca el archivo .htaccess en la raíz de tu tienda.
Renómbralo a .htaccess_old (no lo borres, por si acaso).
Recarga tu tienda. Si ahora ves la tienda (aunque sin URL amigables), el problema era ese.
Para regenerarlo correctamente, entra al Back Office (si puedes) y ve a Configuración → Tráfico y SEO → URL amigables. Desactívalas y actívalas de nuevo. Si no puedes entrar al BO, no pasa nada, la tienda funcionará sin URL amigables temporalmente.

[WARNING]: No subas un .htaccess de otra tienda o de internet sin adaptarlo. Cada servidor es diferente.

### Paso 5: Verificar y corregir permisos de archivos

Los permisos incorrectos pueden provocar un error 500. Los valores correctos para PrestaShop son:

Carpetas: 755
Archivos: 644
Archivos de configuración (como config/settings.inc.php): 444 o 644 (nunca 777)

En Plesk, puedes seleccionar varios archivos y usar la opción Cambiar permisos. Si tienes muchos archivos, puedes usar el comando chmod por SSH, pero si no, hazlo desde el administrador de archivos de Plesk, que es más visual.

### Paso 6: Limpiar la caché de PrestaShop y del servidor

La caché puede estar sirviendo datos antiguos.

Caché de PrestaShop: Elimina manualmente el contenido de las carpetas:
- /var/cache/ (en PrestaShop 1.7+)
- /cache/ (en PrestaShop 1.6)
- /cache/smarty/ (todas las subcarpetas)
Caché de PHP (OPcache): En Plesk, ve a Configuración de PHP y busca la opción Clear OPcache o Reiniciar PHP. Si no la ves, contacta al soporte.
Caché del navegador: Borra la caché de tu navegador o usa una ventana de incógnito.

### Paso 7: Cambiar la versión de PHP

Si nada funciona, prueba con otra versión de PHP.

En Plesk, ve a Configuración de PHP de tu dominio.
Cambia la versión a una compatible con tu PrestaShop:
- PrestaShop 1.6: PHP 5.6 o 7.0 (máximo 7.1)
- PrestaShop 1.7: PHP 7.1 a 7.4
- PrestaShop 8.x: PHP 7.4, 8.0, 8.1
Guarda y prueba.

[INFO]: Si tu hosting usa Syspanel (puerto 2106), el cambio de versión de PHP se hace desde Ajustes de PHP en el plan de hosting.

### Paso 8: Revisar los logs del servidor (para casos difíciles)

Si aún no lo resuelves, los logs del servidor te darán la pista definitiva.

En Plesk, ve a Registros (o Logs).
Busca el archivo error_log (Apache) o error.log (Nginx).
Descarga o visualiza las últimas líneas. Busca la fecha y hora exacta en que ocurrió el error. Verás mensajes como:
- PHP Fatal error: Uncaught Error: Call to undefined function... (módulo incompatible)
- PHP Warning: require_once(...): failed to open stream... (archivo faltante)
- mod_security: Access denied... (regla de seguridad bloqueando algo)

Con ese mensaje, puedes buscar soluciones específicas en Google o preguntar a tu soporte técnico.

Preguntas Frecuentes (FAQ)

¿El error 500 borra mis productos o clientes?

No. El error 500 solo impide que el servidor muestre la página. Tu base de datos con todos los datos de la tienda sigue intacta. Una vez solucionado el error, todo vuelve a la normalidad.

¿Puedo solucionar el error 500 sin acceso al panel de administración de Plesk?

Si no tienes acceso a Plesk, necesitarás al menos acceso FTP. Desde FTP puedes editar el archivo defines.inc.php para activar el modo debug y renombrar carpetas de módulos. Si no tienes ni FTP, contacta a tu proveedor de hosting.

¿Qué hago si el error aparece solo en el Back Office?

Aplica el mismo proceso. Activa el modo debug desde FTP, mira el error y actúa en consecuencia. Suele ser un módulo del Back Office o un problema de memoria.

¿Puede ser un problema de la base de datos?

Sí, aunque es menos común. Puedes reparar las tablas desde phpMyAdmin (en Plesk, busca Bases de datos). Selecciona todas las tablas de tu PrestaShop y elige la opción Reparar tablas.

¿Debo contratar a un programador?

Si después de seguir todos estos pasos el error persiste, puede que sea un problema más complejo (como un conflicto de módulos muy específico o un error en el núcleo de PrestaShop). En ese caso, un desarrollador especializado en PrestaShop puede ahorrarte horas de frustración.

Resumen y consejos finales

El error 500 PrestaShop Plesk suele tener solución en pocos minutos si sigues un orden lógico:

Activa el modo debug para ver el error real.
Aumenta la memoria PHP (es la solución más común).
Deshabilita módulos renombrando sus carpetas.
Limpia el .htaccess y la caché.
Revisa los permisos y la versión de PHP.
Mira los logs si todo lo anterior falla.

Recuerda siempre tener una copia de seguridad reciente. Y si usas Syspanel (HestiaCP, puerto 2106), los pasos son similares, solo cambia la ubicación de algunas opciones.

Espero que este artículo te haya sido de gran ayuda. Si tienes alguna duda, no dudes en contactar con tu soporte técnico. ¡Tu tienda online volverá a funcionar en poco tiempo!