用途:为支付与认证集成(如 Stripe、Clerk)提供计费与安全最佳实践,核心原则是“配置不等于现实,验证必须主动而非被动”。该技能源自三个生产事故的教训,指出代码审查只能发现代码缺陷,无法发现配置缺陷。
主要能力:1)环境变量卫生,读取时始终 trim,避免尾部空白导致“Invalid character in header”,并在使用前用正则校验 API Key 格式,如 /^sk_(test|live)_[a-zA-Z0-9]+$/。2)Webhook URL 验证,Stripe 的 POST 请求不跟随重定向,若 URL 返回 3xx 会静默失败,需用 curl -s -o /dev/null -w "%{http_code}" -I -X POST 检查,必须返回 4xx 或 5xx,并使用规范域名。3)跨部署一致性,Vercel 与 Convex 等分离架构需在两个平台都设置环境变量,可用 npx convex env set --prod KEY value,并对比 vercel env ls 与 npx convex env list --prod。4)Stripe 参数约束,customer_creation 仅适用于 payment、setup 模式,subscription_data 仅适用于 subscription 模式,误用会在结账时报错而非编译期。
使用方式:部署前按清单检查环境变量是否 trim、API Key 格式是否校验、Webhook URL 是否非 3xx、Vercel 与 Convex 配置是否一致、签名验证是否启用、错误处理是否返回 200 以防 Stripe 无限重试。调试时采用 OODA-V 流程:观察请求是否到达服务器,若无日志则判断为网络或重定向问题,用 curl -I 检查 Webhook URL,修复配置后重发事件并观察 pending_webhooks 是否减少。
适用场景:Stripe/Clerk/认证集成搭建、支付问题调试、Webhook 配置、跨平台环境变量管理。
限制:资料未提供具体安装命令、收费信息、支持平台范围及完整脚本用法细节,部分内容需结合官方文档确认。