故障排查

Webhook 未交付 Pro

现象：付款成功，但没有 GitHub 邀请 / 确认邮件。

1. 查看 Creem Dashboard → Webhooks 投递日志
2. 核对 CREEM_WEBHOOK_SECRET
3. 确认 /api/payments/creem/webhook 公网可达
4. 确认 GITHUB_TOKEN 可邀请目标仓库 collaborator
5. 确认买家 GitHub 身份可用于邀请

无法进入管理后台

1. 确认 user.role = 'admin'
2. 检查 admin-guard.tsx
3. 重新登录刷新会话

邮件发不出去

1. 检查 RESEND_API_KEY / RESEND_FROM_EMAIL
2. 查看 Resend 日志与域名验证
3. 开发环境发件人可能是 onboarding@resend.dev

没有 Google 登录按钮

仅当 同时 配置 AUTH_GOOGLE_ID 与 AUTH_GOOGLE_SECRET 时才会显示。

SEO / Sitemap

1. robots.txt 的 Sitemap 必须指向本域
2. 英文 canonical 使用 as-needed（无 /en 前缀）
3. 文档/博客变更后重新构建以刷新生成物