Error 500 en PrestaShop: soluciones en Syspanel

Si eres usuario de PrestaShop y te has encontrado con la temida pantalla blanca o el mensaje "Error 500" (Internal Server Error), no te preocupes. Es uno de los errores más comunes en tiendas online, pero también uno de los más fáciles de solucionar si sabes por dónde empezar. En esta guía completa, te explicamos paso a paso cómo solucionar el error 500 en PrestaShop utilizando el panel de control Syspanel (anteriormente conocido como HestiaCP). Recuerda que para acceder a tu panel de control Syspanel, la dirección es tudominio.com:2106 (puerto 2106).

¿Qué es el error 500 en PrestaShop?

El error 500 es un código de estado HTTP que indica que algo salió mal en el servidor, pero sin dar detalles específicos. En PrestaShop, suele aparecer como una página en blanco o con el texto "Error 500: Internal Server Error". Las causas más frecuentes son:

Archivos .htaccess corruptos (especialmente después de migraciones o cambios de URL).
Problemas de permisos de archivos y carpetas.
Módulos o temas incompatibles que generan conflictos.
Límite de memoria PHP excedido.
Errores en la configuración de la base de datos.
Archivos de caché de PrestaShop corruptos.
Versión de PHP incompatible con tu versión de PrestaShop.

Primeros pasos: Accede a Syspanel y activa los logs de error

Antes de hacer cambios, necesitas ver el error real. Para ello, activa los logs de PHP desde Syspanel.

Paso 1: Inicia sesión en Syspanel

Accede a tudominio.com:2106 con tus credenciales de administrador. Una vez dentro, busca la sección "Web" o "Dominios" y selecciona el dominio de tu tienda PrestaShop.

Paso 2: Activa la visualización de errores

Dentro de la configuración del dominio, busca la opción "PHP" o "Configuración de PHP". Allí encontrarás una casilla o selector para "Mostrar errores" o "Display errors". Actívala temporalmente. También puedes subir el "Nivel de reporte de errores" a "E_ALL".

[WARNING] Recuerda desactivar esta opción una vez resuelto el error, ya que mostrar errores en producción es un riesgo de seguridad.

Guarda los cambios y recarga tu tienda. Ahora, en lugar de la pantalla blanca, verás un mensaje de error específico (por ejemplo, "Class not found" o "Allowed memory size exhausted"). Anota ese mensaje, te guiará a la solución.

Soluciones paso a paso según el error

1. Error de archivo .htaccess corrupto

Uno de los causantes más comunes del error 500 en PrestaShop es un archivo .htaccess dañado, especialmente después de cambiar la URL de la tienda o migrar de servidor.

Cómo solucionarlo desde Syspanel:

En Syspanel, ve a "Archivos" o "File Manager" (normalmente en la sección del dominio).
Navega a la carpeta raíz de tu PrestaShop (donde está el archivo index.php).
Busca el archivo .htaccess. Si no lo ves, asegúrate de tener activada la opción "Mostrar archivos ocultos".
Renómbralo a .htaccess_old (esto lo desactiva temporalmente).
Ahora, ve al panel de administración de PrestaShop (si aún puedes acceder) o genera uno nuevo desde "Parámetros de la tienda > Tráfico y SEO > URL" y haz clic en "Guardar" (esto regenera el .htaccess).
Si no puedes acceder al admin, crea un archivo .htaccess nuevo con el siguiente contenido básico (ajusta la ruta si es necesario):

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

[TIP] Siempre haz una copia de seguridad del .htaccess original antes de modificarlo.

2. Permisos incorrectos en archivos y carpetas

Los permisos de archivos en PrestaShop deben ser específicos. Si son demasiado restrictivos o permisivos, pueden causar un error 500.

Cómo corregirlos desde Syspanel:

En Syspanel, ve a "File Manager" y selecciona la carpeta raíz de tu tienda.
Haz clic derecho sobre la carpeta y elige "Cambiar permisos".
Aplica los siguientes permisos recomendados para PrestaShop:
- Carpetas: 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)

[INFO] No uses permisos 777 a menos que sea estrictamente necesario y solo temporalmente. Es un riesgo de seguridad.

Puedes aplicar estos permisos recursivamente (a todas las subcarpetas y archivos). En Syspanel, busca la opción "Aplicar a subdirectorios" o similar.

3. Límite de memoria PHP insuficiente

Si el error menciona "Allowed memory size exhausted", tu tienda necesita más memoria PHP.

Cómo aumentarlo desde Syspanel:

En la configuración de PHP del dominio (misma sección donde activaste los logs), busca la opción "memory_limit".
Cambia el valor a 256M o 512M (dependiendo de los recursos de tu plan de hosting).
Guarda los cambios y reinicia el servicio PHP si es necesario (Syspanel suele hacerlo automáticamente).

[WARNING] No superes el límite que permite tu plan de hosting. Si necesitas más, contacta con tu proveedor.

4. Módulo o tema incompatible

A veces, un módulo o tema recién instalado genera conflictos. Para identificarlo:

Desactiva todos los módulos no esenciales desde el panel de administración de PrestaShop (si puedes acceder).
Si no puedes acceder al admin, desactívalos manualmente desde Syspanel:
- Ve a "Base de datos" en Syspanel y selecciona la base de datos de tu PrestaShop.
- Busca la tabla ps_module (el prefijo puede variar).
- Cambia el valor del campo active a 0 para los módulos sospechosos (especialmente los que instalaste recientemente).
Cambia temporalmente a un tema por defecto (como Classic) desde la tabla ps_configuration (campo PS_THEME_NAME).

5. Caché de PrestaShop corrupta

La caché de PrestaShop puede corromperse y causar errores.

Cómo limpiarla desde Syspanel:

En "File Manager", ve a la carpeta var/cache dentro de la raíz de PrestaShop.
Elimina todo el contenido de las subcarpetas dev y prod (no borres las carpetas, solo los archivos internos).
Si usas caché de Smarty, también puedes limpiarla desde el admin (si accedes) en "Parámetros avanzados > Rendimiento" y haciendo clic en "Limpiar caché".

6. Versión de PHP incorrecta

PrestaShop requiere una versión de PHP específica. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.4 o 8.0, mientras que versiones antiguas pueden necesitar PHP 5.6.

Cómo cambiarla desde Syspanel:

En la configuración de PHP del dominio, busca el selector "Versión de PHP".
Selecciona la versión recomendada para tu PrestaShop (consulta la documentación oficial).
Guarda los cambios.

[TIP] Si no estás seguro, prueba con PHP 7.4 (es la más estable para la mayoría de versiones de PrestaShop).

7. Base de datos corrupta o configuración incorrecta

Si el error menciona "Base de datos" o "conexión", verifica:

Accede a la base de datos desde Syspanel (sección "Base de datos").
Usa la herramienta "phpMyAdmin" (si está integrada) o la opción "Reparar tablas".
Busca la tabla ps_configuration y verifica que el campo PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL tengan la URL correcta de tu tienda (sin http:// ni https://, solo el dominio).

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 después de instalar un módulo?

Los módulos pueden tener conflictos con otros módulos o con el tema. Desactívalo temporalmente como se explicó en el paso 4.

¿El error 500 puede deberse a un ataque?

Sí, aunque es menos común. Si sospechas de un ataque, revisa los logs de acceso en Syspanel (sección "Logs") y busca peticiones sospechosas.

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

Usa Syspanel para hacer los cambios directamente: modifica archivos, permisos o base de datos. También puedes restaurar una copia de seguridad desde Syspanel (sección "Backup").

¿Cómo restauro una copia de seguridad desde Syspanel?

En Syspanel, ve a "Backup" y selecciona la copia más reciente. Puedes restaurar archivos, base de datos o ambos. Esto revierte cualquier cambio que haya causado el error.

¿El error 500 afecta al SEO?

Sí, porque Google no puede indexar tu tienda si devuelve un error 500. Soluciónalo lo antes posible para evitar penalizaciones en el ranking.

Resumen final: Checklist rápida para solucionar el error 500 en PrestaShop

✅ Activa logs de error en Syspanel (puerto 2106).
✅ Renombra el archivo .htaccess.
✅ Verifica permisos de archivos (755 carpetas, 644 archivos).
✅ Aumenta el límite de memoria PHP a 256M.
✅ Desactiva módulos recientes o cambia de tema.
✅ Limpia la caché de PrestaShop (carpeta var/cache).
✅ Ajusta la versión de PHP (recomendado PHP 7.4).
✅ Revisa la base de datos y las URLs en ps_configuration.

[INFO] Si después de seguir todos estos pasos el error persiste, contacta con tu proveedor de hosting. Puede ser un problema del servidor (como falta de recursos o configuración de Apache/Nginx) que solo ellos pueden resolver.

Recuerda que Syspanel es tu aliado para gestionar tu tienda. Con acceso al File Manager, base de datos y configuración de PHP, tienes todas las herramientas necesarias para solucionar el error 500 en PrestaShop sin necesidad de ser un experto en programación. ¡Buena suerte con tu tienda!