求助问答

Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。 Prisma 乐观锁并发更新冲突，用 $exe...

Next.js Server Action 返回 undefined，可能是 Action 函数没有 return 值，或 return 的对象结构不对。Server Action 应该返回 { success: boolean, data?: T, error?: string } 格式。 Pr...

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

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

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

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

Next.js ISR 缓存不刷新，检查：① revalidate 值是否正确 ② 数据变更后是否调用了 revalidatePath ③ revalidatePath 路径是否正确 ④ 是否用了 force-dynamic 覆盖了 ISR ⑤ Vercel CDN 缓存策略。 Vercel NE...

next-intl 翻译键缺失不报错是默认行为。要启用严格模式：在 next-intl 配置中设置 onError 回调，或用 getTranslations 时检查返回值。开发环境建议开启严格模式及早发现缺失键。 Prisma 索引没生效查询慢，确认：① 查询条件字段是否建了 @@index ②...

Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。 Prisma $transaction 超时回...

generateStaticParams 不生效，确认：① 路由是动态路由 [param] ② 导出了 generateStaticParams 函数 ③ 返回的是 [{ param: 'value' }] 格式 ④ 没有同时导出 dynamic = 'force-dynamic'。 Auth.j...

next-intl 配置后 404，一般是 middleware 匹配规则不对。检查 middleware.ts 中 matcher 配置，确保排除了 /api、/_next、/admin 等非国际化路径。另外检查 defaultLocale 和 locales 配置是否正确。 Tailwind...

next-intl t() 模板字符串拼接报错，因为动态拼接翻译键不被支持。用显式 Record 映射替代 t(`${type}Opt`)，改为 const labels: Record<string, string> = { ... } 然后 labels[type]。 router.push...

Auth.js 5 signIn redirect:false 返回 { error, ok, status, url }。判断成功：!result.error && result.ok。注意 result.url 可能含 ?error= 参数，用 redirectTo 显式指定避免误判。 rev...

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

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

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

Auth.js credentials 登录返回 null，检查：① authorize 函数是否正确返回 user 对象 ② 密码 bcrypt.compare 是否正确 ③ 用户状态是否 active ④ 是否触发了限流 ⑤ email 是否小写化匹配。 Prisma @@map 是表名映射（...

next-intl 配置后 404，一般是 middleware 匹配规则不对。检查 middleware.ts 中 matcher 配置，确保排除了 /api、/_next、/admin 等非国际化路径。另外检查 defaultLocale 和 locales 配置是否正确。 Vercel 环境...

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

next-intl t() 模板字符串拼接报错，因为动态拼接翻译键不被支持。用显式 Record 映射替代 t(`${type}Opt`)，改为 const labels: Record<string, string> = { ... } 然后 labels[type]。 Server Actio...