求助问答

router.push 不更新 URL，Next.js 15 + next-intl 在 useSession 触发 re-render 时可能取消 router.push 的 startTransition。解决：用 window.location.href 硬导航（认证流程的例外允许裸路径）。...

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

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

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

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

Auth.js 5 beta 的 session 丢失问题，常见原因：① AUTH_SECRET 未配置或变了 ② cookie 被中间件清除 ③ JWT 过期。排查：检查 AUTH_SECRET 是否一致，middleware 中是否有不必要的 Set-Cookie，callbacks.jwt 是...

Prisma 乐观锁并发更新冲突，用 $executeRaw 原子更新：UPDATE table SET count = count + 1 WHERE id = $1 AND count < $limit。配合 FOR UPDATE 行锁防并发竞争。 Google OAuth 回调报 OAuth...

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

Next.js 15 中 next/dynamic + ssr:false 在 Server Component 中不允许。解决：创建一个 'use client' 的包装组件，在包装组件中用 next/dynamic + ssr:false，然后在 Server Component 中导入这个包装...

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

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

遇到 hydration mismatch 报错，一般是服务端和客户端渲染的 HTML 不一致。常见原因：① 在组件中用了 Date.now() 或 Math.random() ② 用了 window/document 等浏览器 API ③ 服务端和客户端时区不同。解决：把动态值放到 useEffe...

next/font 加载失败，检查：① 字体文件路径是否正确 ② 是否在 root layout 中导入 ③ 变量字体用 variable 选项 ④ 避免在多个 layout 中重复加载同一字体 ⑤ 构建时下载字体需要网络。 Next.js 动态 import 水合报错，可能是动态组件的 SSR...

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

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

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

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

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

遇到 hydration mismatch 报错，一般是服务端和客户端渲染的 HTML 不一致。常见原因：① 在组件中用了 Date.now() 或 Math.random() ② 用了 window/document 等浏览器 API ③ 服务端和客户端时区不同。解决：把动态值放到 useEffe...

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