SSR、Streaming 与部署

TanStack Start 提供全文档 SSR、流式渲染和可移植的 server output。

全文档 SSR

Start 可在服务端渲染完整 HTML 文档,再在客户端水合为交互式应用。收益包括:

  • 首屏更快
  • SEO 更友好
  • loader 数据可随 HTML 发送
  • 保留 TanStack Router 客户端导航体验

Streaming

Streaming 允许服务端先发送已经准备好的 UI,慢数据通过 Suspense 边界后续补齐。适合 dashboard 多数据块、详情页推荐模块、登录态与公共内容混合页面。

设计建议:关键内容尽快返回,慢数据放入局部 Suspense。

构建产物

.output/
├── public/
└── server/

实际结构取决于版本、构建工具和部署 preset。

部署目标

平台关注点
Node server最直接,适合自托管 / Docker
Vercel / Netlifyserverless preset、冷启动
Cloudflare WorkersEdge runtime、Node API 兼容性
Railway / Fly.io数据库区域、环境变量、长连接

部署前确认数据库驱动、文件系统、Web Crypto、Streaming、环境变量读取是否兼容。

生产检查清单

  • 锁定 Start / Router 版本
  • Server Functions 加输入验证
  • 写操作启用 CSRF / Origin 检查
  • 测试 SSR、客户端导航、刷新和深层路由直达
  • 验证目标平台的 streaming 行为

下一步