用途:在实现、升级或调试 Clerk 的身份验证、授权、Organizations、Billing、SDK、组件或部署架构时使用本指南。先阅读迁移说明,再打开与工作匹配的主题参考。
主要能力:提供分类参考索引,覆盖架构与部署(Account Portal、FAPI、cookie、handshake、环境、路由、Astro、Next.js、Dashboard 角色、Platform API)、认证与会话(因素、SSO、OAuth/OIDC、passkey、待定会话、重新验证、JWT 声明、限制)、Billing、组件、Core 3 迁移、定制、前端资源、Go/JavaScript/Python 后端 SDK、集成与 Webhook、组织与企业等。
必要用法与变更要点:从自定义流程迁移到 Core 3 时使用命名因素方法和显式 finalize(),不要照搬旧的 attemptFirstFactor() 或 createdSessionId 激活;请求认证使用 authenticateRequest() 并检查 isAuthenticated(isSignedIn 已弃用);Python 5.x 起生成 schema 可能不兼容,需固定精确版本;Go v2 要求 Go 1.24+;<SignOutButton> 直接接收 redirectUrl 和 sessionId;CLERK_JS_URL 替代已弃用的 CLERK_JS;外观变量、sessions.verifySession()、企业端点等有多项重命名或迁移。
适用场景:Clerk 认证接入、升级、多框架集成、企业组织授权、计费与部署排错。
限制:资料以主题索引和迁移要点为主,未提供完整定价、支持平台或具体效果说明;部分细节需查阅对应主题参考。