用途:自主配置、验证并排查 Clerk 会话处理、JWT 校验与令牌管理,适用于会话验证失败、JWT 校验错误、令牌过期、多会话冲突、自定义声明配置、会话刷新问题、认证中间件设置与会话安全审计。
主要资源:scripts/configure-sessions.sh 会话配置助手;scripts/setup-jwt.sh JWT 模板设置与校验;scripts/test-sessions.sh 会话测试与验证;templates 下提供会话配置、JWT 校验中间件、自定义声明、TypeScript 类型定义;examples 下提供多会话管理、会话刷新与调试工具。
使用方式:运行 ./scripts/configure-sessions.sh 交互配置会话寿命、多会话模式、刷新策略、Cookie 安全属性;用 ./scripts/setup-jwt.sh <template-name> 创建或更新 JWT 模板(default、hasura、supabase、custom);用 ./scripts/test-sessions.sh <test-type> 测试基本会话、JWT 签名、自定义声明、多会话、刷新和过期处理。后端可用 auth() 读取 userId、sessionId、sessionClaims,或用 verifyToken 手动校验;前端可用 useAuth、useSession 访问会话,并用 session.touch() 延长会话。
适用框架:Next.js(App Router、Pages Router)、React、Express、Fastify、Remix;Clerk SDK 版本为 @clerk/nextjs 5+、@clerk/backend 1+。
限制:具体收费、价格、平台与效果资料未提供;代码示例中的密钥均为占位符,务必使用环境变量,勿将令牌存入 localStorage。