求助问答

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

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

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

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

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

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

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

Prisma Json 字段查询，用 prismaToJson 过滤或 $queryRaw 用 PostgreSQL 的 ->> 操作符。Prisma 6 支持直接在 where 中用 path 过滤 Json 字段。 Google OAuth 回调报 OAuthCallback 错误，检查：①...

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

next-intl 翻译键缺失不报错是默认行为。要启用严格模式：在 next-intl 配置中设置 onError 回调，或用 getTranslations 时检查返回值。开发环境建议开启严格模式及早发现缺失键。 Prisma $queryRaw 中 camelCase 列名必须加双引号：SEL...

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

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

Auth.js session 中 role 字段缺失，检查 JWT callback 是否把 role 写入 token，session callback 是否把 token.role 写入 session.user.role。两步缺一不可。 Prisma @@map 是表名映射（模型 → 数据...

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

next-intl 翻译键缺失不报错是默认行为。要启用严格模式：在 next-intl 配置中设置 onError 回调，或用 getTranslations 时检查返回值。开发环境建议开启严格模式及早发现缺失键。 Prisma $queryRaw 中 camelCase 列名必须加双引号：SEL...

Prisma 乐观锁并发更新冲突，用 $executeRaw 原子更新：UPDATE table SET count = count + 1 WHERE id = $1 AND count < $limit。配合 FOR UPDATE 行锁防并发竞争。 Tailwind v4 升级后样式失效，大版...

Tailwind v4 升级后样式失效，大版本升级有 breaking changes。检查：① tailwind.config.ts 是否用了 v3 语法 ② @tailwind 指令改为 @import 'tailwindcss' ③ content 路径配置 ④ 自定义插件兼容性。建议看官方迁...

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

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

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