Vercel 部署时 Prisma Client 生成失败

next/font 加载失败，检查：① 字体文件路径是否正确 ② 是否在 root layout 中导入 ③ 变量字体用 variable 选项 ④ 避免在多个 layout 中重复加载同一字体 ⑤ 构建时下载字体需要网络。

Vercel 构建时 TypeScript 检查失败，可以在 next.config.ts 中设置 typescript.ignoreBuildErrors = true 临时跳过，但不推荐。正确做法：本地运行 npm run typecheck 修复所有类型错误后再部署。

middleware 重定向循环，一般是认证逻辑和业务重定向冲突。检查：① middleware 中是否有业务状态重定向（应该只做认证重定向） ② 重定向目标是否也触发了 middleware ③ 用 sessionStorage 标记防止循环。

Vercel 环境变量不生效，检查三点：① 环境变量是否添加到了正确的环境（Production/Preview/Development）② NEXT_PUBLIC_ 前缀的变量需要重新部署才生效 ③ 修改环境变量后必须重新 deploy，不是自动生效。