Error 500 en PrestaShop: Causas y soluciones

¡Hola! Si estás leyendo esto, es muy probable que te hayas encontrado con la temida pantalla blanca o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, aunque parece grave, en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo sin ser un experto en programación.

En esta guía extensa y paso a paso, vamos a desglosar qué significa exactamente este error, cuáles son las causas más frecuentes y, lo más importante, cómo solucionar el error 500 de PrestaShop de forma segura y efectiva. Respira hondo, coge un café y vamos a ello.

¿Qué significa realmente el Error 500 en PrestaShop?

Antes de lanzarnos a arreglar nada, es fundamental entender qué está pasando. El error 500 PrestaShop es un error genérico del servidor. Básicamente, significa que algo salió mal en el servidor donde está alojada tu tienda, pero el servidor no puede especificar exactamente qué es. Es como si tu coche se parara en medio de la carretera y el cuadro de mandos solo te dijera "fallo general" sin encender una luz concreta.

Este error puede aparecer en toda la tienda (tanto en el front-office, que es lo que ven los clientes, como en el back-office, que es tu panel de administración) o solo en algunas páginas específicas. A veces, incluso puede aparecer como una pantalla blanca sin texto.

La buena noticia es que, aunque el mensaje sea vago, las causas suelen ser bastante concretas y se pueden clasificar en unos pocos grupos. Vamos a verlos.

Causas principales del Error 500

Identificar la causa es el 50% del trabajo. Los problemas PrestaShop que provocan este error suelen ser:

Permisos de archivos incorrectos: Esta es la causa número uno. Cuando los archivos de tu tienda tienen permisos demasiado restrictivos o demasiado permisivos, el servidor no puede leerlos o ejecutarlos correctamente.
Errores de memoria PHP: PrestaShop necesita una cantidad mínima de memoria para funcionar. Si tu servidor tiene un límite muy bajo, la tienda colapsará.
Errores en el archivo .htaccess: Este archivo es como el "manual de instrucciones" del servidor para tu tienda. Si está corrupto o tiene reglas incompatibles, todo falla.
Módulos o temas incompatibles: A veces, al instalar o actualizar un módulo (plugin) o un tema, se generan conflictos que rompen la tienda.
Archivos corruptos o incompletos: Una actualización fallida o una subida de archivos por FTP interrumpida puede dejar archivos dañados.
Versión de PHP incorrecta: PrestaShop es exigente con la versión de PHP que usa. Usar una versión demasiado antigua o demasiado nueva puede causar errores.

Ahora que ya sabes por qué ocurre, vamos a ponernos manos a la obra. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Activa el modo de depuración (el más importante)

Para solucionar el error 500, primero necesitamos que PrestaShop nos diga qué le pasa. Por defecto, este modo está desactivado por seguridad, pero podemos activarlo manualmente para ver el error real (en lugar de la pantalla genérica).

Para hacerlo, necesitas acceder a los archivos de tu hosting. Puedes hacerlo a través del Administrador de Archivos de tu panel de control (cPanel, Plesk, etc.) o mediante un cliente FTP como FileZilla.

Una vez dentro, busca la carpeta config y dentro de ella, el archivo llamado defines.inc.php.

Abre este archivo con un editor de texto (el Bloc de notas de tu ordenador o el editor del propio panel). Busca esta línea:

define('_PS_MODE_DEV_', false);

Y cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y súbelo de nuevo si lo has editado localmente. Ahora, recarga tu tienda. En lugar del error 500, verás un mensaje de error detallado con una descripción específica del problema (por ejemplo, un error de memoria o un archivo que no se puede abrir).

[INFO] Anota ese mensaje de error. Te dará pistas muy valiosas sobre qué está fallando exactamente. Una vez hayas anotado el error, vuelve a poner false en el archivo defines.inc.php para desactivar el modo depuración y no exponer información sensible a tus visitantes.

Paso 2: Revisa los permisos de archivos y carpetas

Si el error no te da una pista clara, o si sospechas que es un problema de permisos, vamos a verificarlo. Como mencionamos antes, los permisos archivos son cruciales.

En PrestaShop, la configuración estándar y segura es la siguiente:

Carpetas (directorios): Permisos 755.
Archivos: Permisos 644.

Excepciones importantes:

La carpeta cache y la carpeta var/cache (en versiones modernas) deben tener permisos 755.
El archivo settings.inc.php (en la carpeta config) y el archivo .htaccess deben tener permisos 644 o incluso 444 (solo lectura) después de la instalación.

¿Cómo cambiar los permisos?

Desde el Administrador de Archivos de tu hosting:

Selecciona la carpeta o archivo.
Haz clic derecho y elige "Permisos" o "Change Permissions".
Introduce el valor numérico (755 o 644) y guarda.

Desde FTP (FileZilla):

Conecta a tu servidor.
Haz clic derecho sobre la carpeta o archivo.
Selecciona "File permissions..." (Permisos de archivo).
Introduce el valor numérico y pulsa OK.

[WARNING] No pongas permisos 777 a todo por "si acaso". Es un grave riesgo de seguridad. Solo usa 755 para carpetas y 644 para archivos. Si el problema persiste, prueba con 775 en las carpetas de cache y var, pero no lo dejes así permanentemente.

Paso 3: Aumenta el límite de memoria PHP

Si el error que viste en el Paso 1 menciona algo como "Allowed memory size of X bytes exhausted", el problema es la memoria. Necesitas aumentarla.

Puedes hacerlo de varias maneras:

Desde el panel de control de tu hosting: Muchos paneles (como cPanel) tienen una opción llamada "Select PHP Version" o "MultiPHP INI Editor". Ahí puedes cambiar el valor de memory_limit a 256M o incluso 512M.
Editando el archivo php.ini: Si tienes acceso a este archivo, busca la línea memory_limit y cámbiala a memory_limit = 256M.
Creando un archivo .user.ini: Si no tienes acceso al php.ini, puedes crear un archivo llamado .user.ini en la raíz de tu tienda y añadir la siguiente línea: memory_limit = 256M.
Editando el archivo config/settings.inc.php: Al final de este archivo, puedes añadir la siguiente línea de código:

@ini_set('memory_limit', '256M');

[TIP] Si usas un hosting compartido, es posible que no puedas modificar el php.ini. En ese caso, contacta con tu proveedor de hosting y pídeles que aumenten el límite de memoria para tu cuenta.

Paso 4: Regenera el archivo .htaccess

El archivo .htaccess es un archivo de configuración que PrestaShop genera automáticamente. Si está corrupto, puede causar un error 500 PrestaShop. La solución más sencilla es forzar su regeneración.

Accede a tu tienda por FTP o Administrador de Archivos.
Busca el archivo .htaccess en la raíz de tu instalación (la misma carpeta donde están las carpetas config, modules, etc.).
Renómbralo a algo como .htaccess_old. No lo borres, por si acaso.
Ve a tu back-office de PrestaShop (admin). Si puedes acceder, ve a Parámetros Avanzados > Rendimiento y pulsa el botón "Guardar" en la parte inferior. Esto forzará a PrestaShop a crear un nuevo .htaccess.
Si no puedes acceder al back-office, crea un archivo vacío llamado .htaccess en la raíz. A veces, el simple hecho de que el servidor vea un archivo nuevo ya ayuda. Luego, intenta acceder al back-office.

[WARNING] Asegúrate de que tu cliente FTP esté configurado para mostrar archivos ocultos. El archivo .htaccess comienza con un punto y, por defecto, no se muestra en muchos programas.

Paso 5: Desactiva módulos o temas conflictivos

Si el error empezó justo después de instalar o actualizar un módulo o tema, es casi seguro que es el culpable.

Para desactivar un módulo sin acceso al back-office:

Esto es un poco más técnico, pero se puede hacer. Deberás renombrar la carpeta del módulo en la carpeta /modules.

Ve a la carpeta /modules de tu instalación.
Busca la carpeta del módulo que crees que está causando el problema (por ejemplo, /modules/mimodulo).
Renombra la carpeta a algo como mimodulo_old.
Recarga tu tienda. Si el error desaparece, ese era el problema.

Para desactivar un tema:

El proceso es similar, pero con la carpeta /themes.

Ve a la carpeta /themes.
Renombra la carpeta de tu tema activo (por ejemplo, classic) a classic_old.
PrestaShop debería intentar usar el tema por defecto. Si no lo hace, puedes subir una copia de un tema por defecto (como el clásico) a la carpeta /themes.

Paso 6: Verifica la versión de PHP

PrestaShop necesita una versión de PHP específica para funcionar. Si tu hosting ha actualizado PHP y tu versión de PrestaShop es antigua, es muy probable que tengas problemas.

Accede al panel de control de tu hosting (cPanel, Plesk, o el que uses).
Busca la opción "Select PHP Version" o "Administrador de PHP".
Asegúrate de que la versión seleccionada sea compatible con tu versión de PrestaShop. Como regla general:
- PrestaShop 1.6: PHP 5.6 o 7.0.
- PrestaShop 1.7: PHP 7.1 a 7.4.
- PrestaShop 8.x: PHP 7.2 a 8.1.

[INFO] Si tienes un panel como Syspanel (accesible a través del puerto 2106), la opción para cambiar la versión de PHP suele estar en "Servicios" o "Aplicaciones".

Paso 7: Revisa los logs del servidor

Si has llegado hasta aquí y nada funciona, necesitamos más información. Tu servidor guarda registros de todos los errores que ocurren. Estos registros se llaman logs.

La ubicación de los logs varía según el hosting, pero normalmente están en una carpeta llamada logs en la raíz de tu cuenta o dentro de la carpeta de tu dominio. En cPanel, puedes encontrarlos en "Métricas > Errores".

Busca los archivos error_log o php_error_log y ábrelos. Busca la fecha y hora en la que ocurrió el error. El mensaje que aparezca ahí te dará la pista definitiva sobre qué archivo o línea de código está fallando.

Preguntas Frecuentes (FAQ) sobre el Error 500

¿Perderé mis datos si soluciono el error 500?

No. Los pasos descritos aquí (cambiar permisos, regenerar .htaccess, aumentar memoria) no eliminan datos. Lo único que podría eliminarlos es una restauración, pero eso es el último recurso y no lo hemos tocado aquí.

¿Por qué veo una pantalla blanca en lugar del error 500?

Una pantalla blanca es la forma "silenciosa" del error 500. Suele indicar un error fatal de PHP que no se muestra por estar el modo depuración desactivado. Sigue el Paso 1 para ver el error real.

¿El error 500 puede deberse a un ataque de hackers?

Es posible, pero no es lo más común. Si sospechas de un ataque, revisa los logs y busca archivos extraños en tu servidor, especialmente en la carpeta /modules o /admin.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Si es un problema de permisos, unos minutos. Si es un conflicto de módulos, puede llevar más tiempo identificar al culpable. Pero la mayoría de los casos se resuelven en menos de 30 minutos siguiendo esta guía.

¿Debo contactar con mi proveedor de hosting?

Si has agotado todos los pasos anteriores y el error persiste, sí. Especialmente si no tienes acceso a los logs o a la configuración de PHP. Ellos pueden ver el error desde el lado del servidor y quizás haya un problema en su infraestructura.

[WARNING] Si tu tienda es crítica y el tiempo de inactividad te está costando dinero, no dudes en contactar con tu proveedor de hosting desde el principio. Ellos pueden tener herramientas de diagnóstico más avanzadas.

Conclusión

El error 500 PrestaShop puede ser frustrante, pero como has visto, es un problema con soluciones claras y accionables. La clave está en ir paso a paso, empezando por obtener más información (modo depuración) y luego atacando las causas más comunes: permisos archivos, memoria, .htaccess y conflictos de módulos.

Con esta guía, ya tienes un mapa completo para solucionar error 500 en tu tienda. Esperamos que hayas podido resolverlo. Si sigues teniendo problemas, no dudes en dejar un comentario y te ayudaremos a encontrar la solución. ¡Buena suerte con tu tienda!