Start: prerender forces trailing slashes, causing unnecessary redirects with trailingSlash: "never"
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
- #8916 của @okxint — đã đóng, không merge
Đánh giá
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 72/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- node.js, react, typescript, vite
- Lĩnh vực
- backend, performance
Hướng nghiên cứu
Start with @tanstack/start-plugin-core/src/prerender.ts, where the issue says the preview fetch URL is built using withTrailingSlash and withBase; trace how the trailing slash policy and base path reach that call. Use the linked reproducer’s npm ci and npm run build, then inspect its [preview-request] output. Done when explicit slashless paths with trailingSlash: 'never' are requested without the extra 307 redirect.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Which project does this relate to?
Start
Describe the bug
When the router uses trailingSlash: 'never', prerendering still appends a trailing
slash to each requested page URL. The router then returns a 307 redirect to the
slashless URL, and prerender follows it. This adds an unnecessary request for every
non-root page.
This happens with an explicit list of unique, slashless paths, with both
autoStaticPathsDiscovery and crawlLinks disabled. It reproduces with the default
Node preview server, without Cloudflare or any other adapter.
Complete minimal reproducer
https://github.com/R4ULtv/tanstack-start-prerender-trailing-slash
Steps to reproduce
- Clone the reproduction repository.
- Run
npm ci. - Run
npm run build. - Inspect the
[preview-request]lines in the output.
The reproduction has one dynamic route (/page/$id) and three explicit paths:
/page/1, /page/2, and /page/3. All input paths are slashless.
For each path the output shows:
[prerender] Crawling: /page/1
[preview-request] GET /page/1/ -> 307 Location: /page/1
[preview-request] GET /page/1 -> 200
The build succeeds, but each page requires two requests. The reproduction's Vite
plugin only logs the preview requests and response status/Location header; it does
not modify them. Setting PAGE_COUNT to 1 is sufficient to reproduce the issue.
Expected behavior
With trailingSlash: 'never', prerender should request slashless URLs directly,
avoiding the redirect for each page. URL normalization should account for the
configured trailing-slash policy and base path.
Platform
@tanstack/react-start: 1.169.4@tanstack/react-router: 1.170.46@tanstack/start-plugin-core(transitive): 1.171.55- React / React DOM: 19.3.1
- Vite: 8.3.5
- Node.js: 24.22.2
- OS: macOS (Apple Silicon)
- Adapter: default Node preview server
Additional context
In @tanstack/start-plugin-core/src/prerender.ts, the URL passed to fetch is
constructed with:
withTrailingSlash(withBase(page.path, routerBasePath))
This forces the slash even though the provided page path is already canonical.
The reproduction also contains an optional npm run benchmark that measures
increasing page counts, with four alternating-order runs per variant. It compares
current behavior with a preview-only rewrite that avoids the redirect, checks
request counts and generated output, and produces a self-contained HTML report
with the raw measurements. These are synthetic local Node results at concurrency
1; the percentage improvement is workload-specific and excludes deployment.
Recorded benchmark artifacts:
- Self-contained HTML report
- Raw measurements and verification metadata (JSON)
- Individual measured runs (CSV)
I mentioned this separately in #8483, which primarily concerns CPU parallelism.
This report isolates the redirect behavior independently of concurrency.
Related: #6978 / #7070 address duplicate discovered paths. This report concerns
additional HTTP requests for explicit, unique paths with discovery/crawling
disabled, so normalizing discovered paths alone would not resolve it.
Prepared with AI assistance. The reproduction and benchmark builds were executed and verified locally.
- Ngôn ngữ chính
- TypeScript
- Star
- 15.3k
- Fork
- 1.9k
- Merge trung bình
- 1 ngày 5 giờ
- Pull request đã merge (30 ngày)
- 46
Chuẩn bị môi trường
Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của TanStack/router
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Masked navigation drops the first character of the hash each time (__tempLocation hash missing '#')Có thể đã có người làm @hassanabrar202 đã nhận 8 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày
-
router-generator: lazy-load Prettier (costs ~300–450ms per build even when formatting is off)Có thể đã có người làm @Sheraff đã nhận 27 ngày trước. Đang mởpackage: router-generator performance
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
Maintainer thường phản hồi trong vòng 1 ngày
-
router-generator: sibling `physical()` subtrees in a virtual route config generate duplicate identifiersCó thể đã có người làm @Sheraff đã nhận 27 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Maintainer thường phản hồi trong vòng 1 ngày
-
docs(router): clarify static title fallback in SPA modeCó thể đã có người làm @Rohan-Dedhia đã nhận 17 ngày trước. Đang mở
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 62/100
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của TanStack/router
Issue tương tự
-
[BUG]: Shared links drop the configured basePath on GitHub PagesCó thể đã có người làm @anshulchikhale30-p đã nhận hôm nay. Đang mởbug
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
StabilityNexus/IdentityTokens-EVM-Frontend#182 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Add: GTrekkerĐang mởcheck:passed streams:add
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
Koenkk/zigbee-herdsman-converters#13900 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area: ui Bug Payload OSS
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
payloadcms/payload#19839 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
jeanibarz/knowledge-base-mcp-server#1291 ·
Maintainer thường phản hồi trong vòng 1 ngày