Solución de errores 404 en PrestaShop (guía para principiantes)
¿Te ha pasado que entras a tu tienda PrestaShop y, en lugar de ver un producto, te encuentras con un mensaje de error 404? No te preocupes, es uno de los problemas más comunes en tiendas online, especialmente cuando se empieza. Este error significa que la página que buscas no se encuentra en el servidor. Pero ojo: no siempre es culpa tuya. A veces es un ajuste de configuración, otras veces es un enlace roto o un problema con las reglas de reescritura de URL.
En esta guía para principiantes, vamos a desglosar paso a paso cómo solucionar el error 404 PrestaShop. Aprenderás desde lo más básico (regenerar el archivo .htaccess) hasta trucos más avanzados como revisar las URLs amigables PrestaShop. Todo explicado como si estuviera a tu lado, sin tecnicismos raros. ¡Vamos allá!
¿Qué es exactamente un error 404 en PrestaShop?
Un error 404 es la respuesta que da el servidor cuando no encuentra el archivo o la página que el navegador está solicitando. En PrestaShop, esto suele pasar por tres razones principales:
- URLs mal escritas: El enlace que usaste tiene un error tipográfico o ya no existe.
- Problemas con el archivo .htaccess: Este archivo es como el "director de tráfico" de tu web. Si está dañado o desactualizado, las direcciones no se traducen bien y todo acaba en 404.
- URLs amigables desactivadas o mal configuradas: PrestaShop, por defecto, puede generar URLs largas y con números. Si activas las URLs amigables (las que tienen palabras clave) y no configuras bien el sistema, el 404 aparece.
No te asustes. La mayoría de las veces se arregla en menos de 5 minutos.
Paso 1: Lo primero, regenera el archivo .htaccess de PrestaShop
El archivo .htaccess PrestaShop es el corazón de la redirección de URLs. Cuando mueves tu tienda, cambias de dominio o activas las URLs amigables, este archivo se debe actualizar. Si no lo haces, el servidor no sabe cómo interpretar las direcciones y te manda al 404.
Cómo regenerar el .htaccess desde el panel de administración
- Accede a tu back office de PrestaShop (normalmente en
tudominio.com/admin). - Ve al menú Configuración de la tienda → Parámetros generales.
- Busca la pestaña SEO y URLs.
- Dentro, verás una sección llamada Configurar URLs amigables.
- Justo debajo hay un botón que dice Guardar y otro que dice Regenerar archivo .htaccess. Haz clic en este último.
[TIP] Si no ves el botón, asegúrate de tener activada la opción "URLs amigables" (sí, aunque luego la desactivemos, este paso fuerza la regeneración). Después de hacer clic, PrestaShop crea un nuevo archivo .htaccess con las reglas correctas.
Si no puedes acceder al back office: regenera manualmente
A veces el error 404 te impide hasta entrar al administrador. No pasa nada, puedes hacerlo por FTP o desde el panel de control de tu hosting (como Syspanel, que recordemos se accede por el puerto 2106).
- Opción A (FTP): Conéctate a tu servidor, ve a la carpeta raíz de PrestaShop (donde están las carpetas
admin,modules,themes, etc.) y busca el archivo .htaccess. Si no existe, créalo. Si existe, renómbralo a.htaccess_old(por si acaso). Luego, desde el back office (si logras entrar) lo regeneras. - Opción B (Syspanel): Desde el panel de control de tu hosting (puerto 2106), busca el gestor de archivos y navega hasta la raíz de tu tienda. Allí puedes editar o eliminar el .htaccess. Luego, desde el back office, lo regeneras.
[WARNING] Nunca edites el .htaccess a mano si no sabes exactamente qué estás haciendo. Un error puede dejar tu tienda inaccesible. Mejor regenerarlo desde PrestaShop.
Paso 2: Revisa la configuración de URLs amigables
Las URLs amigables PrestaShop son esas direcciones limpias como /productos/zapatillas-rojas en lugar de /index.php?id_product=123. Son geniales para el SEO, pero si no se configuran bien, provocan errores 404.
Cómo activarlas correctamente
- En el back office, ve a Configuración de la tienda → Parámetros generales → SEO y URLs.
- Asegúrate de que la opción URLs amigables esté en Sí.
- Despliega la sección Configurar URLs amigables y haz clic en Guardar (esto regenera las reglas).
- Luego, vuelve a regenerar el .htaccess como vimos en el paso 1.
[INFO] Si tu servidor no soporta la reescritura de URLs (mod_rewrite de Apache), las URLs amigables no funcionarán. Pregunta a tu hosting si tienen activado este módulo. En la mayoría de los planes compartidos sí lo tienen.
Problema común: "No se puede escribir el archivo .htaccess"
Si al guardar te sale un error de permisos, significa que el archivo .htaccess no tiene permisos de escritura. Solución:
- Desde FTP o Syspanel, cambia los permisos del archivo .htaccess a 644 o 755 (dependiendo del servidor). Luego vuelve a intentar la regeneración.
- Si no existe, crea un archivo vacío llamado
.htaccesscon permisos 644 y luego repite el proceso.
Paso 3: Limpia la caché de PrestaShop
A veces el error 404 persiste porque PrestaShop guarda en caché las URLs antiguas. Al limpiar la caché, obligas al sistema a leer las nuevas reglas.
- En el back office, ve a Configuración avanzada → Rendimiento.
- En la sección Caché, haz clic en Borrar la caché (tanto la de Smarty como la de la tienda).
- También puedes ir a Parámetros generales → Mantenimiento y desactivar/activar la tienda para forzar un refresco completo.
[TIP] Si usas un plugin de caché externo (como Varnish o un CDN), también debes purgar su caché. Consulta la documentación de tu proveedor.
Paso 4: Verifica los enlaces en productos y categorías
A veces el error 404 no es global, sino que afecta solo a ciertas páginas. Esto suele pasar cuando:
- Eliminaste un producto o categoría: El enlace antiguo sigue indexado en Google o en tus redes sociales. Solución: usa redirecciones 301 desde el back office (en Configuración de la tienda → SEO y URLs → Redirecciones).
- Cambiaste la URL de un producto: Si modificaste la URL amigable de un producto, el enlace anterior deja de funcionar. PrestaShop no crea redirecciones automáticas, así que debes hacerlo manualmente.
- El enlace está mal escrito en el menú o en un módulo: Revisa los enlaces de tu menú principal, pies de página y módulos de terceros. A veces un simple espacio o carácter extraño genera un 404.
Cómo crear una redirección 301 en PrestaShop
- Ve a Configuración de la tienda → SEO y URLs → Redirecciones.
- Haz clic en Añadir nueva redirección.
- En "URL antigua", pon la dirección que da error 404 (sin el dominio, por ejemplo
/productos/zapatillas-viejas). - En "URL nueva", pon la dirección correcta (por ejemplo
/productos/zapatillas-nuevas). - Elige 301 Movido permanentemente y guarda.
[WARNING] No uses redirecciones 302 (temporal) a menos que sea un cambio momentáneo. Para SEO, siempre usa 301 cuando el cambio sea definitivo.
Paso 5: Revisa el servidor y los permisos de carpetas
A veces el error 404 PrestaShop no es culpa de PrestaShop, sino del servidor. Por ejemplo:
- El archivo .htaccess no se está leyendo: En algunos servidores (especialmente Nginx), el .htaccess no funciona. Necesitas configurar las reglas directamente en el archivo de configuración del servidor (nginx.conf). Si tu hosting usa Apache, asegúrate de que tenga habilitado
AllowOverride All. - Permisos incorrectos: La carpeta
rootde PrestaShop debe tener permisos 755, y los archivos 644. Si están en 777, el servidor puede bloquear la lectura por seguridad.
Cómo comprobar si el .htaccess se está leyendo
Crea un archivo de prueba llamado test.html en la raíz con cualquier texto. Luego, añade esta línea al .htaccess:
Redirect 301 /test.html https://www.google.com
Si al visitar tudominio.com/test.html te redirige a Google, el .htaccess funciona. Si no, contacta con tu hosting.
Paso 6: Desactiva temporalmente los módulos de SEO o redirecciones
Algunos módulos de SEO (como los que generan URLs canónicas o redirecciones automáticas) pueden entrar en conflicto con las reglas nativas de PrestaShop. Para probar:
- Ve a Módulos → Gestor de módulos.
- Busca módulos relacionados con SEO, URLs, redirecciones o caché.
- Desactívalos uno por uno y prueba si el error 404 desaparece.
[INFO] Si encuentras el módulo culpable, revisa su configuración o contacta al desarrollador. A veces solo necesitas actualizarlo.
Preguntas frecuentes (FAQ) sobre error 404 en PrestaShop
¿Por qué mi tienda PrestaShop da error 404 después de migrar a otro hosting?
Es muy común. Al migrar, las rutas absolutas cambian y el .htaccess queda desactualizado. Solución: regenera el .htaccess desde el back office y limpia la caché. Si no puedes acceder al back office, edita el archivo config/settings.inc.php y cambia las rutas manualmente (pide ayuda a tu hosting si no te sientes seguro).
¿El error 404 afecta al SEO de mi tienda?
Sí, y mucho. Google interpreta los 404 como páginas muertas. Si tienes muchos, tu posicionamiento baja. Además, los usuarios que encuentran un 404 suelen irse, aumentando la tasa de rebote. Por eso es crucial solucionarlos rápido y poner redirecciones 301.
¿Cómo evitar futuros errores 404 en PrestaShop?
- No cambies URLs de productos a menos que sea necesario. Si lo haces, crea una redirección 301 inmediatamente.
- Revisa tu sitemap.xml y envíalo a Google Search Console para que sepa qué páginas existen.
- Actualiza PrestaShop y sus módulos regularmente. Las versiones antiguas tienen bugs que generan 404.
- Haz copias de seguridad del .htaccess antes de cualquier modificación.
¿Qué hago si ni regenerando el .htaccess se soluciona el error 404?
Prueba a desactivar las URLs amigables temporalmente. Ve a SEO y URLs, pon "No" en URLs amigables, guarda y luego vuelve a activarlas. Esto fuerza una reescritura completa. Si sigue sin funcionar, el problema puede estar en el servidor (mod_rewrite desactivado) o en un módulo conflictivo. Contacta con el soporte técnico de tu hosting.
Conclusión: No temas al error 404, es parte del aprendizaje
Solucionar el error 404 PrestaShop es una de esas habilidades que todo dueño de tienda online debería dominar. Con estos pasos (regenerar .htaccess, configurar URLs amigables, limpiar caché y crear redirecciones) podrás resolver el 95% de los casos. Recuerda: la clave está en la paciencia y en ir paso a paso.
Si después de todo esto el error persiste, no dudes en pedir ayuda a tu hosting (Syspanel, puerto 2106) o a un desarrollador especializado. Pero confía en que, siguiendo esta guía, ya tienes las herramientas para enfrentarte al temido 404. ¡Tu tienda volverá a funcionar en minutos!
[TIP FINAL] Marca esta guía como favorita. Cada vez que hagas un cambio grande en tu tienda (migración, cambio de tema, actualización), repasa estos pasos. Te ahorrarás muchos dolores de cabeza.
