分享我的 middleware + headers 缓存策略
CDN 缓存一直是个迷，最近终于把 middleware 和 headers 那一套摸顺了。关键是用 NextResponse.next() 加自定义 headers。 配合 ISR，效果是：边缘缓存 60s，过期后回源同时返回旧数据 600s。命中率高，回源率低。 但要注意：
#Next.js♥ 960 评论
#Next.js
专题介绍
这里聚合 CodeNodeX AI 社区中与 Next.js 相关的技术文章和讨论，覆盖概念解释、工具对比、工程实践、常见问题和独立开发经验。
如果你正在研究 Next.js，建议先阅读高质量长文，再参与帖子讨论，形成从理解到实践的完整路径。
revalidateTag 用了一年，吐槽和经验
revalidateTag 思路很好——给 fetch 打 tag，写完数据后按 tag 失效。但用了一年发现有挺多坑。 最坑的是 tag 是全局的，不同路由用了同名 tag 会一起失效。后来约定 tag 带命名空间，比如 posts:list 、 posts:detail:${
#Next.js♥ 70 评论
next/font 本地字体报错，求助
用 next/font/local 加载本地 woff2，本地好好的，build 时报 "Cannot find module" 或者 "Failed to find font"。 排查下来是路径问题。文档说路径相对于当前文件，但实际上是相对于项目根目录（也有人说看版本）。最后统
#Next.js♥ 140 评论
App Router 里 modal 怎么写不闪？
App Router 的 intercepting routes + parallel routes 做模态框，理论很美，实际上首屏从外层路由跳进模态路由时经常闪一下，或者刷新直接进纯页面。 试过的解法： parallel route 的 default.tsx 必须写，否则 4
#Next.js #React♥ 210 评论
route prefetch 关掉之后反而更快
Link 默认会 prefetch 链接目标，列表页一屏几十个 link，prefetch 把带宽和 CPU 都吃满了，低端机明显卡。 试了下 <Link prefetch={false} ，列表页首屏反而快了一截。hover 时还是会 prefetch，体验没差太多。 现在的策
#Next.js♥ 280 评论
分享一份 Next.js 中后台模板的目录结构
基于 App Router 做了一套中后台模板，沉淀了几个比较好用的约定。 每个资源模块是 app/(dashboard)/[resource]/ 下的标准三件套：list / detail / form。 表格列定义抽到 features/[resource]/columns.
#Next.js #TypeScript♥ 350 评论
聊聊 client component 拆分粒度
'use client' 加在哪个层级，一直没标准答案。加太靠上，整棵子树都变成客户端组件，RSC 的好处没了；加太靠下，文件爆炸。 我现在的原则： 叶子交互组件（按钮、输入框、下拉）单独标 'use client' 。 容器组件尽量保持 server，把 client 组件当
#Next.js #React♥ 420 评论
form 提交你们用 Server Actions 还是 API route？
项目里两种风格混着用，想统一一下。Server Actions 写起来简洁，但有些场景感觉 API route 更合适。 我的分类： 站内表单、提交后刷新当前页 → Server Actions。 给前端 SDK、移动端、第三方调用 → API route。 需要复杂中间件（限流
#Next.js #React♥ 630 评论
cookie 在 Server Component 里读不到，求助
在 Server Component 里用 next/headers 的 cookies() 读登录态，本地 dev 正常，部署后偶发读不到。 排查发现是： cookies() 在 Next 15 是 async 了，要 await（已经改）。 跨域 cookie 没带 Same
#Next.js♥ 700 评论
CORS 在 Server Actions 里又坑了我一次
以为 Server Actions 不走 fetch 就没 CORS 问题，结果部署到独立后端域名后，浏览器照样拦。 原因：Actions 本质是 POST 到一个 endpoint，跨域照样受 CORS 约束。需要在 API 层（或反代）显式允许 origin。 特别要注意 N
#Next.js♥ 20 评论
静态导出 (output: export) 还能做多大？
做一个纯静态文档站，想用 output: 'export' 全量 SSG，build 出 HTML 直接丢 CDN。但担心页面多了 build 顶不住。 试了下 5000 篇文档：build 时间 8 分钟，输出 1.2GB。还能接受。瓶颈在 generateStaticPara
#Next.js♥ 90 评论
Toast/通知系统，App Router 下推荐什么方案？
App Router 下做全局 toast，传统的 context + provider 模式套在 root layout 会把整棵树变成 client component，RSC 全废。 现在流行的解法： 用 zustand / jotai 这类非 React Context
#Next.js #React♥ 160 评论