Errores PrestaShop: página blanca y error 500 soluciones

Imagina que estás a punto de recibir un pedido importante en tu tienda online y, de repente, todo lo que ves es una pantalla en blanco o un temido error 500. Es una situación frustrante, pero no te preocupes: es uno de los problemas más comunes en PrestaShop y, por suerte, casi siempre tiene solución.

En esta guía extensa, vamos a desglosar las causas más frecuentes de la página blanca y el error 500 en PrestaShop, y te daremos pasos concretos para solucionar errores sin necesidad de ser un experto en programación. Al final, tendrás un plan de acción claro para recuperar tu tienda.

¿Qué significan la página blanca y el error 500?

Antes de lanzarnos a las soluciones, entendamos qué está pasando.

Error 500 (Internal Server Error)

El error 500 es un código de estado HTTP que indica que el servidor encontró un problema inesperado y no pudo completar la solicitud. Es como si el servidor dijera: "Algo salió mal, pero no sé decirte exactamente qué". En el contexto de PrestaShop, esto suele deberse a un conflicto con módulos, temas, límites de memoria o archivos de configuración corruptos.

Página blanca (Pantalla en blanco)

La página blanca es un síntoma aún más frustrante. No ves ningún mensaje de error, solo un fondo blanco. Esto ocurre cuando PHP se encuentra con un error fatal (como un error de sintaxis o de memoria) y, por seguridad, no muestra nada al usuario. El servidor simplemente se queda en blanco.

Causas comunes y cómo identificarlas

Vamos a ver las razones más habituales detrás de estos problemas. Identificar la causa correcta es el 80% de la solución.

1. Límite de memoria de PHP agotado

Cada script de PHP tiene un límite de memoria. Si tu PrestaShop tiene muchos módulos, imágenes grandes o un catálogo extenso, puede superar ese límite y provocar un error 500 o una página blanca.

Cómo identificarlo: Revisa los logs de error de tu servidor. Si ves mensajes como Allowed memory size of X bytes exhausted, esa es la causa.

2. Módulo o tema incompatible

Instalar un módulo o tema de terceros es una de las causas más frecuentes. A veces, un módulo no es compatible con tu versión de PrestaShop o tiene un error de código que rompe todo.

Cómo identificarlo: Si el problema empezó justo después de instalar o actualizar un módulo/tema, ese es el culpable.

3. Archivos de configuración corruptos

Los archivos config/settings.inc.php (en versiones antiguas) o app/config/parameters.php (en PrestaShop 1.7+) contienen la configuración de la base de datos. Si se dañan, el sistema no puede conectarse y genera un error.

Cómo identificarlo: Si ves errores de conexión a la base de datos en los logs, este es el problema.

4. Error de sintaxis en un archivo PHP

A veces, al editar un archivo (por ejemplo, el .htaccess o un archivo de módulo), se introduce un error de sintaxis (una coma mal puesta, un punto y coma faltante, etc.). Esto provoca una página blanca inmediata.

5. Problemas con el archivo .htaccess

El archivo .htaccess de PrestaShop es crucial para las URL amigables. Si se corrompe, puede dar error 500 al navegar por la tienda.

6. Permisos de archivos incorrectos

El servidor necesita permisos específicos para leer y escribir archivos. Si los permisos son demasiado restrictivos o demasiado abiertos, pueden causar problemas.

Soluciones paso a paso para recuperar tu tienda

Aquí tienes un plan de acción ordenado de menor a mayor complejidad. Empieza por el paso 1 y avanza hasta que funcione.

Paso 1: Activar el modo debug de PrestaShop

El modo debug te mostrará el error real en lugar de la página blanca. Es como encender una linterna en la oscuridad.

Accede a tu panel de control de hosting (por ejemplo, Syspanel en el puerto 2106).
Ve al administrador de archivos o usa FTP para conectarte.
Busca el archivo config/defines.inc.php en la raíz de tu PrestaShop.
Edítalo y busca la línea:
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
Guarda el archivo. Ahora, al recargar tu tienda, verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size...").

[WARNING] No dejes el modo debug activado en una tienda en producción, ya que muestra información sensible. Desactívalo cuando termines de depurar.

Paso 2: Aumentar el límite de memoria de PHP

Si el modo debug te muestra un error de memoria, sigue estos pasos:

Desde tu panel de control (cPanel, Syspanel en puerto 2106, Plesk, etc.), busca la sección "PHP Settings" o "Select PHP Version".
Busca la opción memory_limit y cámbiala a un valor más alto, por ejemplo 256M o 512M.
Guarda los cambios y reinicia el servicio PHP si es necesario.

[TIP] Si no puedes cambiarlo desde el panel, puedes intentar añadir esta línea al archivo config/defines.inc.php (justo después de la configuración de debug):
ini_set('memory_limit', '512M');

Paso 3: Desactivar módulos y temas problemáticos

Si no puedes acceder al back office, tendrás que hacerlo manualmente.

Para desactivar un módulo desde FTP o el administrador de archivos:

Ve a la carpeta modules de tu PrestaShop.
Busca la carpeta del módulo que sospechas que causa el problema (por ejemplo, modules/mimodulo).
Cambia el nombre de la carpeta añadiendo un guion bajo al final, por ejemplo: mimodulo_. Esto desactiva el módulo porque PrestaShop ya no lo encuentra.
Recarga tu tienda. Si el error desaparece, ya sabes qué módulo es.

Para cambiar el tema por el predeterminado:

Ve a la carpeta themes de tu PrestaShop.
Busca la carpeta de tu tema actual y cámbiale el nombre (ej: mitema_).
PrestaShop usará el tema por defecto (generalmente classic o default-bootstrap). Si la tienda vuelve a funcionar, el problema es tu tema.

Paso 4: Regenerar el archivo .htaccess

Un .htaccess corrupto es un clásico. Regenerarlo es muy fácil.

Conéctate por FTP o al administrador de archivos.
Busca el archivo .htaccess en la raíz de tu PrestaShop. (Nota: puede estar oculto. Activa "Mostrar archivos ocultos" en tu cliente FTP).
Descarga una copia de seguridad de este archivo por si acaso.
Elimina el archivo .htaccess original.
Ahora, accede a tu back office de PrestaShop (si puedes) o, si no, usa el siguiente truco:
- Ve a tu-tienda.com/index.php?controller=AdminDashboard (o la URL de tu back office).
- Una vez dentro, ve a Configuración de la tienda > Parámetros generales.
- En la pestaña SEO y URL, desmarca y vuelve a marcar la opción "Amigable URL" y guarda. Esto regenerará el .htaccess automáticamente.

Paso 5: Verificar y corregir permisos de archivos

Los permisos incorrectos pueden bloquear el acceso a archivos clave.

Desde tu panel de control o FTP, ve a la raíz de tu PrestaShop.
Asegúrate de que las carpetas tengan permisos 755 y los archivos 644.
Las carpetas cache, log y upload a veces necesitan permisos 777 para que PrestaShop pueda escribir en ellas. Si ves errores de escritura, pruébalo.

[WARNING] No dejes permisos 777 en todos los archivos por seguridad. Úsalos solo temporalmente en carpetas específicas.

Paso 6: Restaurar archivos de configuración

Si los pasos anteriores no funcionan, es posible que tus archivos de configuración estén dañados.

Haz una copia de seguridad de los archivos app/config/parameters.php (o config/settings.inc.php en versiones antiguas).
Si tienes una copia de seguridad reciente de tu tienda, restaura este archivo.
Si no tienes copia, puedes intentar reemplazarlo con el archivo de una instalación limpia de la misma versión de PrestaShop, pero luego deberás editar los datos de conexión a la base de datos (nombre, usuario, contraseña, servidor) que se encuentran dentro del archivo.

Paso 7: Aumentar el tiempo de ejecución de PHP

A veces, un script tarda demasiado y el servidor lo mata. Esto puede dar error 500 en procesos largos como la importación de productos.

En la configuración de PHP de tu hosting, busca max_execution_time.
Cámbialo a 120 o 300 segundos.

Preguntas frecuentes (FAQ) para solucionar errores

¿Por qué mi PrestaShop da error 500 después de una actualización?

Las actualizaciones de módulos, temas o del propio PrestaShop pueden dejar archivos obsoletos o incompatibles. La solución más rápida es desactivar todos los módulos no nativos (paso 3) y cambiar al tema por defecto (paso 3). Si funciona, ve activando uno a uno para encontrar el culpable.

¿La página blanca puede deberse a un problema de hosting?

Sí. Un servidor sobrecargado, un cortafuegos mal configurado o un límite de recursos muy bajo pueden causar página blanca. Contacta con tu proveedor de hosting (el que te da acceso a Syspanel en el puerto 2106) y pregúntales si hay restricciones de memoria, CPU o conexiones simultáneas.

¿Cómo accedo a los logs de error del servidor?

Es la mejor manera de solucionar errores. Normalmente están en la carpeta log de tu hosting. En Syspanel (puerto 2106), busca "Logs de errores" o "Error log". También puedes verlos desde tu cliente FTP en la carpeta var/log/ o logs/ de tu plan de hosting. Busca archivos como error.log o php_error.log.

¿Qué hago si no puedo acceder ni al back office?

Si el error 500 te bloquea el acceso al panel de administración, usa las soluciones manuales desde FTP o el administrador de archivos de tu hosting. Los pasos 1, 3 y 4 son tus mejores aliados.

¿Debo contratar a un profesional?

Si después de seguir todos estos pasos tu tienda online sigue sin funcionar, puede haber un problema más profundo (como un ataque de malware, un error en la base de datos o una configuración de servidor muy específica). En ese caso, un técnico especializado en PrestaShop te ahorrará tiempo y dolores de cabeza.

Conclusión: No entres en pánico, actúa con método

El error 500 y la página blanca son los fantasmas más comunes de PrestaShop, pero rara vez son mortales. La clave está en no tomar decisiones al azar. Sigue el orden lógico que te hemos dado:

Activa el modo debug para ver el error real.
Aumenta la memoria si es necesario.
Desactiva módulos y temas para aislar el problema.
Regenera el .htaccess y revisa permisos.
Restaura archivos de configuración si todo lo demás falla.

Con un poco de paciencia y siguiendo estos pasos, tu tienda online volverá a estar operativa. Y recuerda: siempre es buena práctica tener copias de seguridad periódicas de tu PrestaShop (archivos y base de datos). ¡Así podrás restaurar en minutos si algo grave ocurre!

[INFO] Si tu hosting usa Syspanel, recuerda que el puerto de acceso es el 2106. Allí encontrarás herramientas para gestionar archivos, bases de datos y logs de error.