跳到主内容

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

云中漫步1218 浏览
云中
云中漫步楼主
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 硬导航。
Next.js
查看历史

30 回复

  1. 内卷
    内卷幸存者第 2 楼
    我的团队是这样做的：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
  2. 发呆
    发呆的仓鼠第 3 楼
    next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。
  3. ET
    Ethan Brooks第 4 楼
    从另一个角度看：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。这只是个人经验，不一定通用。
  4. TA
    Tan Wei Ming第 5 楼
    这个方案我试过，next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。希望少走弯路。
  5. 听风
    听风者第 6 楼
    Server Action 提交后不跳转，用 window.location.href 替代 router.push。
  6. DI
    Diego Ramos第 7 楼
    有个相关问题想请教：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。踩了很多坑才总结出来的。
  7. 雾里
    雾里看花第 8 楼
    我的团队是这样做的：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。希望少走弯路。
  8. 熬夜
    熬夜的猫头鹰第 9 楼
    实操中我发现：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
  9. 竹林
    竹林深处第 10 楼
    我的看法略有不同：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。有疑问可以继续问。
  10. 逻辑
    逻辑编织者第 11 楼
    补充一个可能被忽略的点：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。有疑问可以继续问。
  11. 掘洞
    掘洞的兔第 12 楼
    有个更优的方案：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。如有不对请指正。
  12. 蜕皮
    蜕皮的蛇第 13 楼
    说说我自己的经历：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。
  13. SO
    Somchai Phanuwat第 14 楼
    我的团队是这样做的：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。希望少走弯路。
  14. 巡山
    巡山的狐狸第 15 楼
    我的踩坑经验：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。后续有新发现再来更新。
  15. 产品
    产品对立面第 16 楼
    我的团队是这样做的：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。仅供参考，具体还是要看你的场景。
  16. 像素
    像素调配师第 17 楼
    我的踩坑经验：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。后续有新发现再来更新。
  17. LA
    Layla Rahman第 18 楼
    hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。
  18. 刚刚
    刚刚好第 19 楼
    这个方案我试过，Server Action 提交后不跳转，用 window.location.href 替代 router.push。踩了很多坑才总结出来的。
  19. 春暖
    春暖花开第 20 楼
    结合我最近的项目经验：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。如有不对请指正。
  20. 离线
    离线爱好者第 21 楼
    这个思路很巧妙，revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。有疑问可以继续问。
登录后可回复
    数据正在加载中…