求助问答

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

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

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

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

Prisma Json 字段查询，用 prismaToJson 过滤或 $queryRaw 用 PostgreSQL 的 ->> 操作符。Prisma 6 支持直接在 where 中用 path 过滤 Json 字段。 toast 和 router.push 冲突，因为 toast 的状态更新会中...

Prisma 乐观锁并发更新冲突，用 $executeRaw 原子更新：UPDATE table SET count = count + 1 WHERE id = $1 AND count < $limit。配合 FOR UPDATE 行锁防并发竞争。 Vercel 部署后 CSS 丢失，常见原因...

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

Auth.js JWT token 中字段不更新，因为 JWT 是有状态的快照。修改用户字段后需要用 useSession().update() 刷新客户端 session，同时 JWT callback 中处理 trigger === 'update' 从 DB 读取最新值更新 token。 P...

Zod refine 校验不触发，检查：① refine 是否在 schema 末尾 ② 是否用了 safeParse（parse 会抛错） ③ refine 的 path 是否正确指向字段 ④ 异步 refine 用 superRefine + async。 React Server Compo...

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

Next.js middleware 中 pathname 精确匹配失效，因为 intl 中间件处理后 pathname 含 locale 前缀（如 /zh/dashboard）。用 pathname.includes() 或 getLocaleFromPathname() 而非 pathname...

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

Vercel 部署后 CSS 丢失，常见原因：① Tailwind content 路径没包含组件目录 ② CSS 被 PurgeCSS 误删 ③ 生产构建时 PostCSS 配置问题 ④ 部分样式只在 Client Component 中生效但被服务端渲染时缺失。 next-intl t() 模...

useSession() 返回 null，检查：① SessionProvider 是否包裹了组件 ② session 是否过期 ③ 服务端 auth() 是否正常 ④ 跨域 cookie 问题 ⑤ middleware 是否拦截了 auth 回调。 revalidatePath 不生效，检查：①...

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

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

Zod refine 校验不触发，检查：① refine 是否在 schema 末尾 ② 是否用了 safeParse（parse 会抛错） ③ refine 的 path 是否正确指向字段 ④ 异步 refine 用 superRefine + async。 Next.js 15 中 next/...

next/image 图片模糊或变形，检查：① 是否设置了 width/height 或 fill ② fill 模式需要父容器 position: relative ③ priority 只给 LCP 图片 ④ sizes 属性帮助浏览器选择正确尺寸 ⑤ 避免在 Server Component...

Prisma 多对多关系创建，用 connect 或 create 连接：prisma.user.create({ data: { roles: { connect: [{ id: roleId }] } } })。隐式多对多表 Prisma 自动管理，显式多对多需要自己管理中间表。 revali...

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