Google OAuth 回调报 OAuthCallback 错误，检查：① GOOGLE_CLIENT_ID/SECRET 是否正确 ② NEXTAUTH_URL 是否与 Google Console 中的回调 URL 一致 ③ redirect URI 是否匹配 ④ 时钟同步问题。 Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。 router.push 不更新 URL，Next.js 15 + next-intl 在 useSession 触发 re-render 时可能取消 router.push 的 startTransition。解决：用 window.location.href 硬导航（认证流程的例外允许裸路径）。
middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
实操中我发现：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。有疑问可以继续问。
分享一下我的做法：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。
我做了类似的对比实验：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
上周刚好踩了这个坑，middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。
这个问题我研究过一阵，useSession() 返回 null 检查 SessionProvider 是否包裹了组件。踩了很多坑才总结出来的。
这个问题我研究过一阵，cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。
不同场景下结论可能不同：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。
我之前也遇到过类似问题，Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。共同进步。
结合我最近的项目经验：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。一起学习。
我的实践经验和你的不太一样：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。后续有新发现再来更新。
有个更优的方案：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。
我的实践经验和你的不太一样：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。细节可以再展开讨论。
Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。
我的看法略有不同：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。仅供参考，具体还是要看你的场景。
反对一下，我的测试结果不是这样：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。欢迎私信深入交流。
我做了类似的对比实验：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。如果有更好的方案求分享。
我调研过这块，Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。感谢楼主的启发。