Next.js执行npm run build报错：同动态路径不能用不同slug名称

问题原因 #

你执行npm run build时触发的错误，核心是Next.js的路由规则检测：同一层级的动态路由使用了不同的参数命名，导致路由匹配逻辑冲突。

从你的页面目录结构来看，应该存在如下冲突的路由文件：

• pages/blog/[category].js（或pages/blog/[category]/index.js）
• pages/blog/[slug].js

这两个文件对应的前端路由路径都是/blog/[动态值]，但参数名分别为category和slug，Next.js无法区分这两条路由的匹配规则，因此在构建阶段抛出错误。

解决办法 #

根据你的业务场景，选择以下任意一种方案：

方案1：调整路由层级，拆分路径 #

如果category（分类页）和slug（文章页）是不同业务场景的页面，修改目录结构来区分路由路径：

• 分类页：pages/blog/category/[category].js（对应访问路径：/blog/category/xxx）
• 文章页：pages/blog/post/[slug].js（对应访问路径：/blog/post/xxx）
  通过给不同页面添加固定前缀目录，让路由路径完全独立，避免冲突。

方案2：统一动态参数名称 #

如果这两个路由本质是同一类页面（比如参数名是误写），将其中一个文件的动态参数名修改为和另一个一致：

• 例如把[category].js重命名为[slug].js，或者反过来，确保同一层级的动态路由参数名完全相同。

验证步骤 #

修改完成后，先执行npm run dev启动开发服务器，测试相关路由是否能正常访问，确认无异常后再执行npm run build即可完成构建。

内容的提问来源于stack exchange，提问作者Jack The Baker