SuperAPI AI 工具集

clerk-prod-checklist

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

该技能用于在部署前、审查生产配置或审计 Clerk 集成时,逐项确认集成是否达到生产就绪状态。

用途:面向使用 Clerk 进行身份认证的项目,在正式上线前检查环境配置、安全加固、监控、错误处理与性能等环节,并提供自动化校验思路。

主要能力: 一、环境配置检查:确认使用 pk_live_ 与 sk_live_ 密钥、.env.local 已加入 .gitignore、CLERK_WEBHOOK_SECRET 已设置、生产域名已在 Clerk Dashboard 配置、登录/注册 URL 已通过 NEXT_PUBLIC_CLERK_SIGN_IN_URL 等变量设置。 二、校验脚本:以 scripts/prod-readiness.ts 检查发布密钥是否以 pk_live_ 开头、密钥是否以 sk_live_ 开头、后端 API 连通性、Webhook 密钥、middleware.ts 是否存在,并输出 PASS/FAIL 与就绪结论。运行方式为:npx tsx scripts/prod-readiness.ts。 三、安全清单:中间件保护路由、API 路由校验 userId 并返回 401、使用 svix 校验 Webhook 签名、CORS 仅允许生产域名、敏感端点限流(如 @upstash/ratelimit)、配置 CSP 并加入 Clerk 域名、避免密钥暴露到客户端。 四、监控与错误处理:健康检查端点、Sentry 错误追踪、认证事件日志、Webhook 失败告警与重试幂等、自定义错误页与会话过期提示;提供 app/error.tsx 全局错误边界示例,结合 useAuth 判断登录状态。 五、性能与 CI:中间件匹配规则排除静态资源、React.cache() 缓存用户数据、动态加载认证组件、Edge Runtime;可在 GitHub Actions 部署前运行校验脚本作为门禁。

适用场景:Clerk 集成已完成开发、准备部署或做上线前审计的项目。

限制:资料未说明具体价格、平台可用性或效果保证;脚本用到的依赖(如 @clerk/backend、tsx、svix)需自行按项目情况安装。官方文档原文暂未提供。