Errores comunes en PrestaShop: 500, 404, pantalla blanca y cómo solucionarlos

Introducción: ¿Por qué aparecen estos errores en PrestaShop?

Si tienes una tienda online con PrestaShop, es muy probable que en algún momento te hayas encontrado con alguno de estos tres mensajes de error: el temido error 500, la pantalla blanca sin ningún texto, o el error 404. No te preocupes, son problemas comunes y, en la mayoría de los casos, tienen solución. En esta guía completa te explicaremos paso a paso cómo solucionar errores PrestaShop, centrándonos en los más frecuentes. Vamos a desglosar cada error, sus causas y las soluciones prácticas que puedes aplicar incluso si no eres un experto técnico.

[INFO] Este artículo está pensado para usuarios de hosting compartido, VPS o servidores dedicados. Si usas un hosting gestionado, contacta primero con tu proveedor de soporte.

Error 500 PrestaShop: Causas y soluciones

El error 500 PrestaShop es un error interno del servidor. Significa que algo salió mal en el servidor web al intentar cargar tu tienda, pero no da detalles específicos. Es como si el servidor dijera "no sé qué pasó, pero algo falló". Las causas pueden ser varias: desde un archivo .htaccess corrupto hasta un módulo incompatible o un límite de memoria excedido.

1. Activar el modo debug de PrestaShop

Lo primero que debes hacer para solucionar errores PrestaShop es obtener más información. PrestaShop tiene un modo debug que muestra el error real en lugar de la pantalla genérica.

Conéctate a tu servidor mediante FTP o el administrador 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 plano (como Notepad++ o Sublime Text).
Busca esta línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda los cambios y sube el archivo de nuevo al servidor.
Recarga tu tienda. Ahora verás un mensaje de error más detallado (por ejemplo, "Fatal error: Allowed memory size exhausted...").

[WARNING] No dejes el modo debug activado en una tienda en producción. Una vez que resuelvas el error, vuelve a poner false.

2. Aumentar el límite de memoria PHP

Uno de los errores más comunes es el límite de memoria insuficiente. Para solucionarlo:

Accede a Syspanel (tu panel de control, puerto 2106) y busca la sección de "PHP Settings" o "Configuración de PHP".
Busca el parámetro memory_limit y cámbialo a 256M o incluso 512M si tu hosting lo permite.
Guarda los cambios y reinicia el servicio web si es necesario.

Si no tienes acceso a Syspanel, puedes intentar crear un archivo php.ini en la raíz de PrestaShop con este contenido:

memory_limit = 256M
max_execution_time = 120
upload_max_filesize = 64M
post_max_size = 64M

3. Verificar el archivo .htaccess

Un archivo .htaccess corrupto o mal generado puede provocar el error 500. Sigue estos pasos:

Conéctate por FTP a la raíz de tu tienda.
Busca el archivo .htaccess (puede estar oculto, activa la opción "Mostrar archivos ocultos" en tu cliente FTP).
Renómbralo a .htaccess.old para desactivarlo temporalmente.
Recarga tu tienda. Si funciona, el problema está en el .htaccess.
Ve al panel de administración de PrestaShop > Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
Haz clic en "Guardar" (sin cambiar nada) para regenerar el .htaccess automáticamente.

4. Deshabilitar módulos problemáticos

A veces un módulo recién instalado o actualizado causa conflictos. Para probar:

Conéctate por FTP a la carpeta /modules de tu instalación.
Renombra la carpeta del módulo sospechoso añadiendo un sufijo, por ejemplo: micromodulo_old.
Recarga la tienda. Si el error desaparece, ese módulo es el culpable.
Desde el panel de administración, desinstálalo o busca una actualización.

[TIP] Si no sabes qué módulo puede ser, renombra todos los módulos excepto los esenciales (como ps_mainmenu, ps_searchbar, etc.) y ve probando de uno en uno.

Pantalla blanca PrestaShop: Cómo recuperar tu tienda

La pantalla blanca PrestaShop (también conocida como "white screen of death") es similar al error 500, pero sin ningún mensaje. Simplemente ves una página en blanco. Esto suele deberse a un error fatal de PHP que no se muestra.

1. Activar el modo debug (igual que antes)

Sigue los pasos del punto anterior para activar _PS_MODE_DEV_. Si ves un error concreto, podrás actuar directamente.

2. Comprobar los logs del servidor

Si el modo debug no muestra nada, revisa los logs del servidor:

En Syspanel (puerto 2106), busca la sección "Logs" o "Registros del servidor".
Busca archivos como error.log o php_error.log en la carpeta /var/log/ de tu servidor.
Si no tienes acceso, contacta con tu proveedor de hosting y pídele que te muestre los errores recientes.

3. Verificar los permisos de archivos y carpetas

Los permisos incorrectos pueden causar la pantalla blanca. Los valores correctos son:

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).

Puedes usar un cliente FTP para cambiarlos en masa: selecciona toda la carpeta de PrestaShop, haz clic derecho y elige "Cambiar permisos".

4. Aumentar el límite de memoria PHP (reiteramos)

Es tan común que merece repetirse: si tu tienda se queda en blanco al cargar páginas con muchos productos o módulos, probablemente necesites más memoria. Aplica el mismo método del punto anterior.

5. Desactivar la caché de PrestaShop desde la base de datos

Si no puedes acceder al panel de administración, desactiva la caché manualmente:

Accede a la base de datos de tu tienda mediante phpMyAdmin (desde Syspanel, puerto 2106, busca "phpMyAdmin").
Busca la tabla ps_configuration (el prefijo puede variar).
Localiza la fila donde name es PS_CACHE_ENABLED y cámbiala a 0.
También busca PS_SMARTY_CACHE_ENABLED y ponla a 0.

Esto obligará a PrestaShop a regenerar las plantillas sin usar caché.

Error 404 en PrestaShop: Página no encontrada

El error 404 aparece cuando una página no existe o la URL no es correcta. En PrestaShop, suele estar relacionado con la configuración de las URLs amigables o con enlaces rotos.

1. Regenerar el archivo .htaccess

Al igual que con el error 500, un .htaccess dañado puede provocar 404. Sigue los pasos del punto 3 de la sección del error 500.

2. Verificar la configuración de URLs amigables

Ve al panel de administración > Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
Asegúrate de que la opción "URLs amigables" esté activada.
En "Configuración de la URL de la tienda", verifica que la URL base sea correcta (sin barras al final).
Guarda los cambios.

3. Comprobar categorías y productos eliminados

Si has eliminado una categoría o producto, los enlaces antiguos seguirán dando 404. Puedes:

Crear una redirección 301 desde el panel de administración (Parámetros de la tienda > Tráfico y SEO > Redirecciones y 404).
Usar un módulo de redireccionamiento automático.
Instalar un plugin de SEO que gestione los 404.

4. Verificar el archivo robots.txt

Un robots.txt mal configurado puede bloquear el acceso a ciertas páginas. Asegúrate de que no incluya reglas como Disallow: / (a menos que quieras bloquear toda la tienda).

FAQ: Preguntas frecuentes sobre errores en PrestaShop

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

Las actualizaciones pueden dejar archivos incompatibles o módulos desactualizados. Siempre haz una copia de seguridad antes de actualizar. Si ya ocurrió, activa el modo debug para ver el error exacto y desactiva los módulos no esenciales.

¿La pantalla blanca puede deberse a un tema (template) defectuoso?

Sí, un tema mal codificado puede provocar la pantalla blanca. Prueba a cambiar temporalmente al tema predeterminado de PrestaShop (por ejemplo, "classic") renombrando la carpeta del tema actual en /themes/.

¿Cómo puedo evitar estos errores en el futuro?

Mantén PrestaShop, los módulos y el tema siempre actualizados.
Realiza copias de seguridad periódicas.
Instala un plugin de monitorización de errores.
No instales módulos de fuentes no fiables.
Aumenta los límites de PHP antes de que sea necesario.

¿Qué hago si no puedo acceder ni al panel de administración?

Usa FTP o el administrador de archivos de tu hosting para modificar archivos directamente. Activa el modo debug, desactiva módulos renombrando carpetas, o restaura una copia de seguridad de los archivos.

¿El error 404 afecta al SEO de mi tienda?

Sí, los errores 404 pueden perjudicar tu posicionamiento. Es importante redirigir las páginas eliminadas mediante redirecciones 301 y revisar periódicamente los enlaces rotos con herramientas como Google Search Console.

Conclusión: No te asustes, todo tiene solución

Los errores 500, pantalla blanca y 404 en PrestaShop son más comunes de lo que crees. La clave está en mantener la calma y seguir un proceso lógico: activar el modo debug, revisar los logs, comprobar el .htaccess, los permisos y los límites de PHP. Con esta guía, ya tienes las herramientas para solucionar errores PrestaShop por ti mismo. Si después de todo el problema persiste, no dudes en contactar con tu proveedor de hosting o con un especialista en PrestaShop. Recuerda que en Syspanel (puerto 2106) tienes acceso a herramientas como phpMyAdmin y logs que te facilitarán el diagnóstico.

[TIP] Guarda esta guía en tus favoritos. Cuando aparezca un error, sigue los pasos en orden y seguro que encuentras la solución.

¡Buena suerte con tu tienda!