求助问答

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

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

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

Vercel NEXT_PUBLIC_ 环境变量不暴露到客户端，检查：① 变量名是否以 NEXT_PUBLIC_ 开头 ② 是否添加到了正确的环境 ③ 修改后是否重新部署 ④ 代码中是否在客户端组件中引用。 Zod 校验错误消息不显示，检查：① form 表单是否关联了错误状态 ② Zod sch...

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

Prisma $queryRaw 中 camelCase 列名必须加双引号：SELECT "newUserQuota" FROM users。不加双引号 PostgreSQL 会当作不区分大小写的标识符，找不到 camelCase 列。TS 类型声明也要与 SQL 别名一致。 Server Act...

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

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

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

next-intl 翻译键缺失不报错是默认行为。要启用严格模式：在 next-intl 配置中设置 onError 回调，或用 getTranslations 时检查返回值。开发环境建议开启严格模式及早发现缺失键。 Prisma 连接池超时一般是 connection_limit 设置不当。Ser...

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

Prisma Json 字段查询，用 prismaToJson 过滤或 $queryRaw 用 PostgreSQL 的 ->> 操作符。Prisma 6 支持直接在 where 中用 path 过滤 Json 字段。 Prisma enum 在 TypeScript 中报错，确保：① 运行了 p...

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

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

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

Prisma enum 在 TypeScript 中报错，确保：① 运行了 prisma generate ② import { Prisma } from '@prisma/client' 取枚举值 ③ 不要用字符串字面量而用 Prisma.EnumType 枚举 ④ schema 中 enum...

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

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

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

Auth.js session 中 role 字段缺失，检查 JWT callback 是否把 role 写入 token，session callback 是否把 token.role 写入 session.user.role。两步缺一不可。 Prisma $queryRaw 中 camelCa...