用途:为 TanStack React Start(基于 Vinxi)项目提供 @clerk/tanstack-react-start 的认证集成模式,覆盖路由守卫、服务端函数、loader 与 Vinxi 服务端中间件四类任务。
主要能力:按任务提供参考文档——用 beforeLoad 保护路由(references/router-guards.md)、在 createServerFn 中使用 auth()(references/server-functions.md)、向 loader 传递认证上下文(references/loaders.md)、配置 Vinxi 与 clerkMiddleware(references/vinxi-server.md)。
使用方式:安装 npm install @clerk/tanstack-react-start;在 .env 配置 CLERK_PUBLISHABLE_KEY 与 CLERK_SECRET_KEY;在 src/start.ts 的 createStart 中把 clerkMiddleware() 加入 requestMiddleware;在 src/routes/__root.tsx 用 <ClerkProvider> 包裹。认证分两层:服务端层用 createServerFn + auth(),路由层用 beforeLoad 并在未认证时 throw redirect。客户端使用 useAuth、useUser 等 React hooks。
适用场景:需要为 TanStack Start 应用添加登录保护、服务端鉴权与路由重定向的开发者。
限制与注意:auth() 返回空通常因缺少 clerkMiddleware;重定向必须用 throw redirect 而非 return;服务端导入须用 @clerk/tanstack-react-start/server;loader 需从 beforeLoad 返回 userId 并通过 context 访问;忘记在根组件包裹 ClerkProvider 会导致失败。资料未提供收费、价格与平台支持等细节。