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

⚠️ 易踩问题

问题	严重程度	解决方案
问题	严重	参阅文档
问题	高	参阅文档
问题	高	参阅文档
问题	高	参阅文档
问题	中	参阅文档
问题	中	参阅文档
问题	中	参阅文档
问题	中	参阅文档