求助问答

按照官方文档一步步操作的，到第三步就报错了。错误信息贴在下面，搜了一圈没找到相同案例。 Error: connection refused (timeout after 30s) 环境：Win11 + Node 20，本地开发模式。有没有朋友遇到过类似情况？

按照官方文档一步步操作的，到第三步就报错了。错误信息贴在下面，搜了一圈没找到相同案例。 Error: connection refused (timeout after 30s) 环境：Win11 + Node 20，本地开发模式。有没有朋友遇到过类似情况？

按照官方文档一步步操作的，到第三步就报错了。错误信息贴在下面，搜了一圈没找到相同案例。 Error: connection refused (timeout after 30s) 环境：Win11 + Node 20，本地开发模式。有没有朋友遇到过类似情况？

问题描述：功能在本地一切正常，部署到线上就复现不了。怀疑是环境变量或者网络策略的问题，但日志里看不到明确报错。 已经尝试过： 1. 重新部署； 2. 对比两边的环境变量； 3. 清缓存重来一遍。 求个排查思路，卡这里一天了。

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

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

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

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

Prisma Json 字段查询，用 prismaToJson 过滤或 $queryRaw 用 PostgreSQL 的 ->> 操作符。Prisma 6 支持直接在 where 中用 path 过滤 Json 字段。 Zod 校验错误消息不显示，检查：① form 表单是否关联了错误状态 ② Z...

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

Prisma 连接池超时一般是 connection_limit 设置不当。Serverless 环境（Vercel）建议 connection_limit=1，因为每个函数实例独立连接。如果用 PgBouncer 或 Supabase connection pooler，URL 加 ?pgboun...

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

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

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

Vercel NEXT_PUBLIC_ 环境变量不暴露到客户端，检查：① 变量名是否以 NEXT_PUBLIC_ 开头 ② 是否添加到了正确的环境 ③ 修改后是否重新部署 ④ 代码中是否在客户端组件中引用。 Auth.js 5 beta 的 session 丢失问题，常见原因：① AUTH_SEC...

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

Prisma $transaction 超时回滚，默认超时 5s。长事务用 $transaction(async (tx) => { ... }, { timeout: 30000 }) 设置超时。Serverless 环境注意函数超时限制。 Vercel 部署后 CSS 丢失，常见原因：① Ta...

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

Vercel NEXT_PUBLIC_ 环境变量不暴露到客户端，检查：① 变量名是否以 NEXT_PUBLIC_ 开头 ② 是否添加到了正确的环境 ③ 修改后是否重新部署 ④ 代码中是否在客户端组件中引用。 Prisma enum 在 TypeScript 中报错，确保：① 运行了 prisma...

Vercel Edge Runtime 不支持 Prisma，因为 Prisma 依赖 Node.js 原生模块。Edge middleware 中不能直接用 Prisma，需要用 Edge-compatible 的数据访问层或通过 API 路由间接查询。 Prisma 多对多关系创建，用 con...