Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。 Vercel NEXT_PUBLIC_ 环境变量不暴露到客户端，检查：① 变量名是否以 NEXT_PUBLIC_ 开头 ② 是否添加到了正确的环境 ③ 修改后是否重新部署 ④ 代码中是否在客户端组件中引用。 Next.js 15 中 cookies().set() 后跟 redirect() 不兼容，因为 redirect() 抛出特殊错误终止请求，不会包含之前设置的 cookie。解决：用 Server Action（cookies().set 在 Action 中正常工作）或渲染客户端组件处理。
我做了类似的对比实验：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
不同场景下结论可能不同：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。
说个反直觉的发现：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。如果有更好的方案求分享。
我的理解是：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。有疑问可以继续问。
说说我自己的经历：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。我也还在探索中。
useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
我的项目里也用了这个方案，useSession() 返回 null 检查 SessionProvider 是否包裹了组件。这只是个人经验，不一定通用。
我的团队是这样做的：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。欢迎交流讨论。
说说我自己的经历：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。希望少走弯路。
我的理解是：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。期待更多实战经验分享。
这个观点我很认同，Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。
有个相关问题想请教：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。如有不对请指正。
next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。
有个细节值得注意：Server Action 提交后不跳转，用 window.location.href 替代 router.push。效果因项目而异，建议实际测试。
有个细节值得注意：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。有疑问可以继续问。
说个反直觉的发现：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。后续有新发现再来更新。
有个细节值得注意：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。细节可以再展开讨论。
补充一个边界情况：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。一起学习。
我的踩坑经验：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。共同进步。
我的踩坑经验：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。希望对你有帮助。