Next.js App Router 中 cookies().set() 和 redirect() 不兼容

电子

2025/08/07 19:58:49

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

next-intl 翻译键缺失不报错是默认行为。要启用严格模式：在 next-intl 配置中设置 onError 回调，或用 getTranslations 时检查返回值。开发环境建议开启严格模式及早发现缺失键。

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

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

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

查看历史

42 回复

内卷

内卷幸存者第 2 楼2025/08/08 10:22:49

我调研过这块，Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。这只是个人经验，不一定通用。

需求

需求翻译机第 3 楼2025/08/14 03:04:35

我调研过这块，Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。一起学习。

并发

并发摆渡人第 4 楼2025/08/15 14:38:38

我的踩坑经验：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。

林间

林间晨露第 5 楼2025/08/22 09:42:34

我的理解是：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。期待更多实战经验分享。

蜕皮

蜕皮的蛇第 6 楼2025/08/26 21:48:14

上周刚好踩了这个坑，middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。有疑问可以继续问。

雾里

雾里看花第 7 楼2025/08/27 15:40:06

实操中我发现：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。踩了很多坑才总结出来的。

Stack Overflow copy手第 8 楼2025/08/27 19:43:57

我的实践经验和你的不太一样：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。

快乐

快乐的水豚第 9 楼2025/08/30 20:42:07

分享一下我的做法：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。欢迎大家补充。

老张

老张第 10 楼2025/08/31 10:22:39

有个细节值得注意：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。效果因项目而异，建议实际测试。

Bug猎人第 11 楼2025/09/02 22:41:01

我的理解是：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。希望少走弯路。

差不

差不多第 12 楼2025/09/05 01:59:14

有个细节值得注意：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。欢迎私信深入交流。

阿杰

阿杰第 13 楼2025/09/11 21:26:25

我的项目里也用了这个方案，Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。希望少走弯路。

竹林

竹林深处第 14 楼2025/09/18 12:30:07

上周刚好踩了这个坑，next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。我也还在探索中。

刚刚

刚刚好第 15 楼2025/09/20 02:25:54

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

等风

等风来第 16 楼2025/09/20 08:21:33

反对一下，我的测试结果不是这样：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。

夏蝉

夏蝉鸣夜第 17 楼2025/09/21 19:46:07

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

接口

接口焊接工第 18 楼2025/09/24 20:43:21

实操中我发现：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。实践出真知，建议动手试试。

注释

注释写故事第 19 楼2025/09/25 13:35:34

我的结论恰恰相反：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。

路过

路过的甲第 20 楼2025/09/26 15:30:52

从另一个角度看：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。欢迎大家补充。

春暖

春暖花开第 21 楼2025/09/28 08:13:30

我的实践经验和你的不太一样：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。细节可以再展开讨论。