在Vercel部署时遇到Builder路由数量限制错误

错误含义 #

这个错误表示你项目生成的路由规则数量超过了Vercel构建器允许的上限（最多100条）。Vercel对构建阶段生成的路由配置有数量限制，当路由条目超过100个时，构建器就会触发这个校验错误。

问题排查方向 #

从你的项目情况来看，大概率是以下两种情况之一：

• 静态站点生成（SSG）逻辑生成了过多页面，每个页面对应一条路由规则，最终总数破百
• vercel.json文件中手动配置的routes数组包含了超过100条独立条目

解决方法 #

• 合并路由规则：使用通配符（*）或参数化路由替代大量重复的独立路由。比如把/calc/1、/calc/2这类相似路由合并为/calc/:id，用单个规则覆盖批量场景。
• 优化SSG生成逻辑：检查项目中是否有不必要的页面被生成，比如过滤掉测试页面、重复内容页面，减少需要生成的路由数量。
• 清理vercel.json配置：打开vercel.json，检查routes数组里的条目，删除冗余规则，合并可复用的配置。

内容的提问来源于stack exchange，提问作者Prottay Rudra