React单页应用身份认证集成
为基于 Vite 或 CRA 的 React SPA 接入 Clerk SDK,提供路由守卫、状态钩子与鉴权请求代码模板。
功能与用途
该能力专为 React 单页应用(SPA)设计,基于 @clerk/react 官方 SDK,提供从根组件 ClerkProvider 配置、环境变量读取,到 useAuth / useUser 状态判断与路由守卫(ProtectedRoute)的一整套开发范式。它帮助前端开发者正确处理客户端加载态保护(isLoaded)、JWT 令牌获取以及与 React Router v6/v7 的路由鉴权对接,规避常见的白屏和未授权状态误判问题。
适用场景
- SPA认证初始化与状态监听:在Vite或CRA入口挂载ClerkProvider,用useAuth与useUser捕获登录态并安全处理加载中白屏。
- React Router路由守卫拦截:结合React Router v6/v7编写ProtectedRoute,对未授权访问自动重定向至登录页。
- 后端API调用鉴权集成:通过useAuth获取会话JWT Token,在HTTP请求头中注入Authorization Bearer令牌。
适用人群
- React 前端开发工程师
- 全栈独立开发者
- 使用 Vite 开发客户端应用的技术人员
使用步骤
- 安装 @clerk/react 依赖,并在 .env 中配置 VITE_CLERK_PUBLISHABLE_KEY 环境变量
- 在应用入口文件(如 main.tsx)使用 ClerkProvider 包裹根组件 App
- 使用 useAuth 钩子创建 ProtectedRoute 路由保护组件,严格检查 isLoaded 与 isSignedIn 状态
- 在受保护的页面或组件中调用 getToken 获取会话 Token 并发起带鉴权头的 API 请求
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
React SPA auth patterns with @clerk/react for Vite/CRA - ClerkProvider
依赖与权限
- VITE_CLERK_PUBLISHABLE_KEY
- PUBLISHABLE_KEY
- 读取用户主动提供的内容