next/font 加载字体导致构建失败

Google OAuth 回调报 OAuthCallback 错误，检查：① GOOGLE_CLIENT_ID/SECRET 是否正确 ② NEXTAUTH_URL 是否与 Google Console 中的回调 URL 一致 ③ redirect URI 是否匹配 ④ 时钟同步问题。

Prisma 事务中 create 返回的 id 在 commit 前可能不可用。如果需要用 id 生成 slug，可以在事务内先 create 再 update slug，或用 cuid() 手动生成 id。注意 Prisma @default(cuid()) 在 create 时生成。

toast 和 router.push 冲突，因为 toast 的状态更新会中断 router.push 的 startTransition。解决：用 window.location.href 硬导航，或先 toast 再 setTimeout(() => router.push, 0)。

Prisma @@map 是表名映射（模型 → 数据库表名），字段 @map 是列名映射。混淆会导致查询的表/列名不匹配。规则：模型 PascalCase + @@map('snake_case')，字段 camelCase（DB 用 snake_case 时加 @map）。

Prisma 索引没生效查询慢，确认：① 查询条件字段是否建了 @@index ② 迁移是否执行 ③ 用 EXPLAIN ANALYZE 查看执行计划 ④ 是否有函数索引需求 ⑤ 大表考虑分区。