Cómo solucionar error 500 en PrestaShop con Syspanel

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los problemas más comunes y, a veces, más desconcertantes: el temido error 500 en PrestaShop. No te preocupes, es un error interno del servidor, pero con las herramientas adecuadas y un poco de paciencia, lo solucionaremos paso a paso. Vamos a usar Syspanel (nuestro panel de control basado en HestiaCP, que accedes por el puerto 2106) para encontrar la causa raíz.

¿Qué es un error 500 en PrestaShop?

El error 500, también conocido como "Error interno del servidor", es la forma que tiene tu tienda de decir: "Algo salió mal, pero no sé exactamente qué". No es un error de tu conexión a internet ni de tu navegador, sino un problema en el servidor donde está alojado PrestaShop. Puede deberse a muchas razones: un archivo corrupto, un módulo conflictivo, problemas de permisos, un archivo .htaccess mal configurado, o incluso un límite de memoria excedido.

Paso 1: Lo primero, no entrar en pánico

Cuando ves la pantalla en blanco o el mensaje "Error 500 Internal Server Error", lo peor que puedes hacer es empezar a cambiar cosas al azar. Respira hondo. PrestaShop es muy bueno dando pistas, pero necesitamos saber dónde buscar. Y para eso, Syspanel es tu mejor aliado.

Paso 2: Accede a Syspanel y activa los logs de PrestaShop

El primer lugar donde debemos mirar es el log de errores de PrestaShop. Syspanel te permite ver estos logs de forma sencilla.

1. Abre tu navegador y escribe: https://tu-dominio.com:2106 (recuerda, el puerto es el 2106).
2. Inicia sesión con tu usuario y contraseña de Syspanel.
3. Una vez dentro, busca la sección de "Logs" o "Registros". Normalmente está en el menú lateral.
4. Dentro de Logs, busca específicamente "Error Log" o "Registro de errores". Aquí es donde PrestaShop escribe todos los fallos.
5. Habilita el modo debug (depuración) de PrestaShop temporalmente. Esto es clave. En Syspanel, suele haber un botón o una opción en la sección de "Ajustes de la web" o "Opciones avanzadas" que dice "Activar modo debug" o "Mostrar errores PHP". Actívalo.

[TIP] Si no encuentras la opción en Syspanel, puedes hacerlo manualmente editando el archivo /config/defines.inc.php de PrestaShop. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Pero ojo: esto mostrará errores en tu tienda, así que hazlo solo para diagnosticar y luego vuelve a ponerlo en false.

Paso 3: Interpreta el log de errores

Una vez activado el modo debug o revisando el log de errores, verás algo como esto (ejemplo):

[26-Oct-2023 10:30:15 UTC] PHP Fatal error: Uncaught Error: Call to undefined function...

O algo más descriptivo:

[26-Oct-2023 10:30:15 UTC] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes)

¡Genial! Ahora ya sabemos qué está pasando. Los errores más comunes que verás son:

3.1. Error de memoria PHP (memory limit)

Síntoma: El log dice algo como "Allowed memory size exhausted".

Solución: Necesitas aumentar el límite de memoria PHP. En Syspanel, busca la sección "PHP Settings" o "Ajustes PHP". Ahí encontrarás un campo llamado memory_limit. Cámbialo a un valor más alto, por ejemplo, de 128M a 256M o incluso 512M. Guarda los cambios y recarga tu tienda.

[WARNING] Si no encuentras esta opción en Syspanel, puedes crearla manualmente en el archivo php.ini o en un archivo .user.ini en la raíz de tu PrestaShop. Añade la línea: memory_limit = 256M. Pero es más seguro hacerlo desde el panel.

3.2. Error de archivo .htaccess corrupto o conflictivo

Síntoma: El log no muestra un error claro, o ves algo como "Internal Server Error" sin más detalles.

Solución: El archivo .htaccess de PrestaShop a veces se corrompe, especialmente después de actualizar módulos o la versión de PrestaShop.

1. Ve a Syspanel, luego a la sección de "Archivos" o "File Manager".
2. Navega a la carpeta raíz de tu PrestaShop (normalmente public_html o www).
3. Busca el archivo .htaccess (puede estar oculto, activa "Mostrar archivos ocultos" en el gestor de archivos).
4. Renómbralo a .htaccess_old (esto lo desactiva temporalmente).
5. Ahora, ve al Back Office de PrestaShop (si puedes acceder). Si no, intenta acceder a tu tienda. Si el error 500 desaparece, el problema era el .htaccess.
6. En el Back Office, ve a Configuración -> Rendimiento y haz clic en "Guardar" (sin cambiar nada). Esto regenerará un nuevo .htaccess limpio.

[INFO] Si no puedes acceder al Back Office, puedes regenerar el .htaccess manualmente desde Syspanel usando un script, o simplemente dejar el archivo renombrado. PrestaShop a veces funciona sin él, aunque no es recomendable a largo plazo.

3.3. Error de módulo o tema conflictivo

Síntoma: El log menciona un archivo específico de un módulo o tema.

Solución: El módulo o tema puede estar desactualizado, tener un error de código o ser incompatible con tu versión de PrestaShop.

1. Identifica el módulo por el nombre en el log (ej: /modules/mimodulo/mimodulo.php).
2. Desactívalo temporalmente. La forma más segura es renombrar la carpeta del módulo desde Syspanel.
   • Ve a File Manager -> public_html/modules/.
   • Busca la carpeta del módulo problemático (ej: mimodulo).
   • Renómbrala a mimodulo_old (esto lo desactiva por completo).
3. Prueba tu tienda. Si el error 500 desaparece, el módulo era el culpable. Puedes reinstalarlo desde el Back Office o contactar al desarrollador.

3.4. Error de permisos de archivos

Síntoma: El log dice "Permission denied" o no puedes escribir en caché.

Solución: PrestaShop necesita permisos específicos para escribir en ciertas carpetas (como cache, log, upload, img).

1. En Syspanel, busca una opción de "Reparar permisos" o "Fix permissions". Muchos paneles la tienen.
2. Si no, puedes cambiarlos manualmente desde el File Manager o usando el Terminal de Syspanel (si tienes acceso SSH). Los permisos estándar son:
   • Carpetas: 755
   • Archivos: 644
3. Recomendación: La mayoría de las veces, el problema se soluciona dando permisos 755 a la carpeta cache y log, y 777 a la carpeta config (solo temporalmente, luego vuelve a 755).

Paso 4: Soluciones rápidas y genéricas (si el log no te da pistas)

A veces, el log de errores está vacío o no es claro. Aquí tienes una lista de acciones por orden de probabilidad:

1. Limpia la caché de PrestaShop desde Syspanel. Busca un botón que diga "Clear cache" o "Limpiar caché". Si no, puedes hacerlo manualmente borrando el contenido de las carpetas /cache/smarty/cache y /cache/smarty/compile (sin borrar las carpetas en sí).
2. Revisa el archivo config/settings.inc.php. Asegúrate de que los datos de la base de datos (nombre, usuario, contraseña) sean correctos. Un error en la conexión a la base de datos también da error 500.
3. Aumenta el tiempo de ejecución de PHP. En los ajustes PHP de Syspanel, busca max_execution_time y ponlo a 300 (5 minutos). A veces una tarea se queda colgada.
4. Revisa la versión de PHP. En Syspanel, en la sección de "Ajustes de la web" o "PHP Settings", asegúrate de que la versión de PHP sea compatible con tu PrestaShop. PrestaShop 1.7 necesita PHP 7.1 o superior (recomendado 7.4 u 8.0). Si tienes una versión muy antigua o muy nueva, puede dar error.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

¿Por qué veo un error 500 en mi tienda y no en el Back Office?

Esto es común. A veces el error solo afecta a la parte pública (Front Office) porque un módulo del tema está fallando. El Back Office suele tener más tolerancia. Sigue los pasos de logs y desactivación de módulos para encontrarlo.

¿Puedo perder datos si renombro un módulo?

No. Renombrar la carpeta del módulo solo lo desactiva. Tus datos (pedidos, clientes, productos) están en la base de datos y no se tocan. Una vez que soluciones el conflicto, puedes renombrar la carpeta a su nombre original y el módulo volverá a funcionar (aunque quizás necesites reinstalarlo desde el Back Office).

¿Qué hago si después de todo sigue el error 500?

Si has seguido todos los pasos (logs, permisos, caché, módulos, .htaccess) y el error persiste, el problema puede ser más profundo:

• Corrupción de archivos del núcleo de PrestaShop: Puedes subir una copia limpia de los archivos de tu versión de PrestaShop (sin tocar la carpeta config, img ni modules).
• Problema con el servidor web: Contacta con el soporte de tu hosting. Puede ser un error de configuración de Apache o Nginx que solo ellos pueden ver.
• Base de datos corrupta: Desde Syspanel, puedes ir a la sección de "Bases de datos" y usar la herramienta de reparación (phpMyAdmin) para revisar las tablas.

¿Es seguro activar el modo debug en una tienda en producción?

No. Muestra errores de PHP a los visitantes, lo cual es feo y puede revelar información sensible. Actívalo solo para diagnosticar y desactívalo inmediatamente después. Si no puedes acceder al Back Office para desactivarlo, edita el archivo /config/defines.inc.php y vuelve a poner false.

Resumen final: Tu checklist para solucionar el error 500

1. No te asustes.
2. Accede a Syspanel (puerto 2106).
3. Activa el modo debug o revisa los logs de errores.
4. Interpreta el mensaje de error (memoria, módulo, .htaccess, permisos).
5. Aplica la solución específica (aumentar memoria, renombrar módulo, regenerar .htaccess, reparar permisos).
6. Limpia la caché de PrestaShop.
7. Desactiva el modo debug.
8. Prueba tu tienda.

[TIP FINAL] Si no te sientes cómodo editando archivos, Syspanel tiene herramientas visuales para casi todo. Usa el File Manager para renombrar archivos y la sección de Ajustes PHP para cambiar parámetros. Y si te quedas atascado, el log de errores es tu mapa del tesoro.

¡Espero que este artículo te haya ayudado a solucionar el error 500 en tu PrestaShop! Recuerda, la paciencia y un buen panel de control como Syspanel son tus mejores herramientas. Si tienes más dudas, aquí estoy para ayudarte. ¡Buena suerte con tu tienda!