SSR、Streaming 与部署
TanStack Start 提供全文档 SSR、流式渲染和可移植的 server output。
全文档 SSR
Start 可在服务端渲染完整 HTML 文档,再在客户端水合为交互式应用。收益包括:
- 首屏更快
- SEO 更友好
- loader 数据可随 HTML 发送
- 保留 TanStack Router 客户端导航体验
Streaming
Streaming 允许服务端先发送已经准备好的 UI,慢数据通过 Suspense 边界后续补齐。适合 dashboard 多数据块、详情页推荐模块、登录态与公共内容混合页面。
设计建议:关键内容尽快返回,慢数据放入局部 Suspense。
构建产物
实际结构取决于版本、构建工具和部署 preset。
部署目标
部署前确认数据库驱动、文件系统、Web Crypto、Streaming、环境变量读取是否兼容。
生产检查清单
- 锁定 Start / Router 版本
- Server Functions 加输入验证
- 写操作启用 CSRF / Origin 检查
- 测试 SSR、客户端导航、刷新和深层路由直达
- 验证目标平台的 streaming 行为