求助问答

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

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

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

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

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

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

Prisma 索引没生效查询慢，确认：① 查询条件字段是否建了 @@index ② 迁移是否执行 ③ 用 EXPLAIN ANALYZE 查看执行计划 ④ 是否有函数索引需求 ⑤ 大表考虑分区。 Shadcn UI 组件在 Server Component 报错，因为部分组件用了 Radix UI...

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

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

Shadcn UI 组件在 Server Component 报错，因为部分组件用了 Radix UI（Client Component）。确保使用 Shadcn 组件的页面或父组件加了 'use client'，或者把组件包裹在 Client Component wrapper 中。 Prism...

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

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

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

Auth.js credentials 登录返回 null，检查：① authorize 函数是否正确返回 user 对象 ② 密码 bcrypt.compare 是否正确 ③ 用户状态是否 active ④ 是否触发了限流 ⑤ email 是否小写化匹配。 Zod 校验错误消息不显示，检查：①...

next/image 图片模糊或变形，检查：① 是否设置了 width/height 或 fill ② fill 模式需要父容器 position: relative ③ priority 只给 LCP 图片 ④ sizes 属性帮助浏览器选择正确尺寸 ⑤ 避免在 Server Component...

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

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

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

Vercel 构建时 TypeScript 检查失败，可以在 next.config.ts 中设置 typescript.ignoreBuildErrors = true 临时跳过，但不推荐。正确做法：本地运行 npm run typecheck 修复所有类型错误后再部署。 Next.js 15...

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