求助问答

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

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

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

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

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

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

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

Prisma migrate 报 database does not exist，需要先创建数据库。用 npx prisma db push 或手动 createdb。如果是 Vercel Postgres 或 Supabase，确保 DATABASE_URL 指向正确的数据库实例。 Vercel...

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

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 自动管理，显式多对多需要自己管理中间表。 Next.j...

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

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

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

Prisma 索引没生效查询慢，确认：① 查询条件字段是否建了 @@index ② 迁移是否执行 ③ 用 EXPLAIN ANALYZE 查看执行计划 ④ 是否有函数索引需求 ⑤ 大表考虑分区。 Vercel 部署后 CSS 丢失，常见原因：① Tailwind content 路径没包含组件目录...

Prisma 事务中 create 返回的 id 在 commit 前可能不可用。如果需要用 id 生成 slug，可以在事务内先 create 再 update slug，或用 cuid() 手动生成 id。注意 Prisma @default(cuid()) 在 create 时生成。 gen...

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

Prisma $transaction 超时回滚，默认超时 5s。长事务用 $transaction(async (tx) => { ... }, { timeout: 30000 }) 设置超时。Serverless 环境注意函数超时限制。 useSession() 返回 null，检查：① S...

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

Prisma $transaction 超时回滚，默认超时 5s。长事务用 $transaction(async (tx) => { ... }, { timeout: 30000 }) 设置超时。Serverless 环境注意函数超时限制。 revalidateTag vs revalidate...