求助问答

React Server Component 中使用 useState 报错，因为 Server Component 不能用 hooks。解决：① 把需要状态的组件拆成 Client Component（加 'use client'） ② 父组件保持 Server Component 做数据获取，子...

Vercel Hobby 计划函数超时 10s，Pro 计划 60s，Enterprise 900s。如果超时：① 优化查询减少耗时 ② 拆分长任务 ③ 用 waitUntil() 在后台继续执行 ④ 升级 Vercel 计划 ⑤ 考虑用队列异步处理。 Next.js 15 中 cookies()...

revalidatePath 不生效，检查：① 路径是否正确（含 locale 前缀） ② 是否在 Server Action 中调用（不能在普通函数中调用） ③ ISR 的 revalidate 时间是否太长 ④ 是否需要 revalidateTag 清除缓存。 revalidateTag vs...

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

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

Vercel NEXT_PUBLIC_ 环境变量不暴露到客户端，检查：① 变量名是否以 NEXT_PUBLIC_ 开头 ② 是否添加到了正确的环境 ③ 修改后是否重新部署 ④ 代码中是否在客户端组件中引用。 Next.js ISR 缓存不刷新，检查：① revalidate 值是否正确 ② 数据变...

Vercel Hobby 计划函数超时 10s，Pro 计划 60s，Enterprise 900s。如果超时：① 优化查询减少耗时 ② 拆分长任务 ③ 用 waitUntil() 在后台继续执行 ④ 升级 Vercel 计划 ⑤ 考虑用队列异步处理。 Tailwind v4 升级后样式失效，大版...

Vercel Edge Runtime 不支持 Prisma，因为 Prisma 依赖 Node.js 原生模块。Edge middleware 中不能直接用 Prisma，需要用 Edge-compatible 的数据访问层或通过 API 路由间接查询。 Next.js middleware 中...

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

Prisma 索引没生效查询慢，确认：① 查询条件字段是否建了 @@index ② 迁移是否执行 ③ 用 EXPLAIN ANALYZE 查看执行计划 ④ 是否有函数索引需求 ⑤ 大表考虑分区。 Shadcn UI 组件在 Server Component 报错，因为部分组件用了 Radix UI...

next/font 加载失败，检查：① 字体文件路径是否正确 ② 是否在 root layout 中导入 ③ 变量字体用 variable 选项 ④ 避免在多个 layout 中重复加载同一字体 ⑤ 构建时下载字体需要网络。 Prisma $transaction 超时回滚，默认超时 5s。长事务...

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

Prisma Json 字段查询，用 prismaToJson 过滤或 $queryRaw 用 PostgreSQL 的 ->> 操作符。Prisma 6 支持直接在 where 中用 path 过滤 Json 字段。 Google OAuth 回调报 OAuthCallback 错误，检查：①...

revalidateTag vs revalidatePath：revalidateTag 清除特定 tag 的缓存（fetch 时用 next.tags 标记），revalidatePath 清除特定路径的缓存。数据变更后 revalidatePath 更直接，精细控制用 revalidateTa...

Next.js 15 中 cookies().set() 后跟 redirect() 不兼容，因为 redirect() 抛出特殊错误终止请求，不会包含之前设置的 cookie。解决：用 Server Action（cookies().set 在 Action 中正常工作）或渲染客户端组件处理。...

Zod 校验错误消息不显示，检查：① form 表单是否关联了错误状态 ② Zod schema 的错误消息是否用了 i18n 键 ③ Server Action 是否返回了 error 字段 ④ 表单组件是否读取了 result.error 并显示。 Google OAuth 回调报 OAuth...

Vercel Edge Runtime 不支持 Prisma，因为 Prisma 依赖 Node.js 原生模块。Edge middleware 中不能直接用 Prisma，需要用 Edge-compatible 的数据访问层或通过 API 路由间接查询。 Auth.js JWT token 中字...

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

Server Action 提交后不跳转，可能是用了 router.push 而非 window.location.href。Next.js 15 + next-intl 的 router.push 在 startTransition 内会被 toast 的状态更新中断。解决：用 window.lo...

Auth.js credentials 登录返回 null，检查：① authorize 函数是否正确返回 user 对象 ② 密码 bcrypt.compare 是否正确 ③ 用户状态是否 active ④ 是否触发了限流 ⑤ email 是否小写化匹配。 Next.js ISR 缓存不刷新，检...