clerk-auth

Clerk Auth - Next.js 身份验证专家模式

技能概述

Clerk Auth 提供在 Next.js 应用中集成 Clerk 身份验证的专家级模式和实践，涵盖 App Router 配置、中间件路由保护、服务端组件认证、组织管理和 Webhook 处理。

适用场景

Next.js 14/15 应用集成 Clerk

需要在使用 App Router 的新版 Next.js 项目中快速实现完整的用户登录、注册和会话管理功能。

服务端组件获取用户信息

需要在 React Server Components 中安全访问当前用户的身份、组织权限和会话状态。

企业级组织权限管理

需要为 SaaS 或企业应用实现多租户组织结构，包括成员管理、权限控制和组织同步。

核心功能

Next.js App Router 快速集成

提供开箱即用的 ClerkProvider 配置、环境变量设置和预构建的 SignIn/SignUp 组件，无需手动处理复杂的 OAuth 流程。

中间件路由保护

通过 clerkMiddleware 和 createRouteMatcher 实现声明式的路由保护，支持路由分组和细粒度的访问控制，将所有认证逻辑集中管理。

服务端身份验证

在 Server Components 中使用 auth() 和 currentUser() 函数直接获取 userId、sessionId、orgId 等认证信息，无需客户端请求。

组织与 Webhook 管理

支持 Clerk Organizations 功能处理多租户场景，提供 Webhook 事件处理和用户同步到外部数据库的模式。

常见问题

Clerk 适合什么类型的项目？

Clerk 特别适合需要快速实现现代身份验证的 Web 应用，尤其是 Next.js、React 和 Vite 项目。对于需要组织管理、SSO、多因素认证等企业功能的 SaaS 应用尤其适用。

Clerk 和 NextAuth 有什么区别？

Clerk 是托管的身份验证服务，提供完整的 UI 组件和用户管理后台，无需自建数据库存储用户信息。NextAuth 是开源库，需要自己管理用户数据库和认证流程。Clerk 更适合快速上线，NextAuth 更适合需要完全控制的场景。

如何在服务端获取 Clerk 用户信息？

在配置了 clerkMiddleware 后，在 Server Component 中使用 await auth() 获取基础认证信息（userId、sessionId 等），或使用 await currentUser() 获取完整的 User 对象。这些函数必须在服务端组件中调用。

Clerk 免费版有什么限制？

Clerk 免费版支持最多 5,000 月活用户（MAU），包含基础认证功能和有限的组织管理功能。付费版解锁更多 MAU、高级组织功能、SSO 和审计日志。