AI Skill 大全

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 开发客户端应用的技术人员

使用步骤

  1. 安装 @clerk/react 依赖,并在 .env 中配置 VITE_CLERK_PUBLISHABLE_KEY 环境变量
  2. 在应用入口文件(如 main.tsx)使用 ClerkProvider 包裹根组件 App
  3. 使用 useAuth 钩子创建 ProtectedRoute 路由保护组件,严格检查 isLoaded 与 isSignedIn 状态
  4. 在受保护的页面或组件中调用 getToken 获取会话 Token 并发起带鉴权头的 API 请求

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
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
  • 读取用户主动提供的内容

同类 Skill