Cómo solucionar error 500 en PrestaShop | FAQ SysAdmin

Introducción: ¿Por qué aparece el error 500 en PrestaShop?

El temido error 500 PrestaShop es uno de los problemas más comunes que enfrentan los administradores de tiendas online. Este error, también conocido como "Internal Server Error", indica que algo salió mal en el servidor, pero no especifica exactamente qué. Para un usuario sin experiencia técnica, ver una pantalla blanca con "Error 500" puede ser desalentador, pero no te preocupes: en la mayoría de los casos, la solución es sencilla y no requiere ser un experto en SysAdmin PrestaShop. En esta guía rápida, te explicaremos paso a paso cómo solucionar error 500 en tu tienda PrestaShop, desde los métodos más básicos hasta los más avanzados.

[INFO] El error 500 puede deberse a un archivo .htaccess corrupto, un plugin incompatible, problemas de permisos de archivos, o incluso un mal funcionamiento del servidor. Vamos a revisar cada posible causa.

## Paso 1: Activar el modo de depuración de PrestaShop

Antes de hacer cambios en el servidor, lo más útil es obtener más información sobre el error. PrestaShop tiene un modo de depuración que muestra mensajes detallados.

### ¿Cómo activar el modo debug?

Accede a tu tienda mediante FTP o al panel de archivos de tu hosting.
Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Ábrelo con un editor de texto (como Notepad++ o el editor integrado de tu hosting).
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo y recarga tu tienda. Ahora deberías ver un mensaje de error más específico, como "Fatal error: Uncaught exception..." o "Parse error...".

[WARNING] No dejes el modo debug activado en producción, ya que expone información sensible. Una vez resuelto el error, vuelve a poner false.

Si no ves ningún cambio, el problema puede estar en el servidor y no en PrestaShop.

## Paso 2: Verificar el archivo .htaccess

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor Apache. Un error de sintaxis o una regla incorrecta puede provocar el error 500 PrestaShop.

### Pasos para revisar el .htaccess:

Conéctate a tu servidor vía FTP o al gestor de archivos.
Busca el archivo .htaccess en la raíz de tu tienda (normalmente en la misma carpeta donde está index.php).
Haz una copia de seguridad renombrándolo a .htaccess.bak.
Crea un nuevo archivo .htaccess vacío (solo con el contenido básico que genera PrestaShop). Si no sabes cómo, simplemente elimina el archivo y luego regenera desde el panel de administración:
- Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
- Haz clic en "Guardar" sin cambiar nada. Esto regenerará el .htaccess automáticamente.
Prueba tu tienda. Si el error desaparece, el problema era el .htaccess anterior.

[TIP] Si usas un servidor Nginx, no hay .htaccess. En ese caso, verifica la configuración de reescritura de URLs en tu panel de hosting.

## Paso 3: Comprobar los permisos de archivos y carpetas

Los permisos incorrectos son una causa frecuente del error 500 PrestaShop. PrestaShop necesita permisos específicos para leer y escribir archivos.

### Permisos recomendados:

Archivos: 644 (lectura y escritura para el propietario, solo lectura para el grupo y otros).
Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y otros).

### Cómo corregirlos:

Usa un cliente FTP (como FileZilla) para conectarte.
Selecciona toda la carpeta de tu tienda (normalmente public_html o www).
Haz clic derecho y elige "Permisos de archivos".
Establece 755 para carpetas y 644 para archivos. Algunos FTP permiten aplicar recursivamente (a todas las subcarpetas y archivos).
Si usas Syspanel (HestiaCP), puedes acceder al panel de archivos desde el puerto 2106 y cambiar permisos desde la interfaz web.

[WARNING] No pongas permisos 777 (todos pueden escribir), ya que es un riesgo de seguridad. Solo 755 y 644 son seguros.

## Paso 4: Revisar los logs del servidor

Si los pasos anteriores no funcionan, los logs del servidor te darán pistas exactas. Los logs registran cada error que ocurre en tu sitio.

### Dónde encontrar los logs:

En cPanel: Ve a "Métricas > Errores" o "Log de errores".
En Syspanel (HestiaCP): Accede por el puerto 2106, ve a "Web > Logs" y selecciona tu dominio.
Por FTP: Busca la carpeta logs dentro de tu cuenta de hosting (a veces está fuera de public_html).

Busca líneas que contengan "PHP Fatal error" o "500 Internal Server Error". Por ejemplo:

PHP Fatal error: Allowed memory size of 134217728 bytes exhausted → indica falta de memoria.
PHP Parse error: syntax error, unexpected... → error de sintaxis en un archivo PHP.

[INFO] Si no entiendes los logs, copia el mensaje exacto y búscalo en Google o en foros de PrestaShop. La comunidad suele tener soluciones.

## Paso 5: Desactivar módulos y temas conflictivos

Un módulo o tema mal codificado puede causar el error 500 PrestaShop. Si instalaste algo recientemente, es probable que sea el culpable.

### Cómo desactivar módulos manualmente:

Conéctate a tu base de datos mediante phpMyAdmin (desde tu panel de hosting).
Busca la tabla ps_module (el prefijo puede variar, por ejemplo, prestashop_module).
Haz clic en "Examinar" y localiza el módulo sospechoso. Anota su id_module.
Ve a la tabla ps_module_shop y elimina la fila con ese id_module. Esto desactiva el módulo.
También puedes renombrar la carpeta del módulo en /modules/ (por ejemplo, de modulox a modulox_desactivado). Esto lo desactivará automáticamente.

### Para desactivar el tema:

Ve a la tabla ps_theme en phpMyAdmin.
Cambia el nombre del tema activo por el de un tema predeterminado (como classic).
Si no funciona, renombra la carpeta del tema en /themes/ para forzar a PrestaShop a usar el tema por defecto.

[TIP] Haz siempre una copia de seguridad de la base de datos antes de modificar tablas.

## Paso 6: Aumentar la memoria PHP

Muchos errores 500 se deben a que PHP se queda sin memoria. Esto es común en tiendas con muchos módulos o catálogos grandes.

### Cómo aumentar la memoria:

En el archivo php.ini (si tienes acceso): Busca memory_limit y cámbialo a memory_limit = 256M o 512M.
En el archivo .htaccess: Añade esta línea: php_value memory_limit 256M.
En el panel de hosting: En Syspanel (HestiaCP), ve a "Web > Configuración PHP" y ajusta el límite de memoria desde la interfaz (puerto 2106).
En cPanel: Ve a "Software > Seleccionar versión de PHP" y luego a "Opciones de PHP" para cambiar memory_limit.

[WARNING] No pongas valores excesivos como 1024M, ya que puede afectar al rendimiento del servidor. 256M suele ser suficiente para PrestaShop.

## Paso 7: Verificar la versión de PHP y PrestaShop

La incompatibilidad de versiones es otra causa común. PrestaShop necesita una versión específica de PHP.

### Requisitos básicos:

PrestaShop 1.7: PHP 7.1 a 8.0 (recomendado 7.4).
PrestaShop 8.x: PHP 7.4 a 8.1.

### Cómo cambiar la versión de PHP:

En Syspanel (HestiaCP): Ve a "Web > Configuración PHP" y selecciona la versión deseada (puerto 2106).
En cPanel: Ve a "Software > Seleccionar versión de PHP".
En otros paneles, busca la opción "PHP Version Manager".

Si actualizaste PrestaShop recientemente y te aparece el error, probablemente necesites una versión más reciente de PHP.

## Paso 8: Restaurar una copia de seguridad

Si nada funciona, la solución más rápida es restaurar una copia de seguridad reciente de tu tienda. Esto es especialmente útil si el error apareció después de una actualización o instalación.

### Cómo restaurar:

Accede a tu panel de hosting (Syspanel, cPanel, etc.).
Busca la sección de "Copias de seguridad" o "Backups".
Restaura los archivos y la base de datos a una fecha anterior al error.
Si no tienes copia, contacta a tu proveedor de hosting. Muchos ofrecen backups automáticos.

[INFO] Siempre mantén copias de seguridad periódicas. Puedes programarlas desde Syspanel (HestiaCP) en "Backups" (puerto 2106).

## FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

### ¿El error 500 puede deberse a un plugin de terceros?

Sí, es muy común. Los módulos mal codificados o desactualizados pueden generar conflictos. Desactívalos uno por uno para identificar al culpable.

### ¿Qué hago si no tengo acceso al panel de administración?

Usa FTP o el gestor de archivos de tu hosting para editar archivos directamente. También puedes acceder a la base de datos mediante phpMyAdmin.

### ¿El error 500 afecta al SEO de mi tienda?

Sí, porque los motores de búsqueda no pueden acceder a tu sitio. Si el error persiste, Google puede penalizar tu posicionamiento. Soluciona lo antes posible.

### ¿Debo contactar con mi proveedor de hosting?

Si después de todos estos pasos el error continúa, contacta al soporte técnico. Ellos pueden revisar los logs del servidor y ajustar configuraciones que tú no puedas modificar.

### ¿Puedo evitar futuros errores 500?

Sí, siguiendo buenas prácticas:

Mantén PrestaShop y todos los módulos actualizados.
Haz copias de seguridad regulares.
No instales módulos de fuentes no confiables.
Usa un hosting optimizado para PrestaShop.

Conclusión

El error 500 PrestaShop puede ser frustrante, pero con esta guía tienes las herramientas para solucionar error 500 de manera rápida y efectiva. Recuerda empezar por lo más simple: activar el modo debug, revisar el .htaccess y los permisos. Si el problema persiste, los logs del servidor y la desactivación de módulos suelen dar con la causa. Y si todo falla, una restauración de copia de seguridad te salvará.

[TIP] Para los administradores que usan Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106 y desde allí puedes gestionar archivos, logs y configuraciones PHP fácilmente.

Esperamos que esta guía te haya sido útil. ¡No dudes en compartirla con otros usuarios de PrestaShop que enfrenten el mismo problema!