SuperAPI AI 工具集

clerk-auth

前端与建站

查看项目

更新于 10-16 03:41

技能介绍

用途:为 Clerk 与 Next.js、Convex 后端提供认证集成模式,覆盖用户认证、会话管理、JWT 模板与 Webhook 处理。

主要能力:Next.js 中间件路由保护(clerkMiddleware、createRouteMatcher,Webhook 路由需设为公开);环境变量配置(NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY、CLERK_SECRET_KEY、登录注册 URL,需在 Vercel 与本地同时设置);Convex 集成(在 Clerk 面板创建名为 convex 的 JWT 模板,模板名大小写敏感且须与 convex/auth.config.ts 匹配,后端用 ctx.auth.getUserIdentity() 获取身份);Webhook 处理(用 svix 校验签名,处理 user.created、user.updated、user.deleted 事件)。

使用方式:按资料中的代码配置中间件、环境变量、JWT 模板、auth.config.ts 与 Webhook 路由;服务端组件用 currentUser(),客户端组件用 useUser(),路由处理器用 auth() 保护 API。

适用场景:Next.js 应用接入 Clerk 登录注册,并与 Convex 后端共享用户身份、同步用户数据。

限制与注意:资料未提供收费、价格与平台支持范围信息。常见问题包括未认证错误(检查 JWT 模板名、CLERK_JWT_ISSUER_DOMAIN、中间件是否拦截认证路由)、Webhook 失败(检查 CLERK_WEBHOOK_SECRET、使用规范域名、公开路由)、会话不持久(检查 Cookie、域名配置与生产环境 HTTPS)。建议通过 Webhook 同步用户、以 Clerk ID 作外键、保持 JWT 模板最小化。