Errores 500 y 404 en PrestaShop | Soluciones rápidas

Cuando gestionas una tienda online con PrestaShop, encontrarte con un error 500 o un error 404 puede ser frustrante. Estos errores no solo afectan la experiencia de usuario, sino que también pueden perjudicar tu posicionamiento SEO. En esta guía extensa, te explicaré paso a paso cómo solucionar errores comunes en PrestaShop, centrándonos en los dos más habituales: el error 500 (error interno del servidor) y el error 404 (página no encontrada). Al final, tendrás un conocimiento sólido de sysadmin básico para resolverlos por ti mismo.

[INFO] Esta guía está pensada para usuarios con conocimientos básicos de hosting. No necesitas ser un experto en Linux, pero te ayudará tener acceso a tu panel de control (como Syspanel, cPanel o similar).

¿Qué es el error 500 en PrestaShop?

El error 500 es un error genérico que indica que algo falló en el servidor, pero no da detalles específicos. En PrestaShop, suele deberse a problemas de permisos de archivos, archivos .htaccess corruptos, módulos conflictivos o falta de memoria PHP. Es como si el servidor te dijera: "Algo salió mal, pero no sé decirte exactamente qué".

Causas más frecuentes del error 500

Permisos incorrectos en archivos o carpetas (por ejemplo, archivos con permisos 777 que deberían ser 644).
Archivo .htaccess dañado o mal generado (muy común tras actualizaciones).
Módulo o tema incompatible (especialmente después de una actualización de PrestaShop).
Límite de memoria PHP excedido (tu tienda necesita más recursos de los que el servidor le asigna).
Problemas con el archivo settings.inc.php o con la base de datos.

Cómo solucionar el error 500 paso a paso

Sigue estos pasos en orden. No saltes ninguno, ya que el error 500 puede tener múltiples orígenes.

Paso 1: Activar el modo debug de PrestaShop

Para obtener más información sobre el error, activa el modo de depuración. Esto mostrará el mensaje de error real en lugar de la pantalla blanca.

Accede a tu servidor por FTP o mediante el administrador de archivos de Syspanel (puerto 2106).
Busca el archivo config/defines.inc.php en la raíz de tu PrestaShop.
Edítalo y cambia la línea:
define('_PS_MODE_DEV_', false); por define('_PS_MODE_DEV_', true);
Guarda el archivo y recarga tu tienda. Ahora verás un mensaje de error más detallado (por ejemplo, "Fatal error: Allowed memory size exhausted").

[WARNING] No olvides volver a poner false una vez resuelto el problema, o tu tienda mostrará errores a los visitantes.

Paso 2: Verificar permisos de archivos y carpetas

Los permisos incorrectos son una causa muy común del error 500. PrestaShop necesita permisos específicos para funcionar.

Archivos: deben tener permisos 644 (lectura y escritura para el propietario, solo lectura para el grupo y otros).
Carpetas: deben tener permisos 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y otros).

Puedes corregirlos desde tu panel de control (Syspanel) o mediante FTP. Por ejemplo, en Syspanel:

Ve a Archivos > Administrador de archivos.
Selecciona toda la carpeta de tu tienda.
Haz clic en Permisos y establece 755 para carpetas y 644 para archivos (muchos paneles tienen una opción "Corregir permisos").

Paso 3: Regenerar el archivo .htaccess

El archivo .htaccess de PrestaShop se regenera automáticamente desde el back office. Si está dañado, puede causar error 500.

Conéctate por FTP y renombra el archivo .htaccess a .htaccess_old (por si acaso).
Ve al back office de tu tienda: Parámetros de la tienda > Tráfico y SEO.
Haz clic en Guardar sin cambiar nada. Esto regenerará un nuevo .htaccess.
Si no puedes acceder al back office, crea un archivo .htaccess vacío con permisos 644 y luego intenta acceder de nuevo.

Paso 4: Deshabilitar módulos problemáticos

Si el error 500 apareció tras instalar o actualizar un módulo, ese módulo es el culpable.

Accede a tu servidor por FTP y ve a la carpeta /modules/.
Localiza la carpeta del módulo sospechoso (por ejemplo, si instalaste "supermodulo", busca la carpeta "supermodulo").
Renombra la carpeta agregando "_old" al final (ejemplo: supermodulo_old). Esto desactiva el módulo.
Recarga tu tienda. Si el error desaparece, ya sabes qué módulo causaba el problema.

[TIP] Si no sabes qué módulo es, puedes renombrar la carpeta /modules/ completa a /modules_old/ y luego crear una nueva carpeta vacía /modules/. Esto desactivará todos los módulos. Luego ve reactivándolos uno por uno desde el back office.

Paso 5: Aumentar el límite de memoria PHP

Si el error 500 muestra algo como "Allowed memory size of X bytes exhausted", necesitas aumentar la memoria PHP.

Desde el archivo php.ini (si tienes acceso): busca la línea memory_limit y cámbiala a memory_limit = 256M o 512M.
Desde el .htaccess: añade esta línea al final: php_value memory_limit 256M.
Desde Syspanel: ve a Ajustes > PHP y aumenta el límite de memoria (normalmente hay un campo específico).

Paso 6: Verificar el archivo settings.inc.php

Este archivo contiene la configuración de la base de datos. Si está corrupto o tiene permisos incorrectos, genera error 500.

Localiza config/settings.inc.php.
Asegúrate de que tenga permisos 644.
Ábrelo y verifica que los datos de conexión (servidor, usuario, contraseña, nombre de base de datos) sean correctos. Si no estás seguro, pide a tu hosting que te los verifique.

¿Qué es el error 404 en PrestaShop?

El error 404 significa "página no encontrada". En PrestaShop, suele ocurrir cuando la URL de un producto, categoría o página no coincide con ninguna ruta válida. Esto puede deberse a enlaces rotos, reglas de URL mal configuradas, o problemas con el archivo .htaccess.

Causas más frecuentes del error 404

URLs amigables mal configuradas (por ejemplo, después de activar o desactivar las URLs amigables sin regenerar el .htaccess).
Producto o categoría eliminada pero con enlaces antiguos en Google o en tu web.
Archivo .htaccess obsoleto o corrupto (sí, también causa 404).
Redirecciones incorrectas o duplicadas.
Problemas con el módulo de SEO o con la caché de URLs.

Cómo solucionar el error 404 paso a paso

Paso 1: Regenerar las URLs amigables

Este es el paso más común y efectivo.

Ve al back office: Parámetros de la tienda > Tráfico y SEO.
En la sección URLs amigables, asegúrate de que estén activadas.
Haz clic en Guardar para regenerar el archivo .htaccess y las reglas de URL.
Si el error persiste, desactiva las URLs amigables, guarda, y luego vuelve a activarlas.

Paso 2: Verificar el archivo .htaccess (de nuevo)

Al igual que con el error 500, un .htaccess dañado puede causar 404.

Renombra el .htaccess actual a .htaccess_old.
Regenera uno nuevo desde el back office (como en el paso anterior).
Si no puedes acceder al back office, crea un .htaccess básico con este contenido:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>

Guarda el archivo con permisos 644.

Paso 3: Comprobar enlaces rotos con herramientas externas

A veces el error 404 es porque tienes enlaces internos rotos (por ejemplo, un producto que ya no existe pero está enlazado desde una categoría).

Usa herramientas como Google Search Console o Screaming Frog para identificar páginas 404.
Desde el back office, ve a Catálogo > Productos y verifica que los productos enlazados existan.
Si encuentras URLs 404 que deberían redirigir, configura redirecciones 301 desde Parámetros de la tienda > Tráfico y SEO > Redirecciones.

Paso 4: Limpiar la caché de PrestaShop

La caché puede almacenar URLs antiguas que ya no son válidas.

Ve a Parámetros avanzados > Rendimiento.
Haz clic en Limpiar caché (tanto de Smarty como de la caché de combinación).
También puedes borrar manualmente la carpeta /var/cache/ desde FTP (excepto el archivo index.php).

Paso 5: Verificar el archivo robots.txt

Un robots.txt mal configurado puede bloquear páginas importantes, aunque esto no suele dar un 404 directo, sino que impide que Google las indexe. Asegúrate de que no tenga reglas que bloqueen tus URLs principales.

Consejos de sysadmin para prevenir estos errores

Como sysadmin, puedes tomar medidas para evitar que estos errores se repitan.

Mantén PrestaShop actualizado

Las actualizaciones corrigen bugs de seguridad y rendimiento. Siempre haz una copia de seguridad antes de actualizar.

Usa un buen hosting

Un hosting compartido barato puede causar errores 500 por falta de recursos. Considera un VPS o un hosting especializado en PrestaShop.

Monitorea tu tienda

Configura alertas para errores HTTP. Muchos paneles como Syspanel ofrecen monitoreo básico. También puedes usar servicios como UptimeRobot.

Haz copias de seguridad regulares

Antes de cualquier cambio (módulo, tema, actualización), haz una copia de seguridad de archivos y base de datos. En Syspanel, puedes hacerlo desde Copia de seguridad (puerto 2106).

[INFO] En Syspanel, las copias de seguridad se almacenan en /backup/ y puedes restaurarlas fácilmente desde el panel.

Preguntas frecuentes (FAQ)

¿Por qué veo un error 500 después de instalar un módulo?

Es muy probable que el módulo sea incompatible con tu versión de PrestaShop o que consuma demasiados recursos. Sigue el paso 4 de la sección del error 500 para deshabilitarlo.

¿El error 404 puede afectar mi SEO?

Sí, los errores 404 dañan la experiencia de usuario y pueden hacer que Google penalice tu sitio. Configura redirecciones 301 para las páginas que ya no existen.

¿Puedo solucionar estos errores sin acceso al back office?

Sí, usando FTP o el administrador de archivos de tu panel (Syspanel). Por ejemplo, puedes modificar el archivo defines.inc.php o renombrar carpetas de módulos directamente.

¿Qué hago si el error 500 persiste después de todos los pasos?

Prueba a restaurar una copia de seguridad anterior. Si no tienes, contacta con tu proveedor de hosting. Puede ser un problema de configuración del servidor (como PHP versiones incompatibles).

¿Cómo accedo a Syspanel para gestionar mi hosting?

Syspanel es el panel de control de tu hosting. Accede a través de https://tudominio:2106 (sustituye "tudominio" por tu dominio real). Usa tus credenciales de hosting.

Conclusión

Los errores 500 y 404 en PrestaShop son comunes, pero con un enfoque metódico puedes resolverlos sin necesidad de ser un experto en sysadmin. Recuerda siempre:

Activar el modo debug para obtener pistas.
Verificar permisos y el archivo .htaccess.
Deshabilitar módulos sospechosos.
Mantener copias de seguridad.

Con esta guía, ya tienes las herramientas para solucionar errores comunes en PrestaShop y mantener tu tienda funcionando sin problemas. Si el error persiste, no dudes en contactar con tu proveedor de hosting; ellos tienen acceso a los logs del servidor que pueden darte la respuesta definitiva.

[TIP] Guarda esta guía en favoritos. La próxima vez que veas un 500 o 404, sabrás exactamente qué hacer.