Next.js 中 cookies() 在 Server Action 外调用

Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。

Vercel 构建时 TypeScript 检查失败，可以在 next.config.ts 中设置 typescript.ignoreBuildErrors = true 临时跳过，但不推荐。正确做法：本地运行 npm run typecheck 修复所有类型错误后再部署。

Next.js middleware 中 pathname 精确匹配失效，因为 intl 中间件处理后 pathname 含 locale 前缀（如 /zh/dashboard）。用 pathname.includes() 或 getLocaleFromPathname() 而非 pathname === '/dashboard'。

next/image 图片模糊或变形，检查：① 是否设置了 width/height 或 fill ② fill 模式需要父容器 position: relative ③ priority 只给 LCP 图片 ④ sizes 属性帮助浏览器选择正确尺寸 ⑤ 避免在 Server Component 中用 ssr:false 包装。

Server Action 提交后不跳转，可能是用了 router.push 而非 window.location.href。Next.js 15 + next-intl 的 router.push 在 startTransition 内会被 toast 的状态更新中断。解决：用 window.location.href 硬导航。