cloudflare/vinext

Bot/crawler detection does not block fallback HTML on prerender

Fermée

#1 543 ouverte le 22 mai 2026

Voir sur GitHubGuide contributeur
 (0 commentaire) (0 réaction) (0 personne assignée)TypeScript (384 forks)github user discovery
adapter-api-e2ehelp wanted

Métriques du dépôt

Stars
 (8 625 étoiles)
Métriques de merge PR
 (Merge moyen 1j 1h) (462 PRs mergées en 30 j)

Description

This issue was created by an agent analysing CI failures from the Next.js Deploy Suite (vinext main vs Next.js v16.2.6, 2026-05-22).

Problem

When fallback: true static params encounter a crawler bot user-agent, Next.js renders the page synchronously instead of serving the fallback shell. vinext serves the fallback HTML containing Loading... to crawlers, which is bad for SEO.

Expected substring: not "Loading..."; received fallback shell

Estimated Impact

~1 test failures across the deploy suite.

Affected Test Suites

  • test/e2e/prerender-crawler.test.ts

Recommendation

  1. Reproduce first in vinext's own test suite. Request a fallback: true page with a Googlebot UA and assert the body does not contain the fallback text.

  2. Switch to synchronous render for known crawler UAs. When the UA matches the Next.js bot list and the page would otherwise serve a fallback shell, render synchronously instead.

Part of #1328.

Guide contributeur

Direction de recherche
Reproduisez le test en echec en demandant une page avec `fallback: true` en utilisant un user agent Googlebot et affirmez que le corps de la reponse ne contient pas le texte de repli. Ensuite, modifiez la logique de prerender pour detecter les user agents des robots et rendre la page de maniere synchrone au lieu de fournir le shell de repli.
Stack technique
typescriptreactnextjsvite
Domaine
backend
Type d'issue
Bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-2 jours
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
JavaScriptNext.js
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
45