Clerk身份验证集成指南：Next.js App Router、中间件保护与服务器组件完整设置
clerk-auth by sickn33/antigravity-awesome-skills
安装命令
npx skills add https://github.com/sickn33/antigravity-awesome-skills --skill clerk-auth🇨🇳中文介绍
Clerk 身份验证
模式
Next.js App Router 设置
适用于 Next.js 14/15 App Router 的完整 Clerk 设置。
包含 ClerkProvider、环境变量以及基本的登录/注册组件。
关键组件：
- ClerkProvider：包装应用以提供身份验证上下文
- , ：预构建的身份验证表单
- ：包含会话管理的用户菜单
中间件路由保护
使用 clerkMiddleware 和 createRouteMatcher 保护路由。
最佳实践：
- 在项目根目录创建单个 middleware.ts 文件
- 使用 createRouteMatcher 进行路由分组
- 使用 auth.protect() 进行显式保护
- 将所有身份验证逻辑集中在中间件中
服务器组件身份验证
在服务器组件中使用 auth() 和 currentUser() 访问身份验证状态。
关键函数：
- auth()：返回 userId、sessionId、orgId、claims
- currentUser()：返回完整的 User 对象
- 两者都需要配置 clerkMiddleware
⚠️ 注意事项
| 问题 | 严重性 | 解决方案 |
|---|---|---|
| 问题 | 严重 | 查看文档 |
| 问题 | 高 | 查看文档 |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
