用途:为使用 Clerk 认证的项目搭建高效的本地开发工作流,隔离测试数据与生产数据,并支持本地测试认证。
主要能力:配置 Clerk 开发实例(使用 pk_test_ / sk_test_ 测试密钥,可选 CLERK_DEBUG=true 开启调试日志);通过脚本批量创建测试用户;配置热重载并处理 Clerk SDK 打包;提供开发脚本(dev、dev:https、dev:seed、dev:tunnel、dev:webhook);为单元测试提供模拟认证辅助函数,并给出 Playwright 端到端认证夹具示例。
使用方式:需先完成 Clerk SDK 安装并创建开发实例,具备 Node.js 环境。在 .env.local 中填入测试密钥;用 npx tsx scripts/seed-test-users.ts 播种测试用户;部分 Clerk 功能需 HTTPS,可运行 npx next dev --experimental-https;测试中通过 mockClerkAuth 模拟 auth、currentUser 与 clerkMiddleware。
适用场景:本地开发与调试 Clerk 认证、单元测试与 E2E 测试中的认证模拟、需要热重载的 Next.js 项目。
限制:资料未提供具体收费、价格、平台支持范围及效果数据;示例基于 Next.js 与 Vitest,其他框架需自行适配。