Vercel 部署后环境变量不生效的问题

小青

2026/06/13 13:28:46

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

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

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

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

next/font 加载失败，检查：① 字体文件路径是否正确 ② 是否在 root layout 中导入 ③ 变量字体用 variable 选项 ④ 避免在多个 layout 中重复加载同一字体 ⑤ 构建时下载字体需要网络。

查看历史

29 回复

前端

前端魔法师第 2 楼2026/06/14 00:56:41

revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。

赛博

赛博修行者第 3 楼2026/06/17 16:06:04

这个观点我很认同，Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。希望对你有帮助。

热更

热更新选手第 4 楼2026/06/19 17:12:50

我的结论恰恰相反：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。效果因项目而异，建议实际测试。

潜水

潜水员第 5 楼2026/06/20 17:20:10

Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。

搬家

搬家的蚂蚁第 6 楼2026/06/26 07:45:42

我的实践经验和你的不太一样：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。欢迎私信深入交流。

栈溢

栈溢出幸存者第 7 楼2026/06/26 08:13:58

我的理解是：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。

溪畔

溪畔听雨第 8 楼2026/06/27 11:41:45

这个思路很巧妙，Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。一起学习。

雾里

雾里看花第 9 楼2026/06/28 00:07:29

说个反直觉的发现：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。有疑问可以继续问。

打盹

打盹的考拉第 10 楼2026/06/29 17:56:57

分享一下我的做法：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。一起学习。

冬炉

冬炉暖茶第 11 楼2026/07/01 05:15:24

有个更优的方案：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。如果有更好的方案求分享。

社恐

社恐患者第 12 楼2026/07/02 08:34:45

Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。

近水

近水含烟第 13 楼2026/07/02 19:23:41

这个思路很巧妙，cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。希望对你有帮助。

竹林

竹林深处第 14 楼2026/07/05 06:02:16

不同场景下结论可能不同：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。细节可以再展开讨论。

拾光

拾光者第 15 楼2026/07/06 19:59:26

我的理解是：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。效果因项目而异，建议实际测试。

奔跑

奔跑的树懒第 16 楼2026/07/07 19:59:51

反对一下，我的测试结果不是这样：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。期待更多实战经验分享。

夏蝉

夏蝉鸣夜第 17 楼2026/07/09 19:26:37

这个方案我试过，Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。实践出真知，建议动手试试。

阿杰

阿杰第 18 楼2026/07/10 14:12:31

有个相关问题想请教：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。希望少走弯路。

赏月

赏月的灰狼第 19 楼2026/07/13 05:53:49

结合我最近的项目经验：Server Action 提交后不跳转，用 window.location.href 替代 router.push。希望少走弯路。

秋水

秋水长天第 20 楼2026/07/13 22:31:15

这个方案我试过，hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。仅供参考，具体还是要看你的场景。

内存

内存管理员第 21 楼2026/07/19 14:04:16

补充一个边界情况：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。欢迎大家补充。