Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。 next-intl 翻译键缺失不报错是默认行为。要启用严格模式：在 next-intl 配置中设置 onError 回调，或用 getTranslations 时检查返回值。开发环境建议开启严格模式及早发现缺失键。 Tailwind v4 升级后样式失效，大版本升级有 breaking changes。检查：① tailwind.config.ts 是否用了 v3 语法 ② @tailwind 指令改为 @import 'tailwindcss' ③ content 路径配置 ④ 自定义插件兼容性。建议看官方迁移指南。
上周刚好踩了这个坑，Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。共同进步。
不同场景下结论可能不同：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。如有不对请指正。
有个细节值得注意：Server Action 提交后不跳转，用 window.location.href 替代 router.push。欢迎私信深入交流。
这个方案我试过，Server Action 提交后不跳转，用 window.location.href 替代 router.push。踩了很多坑才总结出来的。
Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。
我的理解是：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。如有不对请指正。
我做了类似的对比实验：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。我也还在探索中。
next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。
我做了类似的对比实验：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。
有个相关问题想请教：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。有疑问可以继续问。
分享一下我的做法：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。实践出真知，建议动手试试。
我做了类似的对比实验：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。一起学习。
结合我最近的项目经验：Server Action 提交后不跳转，用 window.location.href 替代 router.push。实践出真知，建议动手试试。
补充一点：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。欢迎大家补充。
我的理解是：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。实践出真知，建议动手试试。
我的踩坑经验：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。欢迎私信深入交流。
middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
补充一点：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。这只是个人经验，不一定通用。
我的团队是这样做的：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。如果有更好的方案求分享。