小青
求助问答小青年
Next.js 中 toast 和 router.push 冲突
revalidatePath 不生效，检查：① 路径是否正确（含 locale 前缀） ② 是否在 Server Action 中调用（不能在普通函数中调用） ③ ISR 的 revalidate 时间是否太长 ④ 是否需要 revalidateTag 清除缓存。 Prisma enum 在 Ty...
500
revalidatePath 不生效，检查：① 路径是否正确（含 locale 前缀） ② 是否在 Server Action 中调用（不能在普通函数中调用） ③ ISR 的 revalidate 时间是否太长 ④ 是否需要 revalidateTag 清除缓存。 Prisma enum 在 Ty...
Vercel 部署后 CSS 丢失，常见原因：① Tailwind content 路径没包含组件目录 ② CSS 被 PurgeCSS 误删 ③ 生产构建时 PostCSS 配置问题 ④ 部分样式只在 Client Component 中生效但被服务端渲染时缺失。 next-intl t() 模...
Prisma $queryRaw 中 camelCase 列名必须加双引号：SELECT "newUserQuota" FROM users。不加双引号 PostgreSQL 会当作不区分大小写的标识符，找不到 camelCase 列。TS 类型声明也要与 SQL 别名一致。 generateSt...
Prisma @@map 是表名映射（模型 → 数据库表名），字段 @map 是列名映射。混淆会导致查询的表/列名不匹配。规则：模型 PascalCase + @@map('snake_case')，字段 camelCase（DB 用 snake_case 时加 @map）。 Vercel Edg...
遇到 hydration mismatch 报错，一般是服务端和客户端渲染的 HTML 不一致。常见原因：① 在组件中用了 Date.now() 或 Math.random() ② 用了 window/document 等浏览器 API ③ 服务端和客户端时区不同。解决：把动态值放到 useEffe...
next-intl t() 模板字符串拼接报错，因为动态拼接翻译键不被支持。用显式 Record 映射替代 t(`${type}Opt`)，改为 const labels: Record<string, string> = { ... } 然后 labels[type]。 router.push...
revalidateTag vs revalidatePath：revalidateTag 清除特定 tag 的缓存（fetch 时用 next.tags 标记），revalidatePath 清除特定路径的缓存。数据变更后 revalidatePath 更直接，精细控制用 revalidateTa...
middleware 重定向循环，一般是认证逻辑和业务重定向冲突。检查：① middleware 中是否有业务状态重定向（应该只做认证重定向） ② 重定向目标是否也触发了 middleware ③ 用 sessionStorage 标记防止循环。 next/font 加载失败，检查：① 字体文件路...
next/image 图片模糊或变形，检查：① 是否设置了 width/height 或 fill ② fill 模式需要父容器 position: relative ③ priority 只给 LCP 图片 ④ sizes 属性帮助浏览器选择正确尺寸 ⑤ 避免在 Server Component...
遇到 hydration mismatch 报错，一般是服务端和客户端渲染的 HTML 不一致。常见原因：① 在组件中用了 Date.now() 或 Math.random() ② 用了 window/document 等浏览器 API ③ 服务端和客户端时区不同。解决：把动态值放到 useEffe...
Auth.js 5 signIn redirect:false 返回 { error, ok, status, url }。判断成功：!result.error && result.ok。注意 result.url 可能含 ?error= 参数，用 redirectTo 显式指定避免误判。 Pri...
Prisma 连接池超时一般是 connection_limit 设置不当。Serverless 环境（Vercel）建议 connection_limit=1，因为每个函数实例独立连接。如果用 PgBouncer 或 Supabase connection pooler，URL 加 ?pgboun...
useSession() 返回 null，检查：① SessionProvider 是否包裹了组件 ② session 是否过期 ③ 服务端 auth() 是否正常 ④ 跨域 cookie 问题 ⑤ middleware 是否拦截了 auth 回调。 Prisma 事务中 create 返回的 i...
Google OAuth 回调报 OAuthCallback 错误，检查：① GOOGLE_CLIENT_ID/SECRET 是否正确 ② NEXTAUTH_URL 是否与 Google Console 中的回调 URL 一致 ③ redirect URI 是否匹配 ④ 时钟同步问题。 Verce...
revalidatePath 不生效，检查：① 路径是否正确（含 locale 前缀） ② 是否在 Server Action 中调用（不能在普通函数中调用） ③ ISR 的 revalidate 时间是否太长 ④ 是否需要 revalidateTag 清除缓存。 Next.js 15 中 nex...
Prisma $transaction 超时回滚，默认超时 5s。长事务用 $transaction(async (tx) => { ... }, { timeout: 30000 }) 设置超时。Serverless 环境注意函数超时限制。 Zod 校验错误消息不显示，检查：① form 表单是...
next-intl 配置后 404，一般是 middleware 匹配规则不对。检查 middleware.ts 中 matcher 配置，确保排除了 /api、/_next、/admin 等非国际化路径。另外检查 defaultLocale 和 locales 配置是否正确。 useSessio...
Prisma 乐观锁并发更新冲突，用 $executeRaw 原子更新：UPDATE table SET count = count + 1 WHERE id = $1 AND count < $limit。配合 FOR UPDATE 行锁防并发竞争。 Vercel 部署后 CSS 丢失，常见原因...
router.push 不更新 URL，Next.js 15 + next-intl 在 useSession 触发 re-render 时可能取消 router.push 的 startTransition。解决：用 window.location.href 硬导航（认证流程的例外允许裸路径）。...
Next.js 动态 import 水合报错，可能是动态组件的 SSR 输出与客户端不一致。加 ssr: false 避免服务端渲染，或确保组件在 SSR 和 CSR 中输出一致。 middleware 重定向循环，一般是认证逻辑和业务重定向冲突。检查：① middleware 中是否有业务状态重...