Next.js App Router 中拦截路由 catch-all

无所

2025/08/01 11:20:06

Shadcn UI 组件在 Server Component 报错，因为部分组件用了 Radix UI（Client Component）。确保使用 Shadcn 组件的页面或父组件加了 'use client'，或者把组件包裹在 Client Component wrapper 中。

Next.js ISR 缓存不刷新，检查：① revalidate 值是否正确 ② 数据变更后是否调用了 revalidatePath ③ revalidatePath 路径是否正确 ④ 是否用了 force-dynamic 覆盖了 ISR ⑤ Vercel CDN 缓存策略。

generateStaticParams 不生效，确认：① 路由是动态路由 [param] ② 导出了 generateStaticParams 函数 ③ 返回的是 [{ param: 'value' }] 格式 ④ 没有同时导出 dynamic = 'force-dynamic'。

Vercel Hobby 计划函数超时 10s，Pro 计划 60s，Enterprise 900s。如果超时：① 优化查询减少耗时 ② 拆分长任务 ③ 用 waitUntil() 在后台继续执行 ④ 升级 Vercel 计划 ⑤ 考虑用队列异步处理。

router.push 不更新 URL，Next.js 15 + next-intl 在 useSession 触发 re-render 时可能取消 router.push 的 startTransition。解决：用 window.location.href 硬导航（认证流程的例外允许裸路径）。

查看历史

36 回复

并发

并发摆渡人第 2 楼2025/08/02 20:01:57

我的踩坑经验：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。

结网

结网的蜘蛛第 3 楼2025/08/08 23:12:08

说个反直觉的发现：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。感谢楼主的启发。

算法

算法炼丹师第 4 楼2025/08/13 19:34:09

我的理解是：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。如果有更好的方案求分享。

打盹

打盹的考拉第 5 楼2025/08/15 08:42:47

我的团队是这样做的：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。踩了很多坑才总结出来的。

发呆

发呆的仓鼠第 6 楼2025/08/16 18:34:05

补充一点：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。有疑问可以继续问。

Ctrl+C工程师第 7 楼2025/08/16 23:41:48

说说我自己的经历：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。

星辰

星辰大海第 8 楼2025/08/18 19:29:43

next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。

Bug猎人第 9 楼2025/08/21 04:10:26

Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。

栈溢

栈溢出幸存者第 10 楼2025/08/21 12:42:37

我的团队是这样做的：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。有疑问可以继续问。

听风

听风者第 11 楼2025/08/24 00:42:14

这个思路很巧妙，Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。后续有新发现再来更新。

拾光

拾光者第 12 楼2025/09/04 05:59:08

不同场景下结论可能不同：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。感谢楼主的启发。

精神

精神小伙第 13 楼2025/09/05 17:27:19

补充一点：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。如果有更好的方案求分享。

Stack Overflow copy手第 14 楼2025/09/06 17:27:08

我做了类似的对比实验：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。后续有新发现再来更新。

接口

接口焊接工第 15 楼2025/09/08 14:04:01

我做了类似的对比实验：Server Action 提交后不跳转，用 window.location.href 替代 router.push。如果有更好的方案求分享。

差不

差不多第 16 楼2025/09/13 14:13:18

上周刚好踩了这个坑，cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。欢迎交流讨论。

潜水

潜水员第 17 楼2025/09/14 19:28:15

我的理解是：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。欢迎大家补充。

迷路

迷路的信鸽第 18 楼2025/09/18 23:02:10

我的结论恰恰相反：Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。细节可以再展开讨论。

注释

注释写故事第 19 楼2025/09/19 17:18:25

我之前也遇到过类似问题，Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。一起学习。

暮色

暮色苍茫第 20 楼2025/09/20 16:13:46

next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。

干货

干货搬运工第 21 楼2025/09/21 04:47:57

我的看法略有不同：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。感谢楼主的启发。