Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。 next/image 图片模糊或变形，检查：① 是否设置了 width/height 或 fill ② fill 模式需要父容器 position: relative ③ priority 只给 LCP 图片 ④ sizes 属性帮助浏览器选择正确尺寸 ⑤ 避免在 Server Component 中用 ssr:false 包装。 Prisma 索引没生效查询慢，确认：① 查询条件字段是否建了 @@index ② 迁移是否执行 ③ 用 EXPLAIN ANALYZE 查看执行计划 ④ 是否有函数索引需求 ⑤ 大表考虑分区。
cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。
有个相关问题想请教：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。如果有更好的方案求分享。
Server Action 提交后不跳转，用 window.location.href 替代 router.push。
分享一下我的做法：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。这只是个人经验，不一定通用。
反对一下，我的测试结果不是这样：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
我的看法略有不同：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。感谢楼主的启发。
我调研过这块，hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。效果因项目而异，建议实际测试。
有个相关问题想请教：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。仅供参考，具体还是要看你的场景。