Solucionar Error 500 en PrestaShop | Guía Paso a Paso

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

Si estás leyendo esto, es muy probable que hayas visto una pantalla blanca o un mensaje que dice "500 Internal Server Error" o "Error 500 PrestaShop" justo cuando intentabas acceder a tu tienda online. No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, en la gran mayoría de los casos, tiene solución sin necesidad de ser un experto en programación.

El PrestaShop 500 Internal Server Error es un error genérico que indica que algo salió mal en el servidor, pero no te dice exactamente qué es. Es como si tu coche no arrancara y el manual solo te dijera "fallo mecánico". La buena noticia es que, con un poco de paciencia y siguiendo una serie de pasos lógicos, podemos encontrar la causa y solucionar error 500 PrestaShop de forma definitiva.

Este error puede aparecer por múltiples razones: archivos con permisos incorrectos, un archivo .htaccess corrupto, falta de memoria PHP, módulos incompatibles o incluso un tema mal configurado. A lo largo de esta guía, vamos a desglosar cada causa posible y te enseñaré cómo arreglarla, tanto si tu tienda está en un hosting compartido como en un VPS (Servidor Virtual Privado).

Primeros pasos: prepara tu entorno de trabajo

Antes de lanzarnos a modificar archivos, es fundamental que prepares dos cosas: una copia de seguridad y un acceso al panel de control de tu hosting.

Haz una copia de seguridad completa

[WARNING]
Nunca, jamás, modifiques archivos de tu PrestaShop sin tener una copia de seguridad reciente. Un error de dedo podría dejar tu tienda inservible. Si no sabes cómo hacerla, contacta con tu proveedor de hosting o usa el administrador de archivos de cPanel para descargar una copia comprimida de la carpeta public_html y exporta tu base de datos desde phpMyAdmin.

Accede a tus archivos

Para solucionar error 500 PrestaShop, necesitarás acceder a los archivos de tu instalación. Puedes hacerlo de dos formas:

Desde el panel de control de tu hosting (cPanel, Plesk, Syspanel, etc.) usando el "Administrador de Archivos".
Mediante FTP con un programa como FileZilla.

[INFO]
Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso se realiza a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106). Una vez dentro, busca la sección "Archivos" o "Administrador de archivos".

Solución 1: Revisa los permisos de archivos y carpetas

La causa más frecuente del error 500 PrestaShop en hosting compartido son los permisos incorrectos en archivos y directorios. Cuando los permisos son demasiado restrictivos o demasiado abiertos, el servidor no puede leer o ejecutar los archivos correctamente.

¿Qué permisos debe tener PrestaShop?

La configuración estándar y segura es la siguiente:

Carpetas (directorios): Permisos 755.
Archivos: Permisos 644.
Carpeta config y cache: A veces necesitan permisos 755 o incluso 777 temporalmente.

Cómo cambiar permisos desde cPanel

Si tu hosting usa cPanel, sigue estos pasos:

Entra en "Administrador de Archivos".
Navega hasta la raíz de tu PrestaShop (normalmente public_html).
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic derecho y elige "Cambiar permisos".
Introduce 755 para carpetas y 644 para archivos.
Marca la casilla "Recursivo" para aplicar a subcarpetas.

Cómo cambiar permisos desde Syspanel (HestiaCP)

Si tu hosting usa Syspanel, el proceso es similar:

Accede por el puerto 2106.
Ve a "Administrador de archivos".
Selecciona los archivos y carpetas.
Usa la opción "Permisos" en la barra superior.
Aplica 755 a carpetas y 644 a archivos.

[TIP]
Si después de cambiar los permisos el error persiste, prueba a dar permisos 777 temporalmente a la carpeta var/cache y var/logs. Si la tienda carga, el problema era de escritura. Luego vuelve a poner 755 para mayor seguridad.

Solución 2: El archivo .htaccess está dañado o es incompatible

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor Apache. Si está corrupto o tiene reglas incompatibles, provocará un PrestaShop 500 Internal Server Error inmediato.

Regenerar el .htaccess desde el panel de administración

La forma más sencilla de arreglarlo es regenerarlo:

Accede a tu panel de administración de PrestaShop (normalmente en /admin o la ruta que configuraste).
Ve a Preferencias → SEO y URLs.
Haz clic en "Guardar" sin cambiar nada. Esto fuerza a PrestaShop a regenerar el .htaccess.

Si no puedes acceder al panel de administración porque también te da error, tendrás que hacerlo manualmente.

Crear un .htaccess limpio manualmente

Conéctate por FTP o al administrador de archivos y sigue estos pasos:

Renombra el archivo .htaccess actual a .htaccess.bak (esto lo desactiva).
Crea un archivo nuevo llamado .htaccess con el siguiente contenido básico:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
</IfModule>
# END PrestaShop

Guarda y prueba tu tienda.

[WARNING]
Este .htaccess es solo una solución temporal para que la tienda cargue. Luego deberás regenerarlo desde el panel de administración para que las URLs amigables funcionen correctamente.

Solución 3: Aumenta el límite de memoria PHP

Otra causa muy común del error 500 PrestaShop es que el script se queda sin memoria. PrestaShop es una aplicación bastante exigente, y si tu hosting tiene un límite bajo de memoria PHP (por ejemplo, 64M), puede fallar.

Modificar el límite de memoria desde cPanel

Entra en "Selector de versión de PHP" o "MultiPHP Manager".
Busca la opción "Opciones de PHP" o "Configuración".
Cambia memory_limit a 256M o 512M.
Guarda los cambios.

Modificar el límite de memoria desde Syspanel

En Syspanel (puerto 2106), el proceso es ligeramente diferente:

Ve a "PHP" o "Configuración de PHP".
Busca la opción memory_limit.
Cámbiala a 256M y guarda.

Modificar manualmente el archivo php.ini

Si no tienes acceso a estas opciones, puedes crear o editar un archivo php.ini en la raíz de tu PrestaShop:

memory_limit = 256M
max_execution_time = 120
upload_max_filesize = 64M

[TIP]
Si no encuentras el php.ini, también puedes añadir estas líneas al archivo .htaccess:

php_value memory_limit 256M
php_value max_execution_time 120

Solución 4: Desactiva módulos o temas conflictivos

A veces, un módulo recién instalado o un tema mal codificado es el culpable del PrestaShop 500 Internal Server Error. El problema es que, si el error ocurre al cargar la tienda, no podrás acceder al panel para desactivarlo.

Desactivar módulos desde la base de datos

Este método es un poco más técnico, pero funciona:

Accede a phpMyAdmin desde tu panel de control.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo ps_ puede variar).
Localiza los módulos que instalaste recientemente y cambia su campo active de 1 a 0.
Guarda y prueba tu tienda.

Forzar la activación del tema por defecto

Si el problema es el tema, puedes cambiarlo directamente en la base de datos:

En phpMyAdmin, busca la tabla ps_shop_url.
Anota el valor de id_shop.
Luego, en la tabla ps_theme, cambia el tema activo al que venía por defecto (por ejemplo, classic).

Solución 5: Revisa los logs de error del servidor

Los logs son tus mejores amigos para solucionar error 500 PrestaShop. Te dirán exactamente qué está fallando.

Dónde encontrar los logs

cPanel: Sección "Métricas" → "Errores" o "Registros de errores".
Syspanel: Accede por el puerto 2106, busca "Logs" o "Registro de errores".
VPS: Conecta por SSH y ejecuta: tail -f /var/log/apache2/error.log o tail -f /var/log/nginx/error.log.

Interpretar los logs

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

[26-Oct-2024 15:32:01 UTC] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted

Este error indica que se agotó la memoria. Otro ejemplo:

[26-Oct-2024 15:32:01 UTC] PHP Fatal error: Uncaught Error: Call to undefined function

Esto suele indicar un módulo o archivo corrupto.

Solución 6: Verifica la versión de PHP y los requisitos de PrestaShop

PrestaShop tiene requisitos mínimos de PHP. Si tu servidor usa una versión demasiado antigua o demasiado nueva, puede dar errores.

Requisitos recomendados

PrestaShop 1.7: PHP 7.1 a 7.4 (PHP 8.0+ puede dar problemas).
PrestaShop 8.x: PHP 7.2 a 8.1.

Cómo cambiar la versión de PHP

cPanel: Busca "Selector de versión de PHP" o "MultiPHP Manager".
Syspanel: En el puerto 2106, busca "PHP" y selecciona la versión deseada.

[WARNING]
Antes de cambiar la versión de PHP, asegúrate de que tus módulos y tema sean compatibles. Un cambio brusco puede generar más errores.

Solución 7: Limpia la caché de PrestaShop

Una caché corrupta puede provocar un error 500 PrestaShop. La caché se guarda en la carpeta var/cache (en PrestaShop 1.7+).

Limpiar la caché manualmente

Conéctate por FTP o administrador de archivos.
Navega a la carpeta var/cache.
Elimina todo el contenido de las subcarpetas dev y prod (no borres las carpetas en sí, solo su contenido).
Vuelve a probar tu tienda.

[TIP]
Si no encuentras la carpeta var/cache, busca la carpeta cache en versiones antiguas de PrestaShop (1.6 o anteriores). También puedes borrar el contenido de la carpeta cache/smarty/compile.

Solución 8: Comprueba el espacio en disco y los límites del hosting

Aunque parezca obvio, quedarse sin espacio en disco es una causa frecuente del error 500 en hosting compartido.

Cómo verificar el espacio

cPanel: Sección "Estadísticas" o "Uso de disco".
Syspanel: En el puerto 2106, busca "Uso de disco" o "Estadísticas".

Si estás al 100% de tu capacidad, elimina archivos temporales, copias de seguridad antiguas o logs innecesarios. También vacía la papelera del administrador de archivos.

Solución 9: Revisa los archivos de configuración de la base de datos

Un error en el archivo parameters.php (en la carpeta app/config) puede causar el error. Si la base de datos no se conecta correctamente, PrestaShop no puede cargar.

Conéctate por FTP.
Ve a app/config/parameters.php.
Verifica que los datos de conexión (host, usuario, contraseña, nombre de BD) sean correctos.

[WARNING]
Este archivo contiene información sensible. No lo compartas con nadie y ten mucho cuidado al editarlo.

Preguntas frecuentes (FAQ)

¿El error 500 en PrestaShop es peligroso para mi tienda?

No es peligroso en sí mismo, pero si no se soluciona, tus clientes no podrán comprar. Además, Google podría penalizar tu posicionamiento si el error persiste durante mucho tiempo.

¿Puedo evitar el error 500 en el futuro?

Sí, siguiendo buenas prácticas: mantén PrestaShop actualizado, usa módulos de fuentes confiables, haz copias de seguridad periódicas y no satures tu hosting con aplicaciones innecesarias.

¿Debo contratar un VPS si tengo muchos errores 500?

Si tu tienda tiene mucho tráfico y los errores son frecuentes, un VPS te dará más control y recursos. Sin embargo, primero prueba las soluciones de esta guía, ya que la mayoría de los errores 500 se resuelven con ajustes de configuración.

¿Qué hago si ninguna de estas soluciones funciona?

Contacta con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden identificar el problema más rápidamente. Si estás en un VPS, revisa la configuración de Apache o Nginx y los logs del sistema con más detalle.

Resumen final: tu checklist para solucionar el error 500

Para que no se te olvide nada, aquí tienes un resumen rápido de todo lo que hemos visto:

Haz una copia de seguridad completa.
Revisa y corrige los permisos de archivos (755 carpetas, 644 archivos).
Regenera o reemplaza el archivo .htaccess.
Aumenta el límite de memoria PHP a 256M o más.
Desactiva módulos o temas sospechosos desde la base de datos.
Consulta los logs de error del servidor.
Ajusta la versión de PHP a una compatible.
Limpia la caché de PrestaShop.
Verifica que tengas espacio en disco suficiente.
Revisa el archivo parameters.php para confirmar que la conexión a la BD es correcta.

[INFO]
Recuerda que en Syspanel (HestiaCP), el acceso al panel se realiza por el puerto 2106. Si necesitas ayuda adicional, el soporte técnico de tu hosting siempre es un buen recurso, especialmente en casos de hosting compartido donde algunas configuraciones están limitadas.

Espero que esta guía te haya sido de utilidad y que tu tienda vuelva a funcionar en breve. El error 500 PrestaShop es frustrante, pero con estos pasos, en la mayoría de los casos, se resuelve en menos de una hora. ¡Mucha suerte con tu tienda online!