Error 500 en PrestaShop en Syspanel: Guía de solución

¿Qué es el error 500 en PrestaShop y por qué aparece en Syspanel?

El error 500 en PrestaShop es uno de los avisos más temidos por cualquier persona que tenga una tienda online. Cuando aparece, la página se queda en blanco o muestra el mensaje "Internal Server Error", y parece que todo se ha roto sin razón aparente.

Pero tranquilo, porque en la mayoría de los casos tiene una solución clara y no implica que hayas perdido tus datos ni tu catálogo de productos. En este artículo vamos a explicarte paso a paso cómo solucionar el error 500 en Syspanel, centrándonos en las dos causas más comunes: los permisos de archivos y el archivo .htaccess.

Syspanel es el panel de control que usamos para gestionar tu hosting. Si estás leyendo esto, probablemente ya lo conoces, pero recuerda que el acceso a Syspanel se realiza a través del puerto 2106. Es importante que lo tengas en cuenta, porque muchas guías genéricas hablan de otros paneles y no de este.

¿Qué causa exactamente el error 500 en PrestaShop?

Antes de lanzarnos a solucionar nada, es fundamental entender qué está pasando. El error 500 es un mensaje genérico que indica que algo falló en el servidor, pero no te dice exactamente qué. Las causas más frecuentes en PrestaShop son:

1. Permisos incorrectos en archivos y carpetas

PrestaShop necesita permisos específicos para leer, escribir y ejecutar archivos. Si algún permiso está mal configurado (por ejemplo, después de una migración, una actualización o al subir archivos por FTP), el servidor no puede ejecutar el código correctamente y devuelve el error 500.

2. Archivo .htaccess corrupto o con directivas incompatibles

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor Apache. Si está dañado, incompleto o contiene reglas incompatibles con tu versión de PrestaShop, el servidor falla.

3. Falta de memoria PHP

A veces el error no tiene que ver con permisos ni con .htaccess, sino con que el límite de memoria asignado a PHP es demasiado bajo para que PrestaShop funcione. Aunque esto no es tan común como los dos puntos anteriores, también lo abordaremos.

4. Archivos corruptos o incompletos

Si durante una actualización o subida de archivos algo se interrumpió, es posible que tengas archivos incompletos o dañados.

Cómo solucionar el error 500 en PrestaShop paso a paso

Vamos a ir de lo más simple a lo más complejo. No saltes directamente a los pasos avanzados sin probar antes los básicos, porque muchas veces la solución es más sencilla de lo que parece.

Paso 1: Accede a Syspanel y revisa los logs de error

Lo primero que debes hacer es entrar en Syspanel. Recuerda que la URL de acceso incluye el puerto 2106. Una vez dentro, busca la sección de Registros o Logs.

Los logs son como el "diario de a bordo" del servidor. Ahí verás el error exacto que está generando PrestaShop. Busca líneas que contengan "PHP Fatal error" o "mod_security". Esto te dará pistas muy valiosas.

[TIP] Si no sabes dónde están los logs, busca la opción "Logs de error" o "Error logs" en el panel. En Syspanel suele estar en el apartado de "Herramientas" o "Avanzado".

Paso 2: Soluciona el error 500 en PrestaShop reparando los permisos

Esta es la causa más habitual. Cuando los permisos están mal, el servidor no puede leer los archivos de configuración ni escribir en las carpetas de caché.

¿Qué permisos necesita PrestaShop?

Las carpetas deben tener permiso 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para el resto).
Los archivos deben tener permiso 644 (lectura y escritura para el propietario; solo lectura para el resto).
La carpeta config y la carpeta cache a veces necesitan permisos 777 temporalmente, pero no es recomendable dejarlas así de forma permanente.

Cómo cambiar permisos desde Syspanel

Entra en Syspanel y ve al Administrador de archivos (File Manager).
Navega hasta la raíz de tu instalación de PrestaShop.
Selecciona todos los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic derecho y elige Cambiar permisos (o "Permissions").
Introduce 755 para directorios y 644 para archivos. Muchos administradores de archivos te permiten aplicar esto en un solo paso.
Aplica los cambios y espera a que termine.

[WARNING] No dejes la carpeta config con permisos 777 más tiempo del necesario. Es un riesgo de seguridad grave. Si tienes que usar 777 para solucionar algo, revierte a 755 en cuanto termines.

Si usas FTP como alternativa

Si prefieres usar un cliente FTP como FileZilla, el proceso es similar:

Conecta a tu servidor.
Selecciona la carpeta raíz de PrestaShop.
Botón derecho > Permisos de archivos.
Marca 755 para carpetas y 644 para archivos.
Marca la casilla "Recursivo" para que se aplique a todas las subcarpetas y archivos.

Paso 3: Regenera el archivo .htaccess de PrestaShop

El .htaccess es un archivo invisible que se encuentra en la raíz de tu tienda. Si está corrupto o tiene reglas obsoletas, es mejor regenerarlo desde cero.

Opción A: Regenerar desde el panel de administración de PrestaShop

Accede a tu panel de administración de PrestaShop (normalmente en /admin o la URL que configuraste).
Ve a Parámetros avanzados > Rendimiento.
Busca la opción "Regenerar el archivo .htaccess".
Haz clic en el botón y guarda.

Este método es el más limpio porque PrestaShop genera un .htaccess perfectamente adaptado a su configuración actual.

Opción B: Crear un .htaccess manual

Si no puedes acceder al panel de administración, tendrás que hacerlo manualmente:

Entra en el Administrador de archivos de Syspanel.
Ve a la raíz de tu PrestaShop.
Busca el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Descarga una copia de seguridad a tu ordenador (por si acaso).
Elimina el archivo .htaccess del servidor.
Ahora, crea un archivo nuevo llamado .htaccess (asegúrate de que no tenga extensión alternativa). Puedes copiar este contenido básico:

# START PrestaShop
<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteCond %{HTTP_HOST} ^tudominio.com$ [NC]
    RewriteRule ^(.*)$ https://www.tudominio.com/$1 [R=301,L]
</IfModule>
# END PrestaShop

Pero ojo, esto es solo un ejemplo muy básico. Lo ideal es que uses la opción A si puedes.

[INFO] El .htaccess de PrestaShop contiene muchas más directivas (compresión, caché, redirecciones de URL amigables, etc.). Si lo creas manualmente con solo esas líneas, perderás la configuración de URL amigable. Es un parche temporal para que la tienda cargue, pero luego deberás regenerarlo desde el panel.

Paso 4: Aumenta el límite de memoria PHP

Si después de arreglar permisos y .htaccess el error persiste, puede que sea un problema de memoria. PrestaShop es una aplicación exigente, especialmente si tienes muchos módulos o productos.

Cómo aumentarlo en Syspanel

Ve a la sección "PHP" o "Configuración PHP" en Syspanel.
Busca la directiva memory_limit.
Cámbiala a 256M o incluso 512M si tu hosting lo permite.
Guarda los cambios y reinicia PHP si es necesario.

Alternativa: editar el archivo `php.ini`

Si no encuentras la opción en Syspanel, puedes crear o editar un archivo php.ini en la raíz de tu PrestaShop con este contenido:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

Paso 5: Desactiva temporalmente la caché de PrestaShop

A veces la caché guardada se corrompe y provoca el error 500. Puedes desactivarla manualmente:

En el Administrador de archivos, ve a la carpeta var/cache (o cache en versiones antiguas).
Elimina todo el contenido de esa carpeta, pero no la carpeta en sí.
Intenta cargar tu tienda de nuevo.

Si funciona, es que la caché estaba dañada. Luego puedes volver a activarla desde el panel de administración.

Paso 6: Revisa si el problema es de mod_security

Algunos servidores tienen un módulo de seguridad llamado mod_security que bloquea ciertas peticiones y puede generar un error 500 en PrestaShop. Puedes probar a desactivarlo temporalmente desde Syspanel o añadiendo esto al .htaccess:

<IfModule mod_security.c>
    SecFilterEngine Off
    SecFilterScanPOST Off
</IfModule>

[WARNING] Esto reduce la seguridad de tu servidor. Úsalo solo como prueba para diagnosticar. Si el problema desaparece, es que mod_security estaba bloqueando algo y deberías hablar con tu proveedor para ajustarlo mejor.

Paso 7: Verifica que los archivos no estén corruptos

Si todo lo anterior falla, puede que tengas archivos dañados. La forma más segura de solucionarlo es:

Descarga una copia limpia de PrestaShop desde prestashop.com (la misma versión que tienes instalada).
Descomprime el archivo en tu ordenador.
Sube solo los archivos que falten o estén corruptos, pero no la carpeta config ni app/config/parameters.php (ahí están tus datos de conexión a la base de datos).
Reemplaza los archivos dañados por los nuevos.

Este proceso es más delicado, así que si no te sientes seguro, lo mejor es contactar con soporte técnico.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 puede deberse a un tema o módulo?

Sí. Un tema mal codificado o un módulo incompatible pueden provocar errores fatales. Si el problema empezó tras instalar algo nuevo, desactívalo desde el panel de administración o mediante FTP (renombra la carpeta del módulo en /modules).

¿Pierdo mis datos si borro el `.htaccess`?

No. El .htaccess no contiene datos de tu tienda, solo reglas de configuración. Pero sí puede afectar a las URLs amigables y a la redirección de páginas.

¿Cuánto tiempo se tarda en solucionar este error?

Si es un problema de permisos, en 10 minutos lo tienes resuelto. Si es más complejo, puede llevarte un par de horas. Pero no desesperes, casi siempre tiene solución.

¿Debo contactar con soporte si no puedo acceder ni al panel de administración?

Sí, si no puedes acceder ni al panel de administración de PrestaShop, ni a Syspanel, ni al FTP, entonces necesitas ayuda profesional. El soporte de tu hosting puede revisar los logs del servidor y darte una respuesta más precisa.

Resumen final: checklist para solucionar el error 500 en PrestaShop

Aquí tienes un resumen rápido de todo lo que hemos visto:

Accede a Syspanel (puerto 2106) y revisa los logs.
Corrige los permisos de archivos y carpetas (755 en carpetas, 644 en archivos).
Regenera el .htaccess desde el panel de PrestaShop o créalo manualmente.
Aumenta el límite de memoria PHP a 256M o más.
Limpia la carpeta de caché.
Prueba desactivando mod_security.
Verifica que no haya archivos corruptos.

[INFO] El error 500 en PrestaShop es un problema común, pero con estos pasos podrás resolverlo en la mayoría de los casos. No tengas miedo de experimentar, pero siempre haz copias de seguridad antes de tocar nada importante.

Conclusión

Hemos visto cómo solucionar el error 500 en Syspanel centrándonos en los dos grandes culpables: los permisos y el archivo .htaccess. Recuerda que Syspanel se accede por el puerto 2106 y que la clave está en ir paso a paso, sin saltarte ninguno.

Si después de seguir toda esta guía el problema persiste, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso a herramientas más avanzadas y podrán diagnosticar el problema con mayor precisión.

Esperamos que este artículo te haya sido de gran ayuda. Ahora ya sabes cómo enfrentarte a ese temido error 500 PrestaShop con confianza y sin entrar en pánico. ¡Tu tienda volverá a estar operativa en poco tiempo!