Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。 Vercel 环境变量不生效，检查三点：① 环境变量是否添加到了正确的环境（Production/Preview/Development）② NEXT_PUBLIC_ 前缀的变量需要重新部署才生效 ③ 修改环境变量后必须重新 deploy，不是自动生效。 React Server Component 中使用 useState 报错，因为 Server Component 不能用 hooks。解决：① 把需要状态的组件拆成 Client Component（加 'use client'） ② 父组件保持 Server Component 做数据获取，子组件 Client 做交互。
讲个真实案例：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。仅供参考，具体还是要看你的场景。
我做了类似的对比实验：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
有个细节值得注意：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。效果因项目而异，建议实际测试。
反对一下，我的测试结果不是这样：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。有疑问可以继续问。
我的理解是：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。希望少走弯路。
Server Action 提交后不跳转，用 window.location.href 替代 router.push。
Server Action 提交后不跳转，用 window.location.href 替代 router.push。
反对一下，我的测试结果不是这样：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。后续有新发现再来更新。
补充一点：Server Action 提交后不跳转，用 window.location.href 替代 router.push。希望少走弯路。
我的踩坑经验：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。踩了很多坑才总结出来的。
这个问题我研究过一阵，Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
有个相关问题想请教：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。共同进步。
补充一个边界情况：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。希望对你有帮助。
反对一下，我的测试结果不是这样：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。实践出真知，建议动手试试。
这个问题我研究过一阵，Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。希望少走弯路。
我的团队是这样做的：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。如有不对请指正。
讲个真实案例：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。一起学习。
这个方案我试过，hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。如有不对请指正。
Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。