用途:指导把现有认证系统迁移到 Clerk,覆盖 Auth0、Firebase Auth、Supabase Auth、NextAuth 及自建认证。
主要能力:从原提供商导出用户(如 Auth0 Management API 的 curl 导出、NextAuth+Prisma 的导出脚本);用 @clerk/backend 的 createClerkClient 批量导入用户,支持 skipPasswordRequirement 让用户首次登录时设置密码,并带 100ms 延迟以遵守限流;把数据库中的旧认证 ID 映射为 Clerk ID,同时保留 legacyAuthId 以便回滚;给出 NextAuth 到 Clerk 的服务端 auth()、客户端 useUser()、clerkMiddleware 与 createRouteMatcher 替换示例;提供并行运行桥接(先试 Clerk,再回退旧系统);迁移验证脚本统计已映射与未映射用户;以及卸载旧包、删除旧认证文件与列的清理清单。
使用方式:需具备原提供商管理员/导出权限、Clerk 账号与 API 密钥、干净工作区的 Git 仓库,并规划迁移周期(建议 2-4 周)。按导出、导入、更新数据库引用、替换认证代码、可选并行运行、验证后清理的顺序执行。
限制:密码为哈希值无法迁移,需用户重设;OAuth 社交登录令牌不可转移,用户需在首次 Clerk 登录时重新关联;导入可能遇到重复邮箱、脏数据邮箱格式错误与限流,需跳过/合并、清洗校验并加延迟。资料未提供具体收费、价格与平台支持范围。