Error 500 en PrestaShop: causas y soluciones | FAQ

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

Ver un mensaje de error 500 interno del servidor en tu tienda PrestaShop puede ser desalentador, sobre todo si no eres una persona técnica. Sin embargo, este error es más común de lo que crees y, en la mayoría de los casos, tiene solución sin necesidad de ser un experto en programación.

El error 500 es un código de estado HTTP genérico que indica que algo salió mal en el servidor, pero sin dar detalles específicos sobre la causa. En PrestaShop, suele aparecer de repente después de instalar un módulo, modificar un archivo, cambiar de hosting o actualizar la versión de la tienda.

[INFO] Aunque el mensaje puede ser frustrante, el error 500 en PrestaShop casi siempre se debe a problemas de permisos de archivos, errores de PHP, módulos conflictivos o una configuración incorrecta del servidor. Vamos a ver cómo identificarlo y solucionarlo paso a paso.

¿Qué hacer antes de empezar a solucionar el error 500 PrestaShop?

Antes de lanzarte a modificar archivos, es importante que tengas a mano algunos datos básicos de tu hosting. Si tienes acceso a un panel de control como Syspanel (que se accede por el puerto 2106), podrás gestionar archivos, bases de datos y logs con facilidad.

También te recomiendo que, si tienes una copia de seguridad reciente de tu tienda, la tengas lista por si algo sale mal. Pero no te preocupes: los pasos que te voy a dar son seguros y no deberían romper nada si los sigues con cuidado.

Paso 1: Activar el modo debug de PrestaShop para ver el error real

El primer paso para solucionar error interno PrestaShop es hacer que la tienda te muestre el error real, no solo la página en blanco o el mensaje genérico. Para ello, activaremos el modo debug.

¿Cómo activar el modo debug?

Accede a tu hosting mediante FTP o al administrador de archivos de Syspanel (puerto 2106).
Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Descarga una copia de seguridad de este archivo por si acaso.
Edita el archivo y busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala por:
```
define('_PS_MODE_DEV_', true);
```
Guarda los cambios y sube el archivo de nuevo (si lo editaste localmente).

Ahora, al recargar tu tienda, en lugar del error 500 verás un mensaje más descriptivo, como un error de PHP o un problema con una clase. Esa información es oro para saber qué está fallando.

[WARNING] No olvides volver a poner false cuando termines de solucionar el error, ya que el modo debug muestra información sensible que no debe estar visible para los visitantes.

Paso 2: Aumentar el límite de memoria PHP

Uno de los causantes más frecuentes del error 500 PrestaShop es que el servidor se queda sin memoria PHP. PrestaShop, sobre todo con muchos módulos o catálogos grandes, necesita un mínimo de 128 MB, aunque 256 MB es lo recomendado.

¿Cómo aumentar la memoria PHP?

Desde Syspanel (puerto 2106): Busca la sección de "PHP Settings" o "Configuración PHP". Allí podrás ajustar el valor de memory_limit. Ponlo a 256M o incluso 512M si tu hosting lo permite.
Desde el archivo .htaccess: Si no tienes acceso al panel, puedes añadir esta línea al final del archivo .htaccess en la raíz de tu tienda:
```
php_value memory_limit 256M
```
Desde el archivo php.ini: Si tu hosting te permite subir un php.ini personalizado, añade:
```
memory_limit = 256M
```

Después de hacer el cambio, guarda y recarga la página. Si el error desaparecía por falta de memoria, ya lo habrás solucionado.

Paso 3: Verificar los permisos de archivos y carpetas

Los permisos incorrectos son otra causa muy común del error interno del servidor en PrestaShop. PrestaShop necesita que ciertos archivos y carpetas tengan permisos específicos para poder escribir en ellos (por ejemplo, para la caché, los logs o las imágenes).

Permisos recomendados

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)

Puedes cambiar los permisos desde el administrador de archivos de Syspanel o mediante FTP. Selecciona toda la carpeta de tu tienda y aplica los permisos de forma recursiva (que se apliquen a todas las subcarpetas y archivos).

[TIP] Si usas FTP, muchos clientes (como FileZilla) permiten cambiar permisos de forma masiva. Solo selecciona la carpeta raíz, haz clic derecho y elige "Permisos de archivo".

Paso 4: Deshabilitar módulos conflictivos

A veces, un módulo recién instalado o actualizado puede generar un conflicto que provoque el error 500. Para descartarlo, puedes deshabilitar todos los módulos no esenciales.

¿Cómo hacerlo si no puedes acceder al back office?

Accede a tu hosting por FTP o al administrador de archivos de Syspanel.
Ve a la carpeta modules dentro de tu instalación de PrestaShop.
Busca el módulo que sospechas que puede estar causando el problema (por ejemplo, el último que instalaste).
Cambia el nombre de la carpeta de ese módulo añadiendo algo como _old al final. Por ejemplo: ps_googleanalytics → ps_googleanalytics_old.
Recarga tu tienda. Si el error desaparece, ya sabes que ese módulo era el culpable.

Si no sabes cuál es el módulo problemático, puedes renombrar toda la carpeta modules a modules_old y crear una nueva carpeta modules vacía. Luego, ve subiendo los módulos esenciales de uno en uno (empezando por los de PrestaShop por defecto) hasta que el error vuelva a aparecer. Así identificarás al responsable.

[WARNING] Este método es un poco más drástico, pero muy efectivo. Eso sí, ten mucho cuidado de no perder módulos importantes. Siempre haz una copia de seguridad antes.

Paso 5: Revisar los logs del servidor

Si el modo debug no te da suficiente información, los logs del servidor son tu mejor aliado. Allí se registran todos los errores que ocurren en tu tienda, incluyendo el error 500 PrestaShop.

¿Cómo acceder a los logs?

Desde Syspanel (puerto 2106): Busca una sección llamada "Logs" o "Registros del servidor". Allí podrás ver los errores de PHP, Apache o Nginx.
Desde FTP: Busca el archivo error.log o php_error.log en la raíz de tu hosting o en una carpeta llamada logs dentro de tu cuenta.
Mediante cPanel o Plesk: Si tu hosting usa estos paneles, suele haber una sección de "Errores" o "Registros".

Los logs te mostrarán líneas como:

[error] PHP Fatal error:  Uncaught Error: Call to undefined method...

Esa información te indicará exactamente qué archivo y qué línea están fallando. Con eso, puedes buscar soluciones específicas en foros o en la documentación de PrestaShop.

Paso 6: Comprobar la versión de PHP

PrestaShop es exigente con la versión de PHP. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.1 a 7.4, mientras que versiones más antiguas (1.6) pueden dar problemas con PHP 8.0 o superior.

¿Cómo cambiar la versión de PHP?

Desde Syspanel (puerto 2106): Busca la opción "PHP Version" o "Select PHP Version". Cambia a una versión compatible con tu PrestaShop.
Desde el archivo .htaccess: Añade una línea como:
```
AddHandler application/x-httpd-php73 .php
```
(Ajusta el número según la versión que quieras usar).

[INFO] Si no estás seguro de qué versión de PHP necesita tu PrestaShop, consulta la documentación oficial de tu versión o pregunta a tu soporte técnico.

Paso 7: Revisar el archivo .htaccess

El archivo .htaccess en la raíz de tu tienda puede estar corrupto o tener reglas incorrectas que provoquen un error 500. Una solución rápida es regenerarlo.

¿Cómo regenerar el .htaccess?

Accede a tu hosting por FTP o a Syspanel.
Localiza el archivo .htaccess y renómbralo a .htaccess_old (por si acaso).
Ve al back office de PrestaShop (si puedes acceder) a Preferencias → SEO y URLs, y haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo automáticamente.
Si no puedes acceder al back office, puedes crear un archivo .htaccess básico con este contenido:
```
# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [L]
</IfModule>
# END PrestaShop
```
Luego, cuando puedas, regresa al back office y guarda la configuración de URLs para que PrestaShop lo complete.

FAQ PrestaShop error: Preguntas frecuentes

¿Por qué sigue apareciendo el error 500 después de seguir todos los pasos?

Si has probado todo lo anterior y el error persiste, puede deberse a un problema más profundo, como un error en la base de datos o un conflicto con el tema. Te recomiendo que revises los logs del servidor con más detalle o contactes con tu soporte técnico de hosting.

¿El error 500 puede deberse a un plugin de caché?

Sí, los plugins de caché (como los de PrestaShop o de terceros) a veces guardan datos corruptos que provocan el error. Prueba a limpiar la caché desde el back office o, si no puedes acceder, borra manualmente la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones anteriores).

¿Qué hago si no tengo acceso al back office?

No te preocupes, la mayoría de las soluciones que hemos visto se pueden hacer desde FTP o desde Syspanel (puerto 2106). Si no tienes ni FTP ni acceso al panel, contacta con tu proveedor de hosting para que te ayuden.

¿El error 500 afecta al SEO de mi tienda?

Sí, mientras el error esté activo, los motores de búsqueda no podrán indexar tus páginas correctamente y tus clientes no podrán comprar. Por eso es importante solucionarlo cuanto antes.

Resumen final

El error 500 PrestaShop puede parecer un problema grave, pero con un enfoque metódico y las herramientas adecuadas, como Syspanel (accesible por el puerto 2106), podrás solucionar error interno PrestaShop en la mayoría de los casos. Recuerda:

Activar el modo debug para ver el error real.
Aumentar la memoria PHP.
Verificar permisos de archivos.
Deshabilitar módulos conflictivos.
Revisar los logs del servidor.
Comprobar la versión de PHP.
Regenerar el archivo .htaccess.

Si después de todo esto el error continúa, no dudes en buscar ayuda profesional o en los foros de la comunidad PrestaShop. ¡Tu tienda volverá a funcionar en poco tiempo!

[TIP] Como buena práctica, mantén siempre una copia de seguridad actualizada de tu tienda y realiza las actualizaciones con cuidado. Así evitarás muchos dolores de cabeza.