Next.js并行路由构建报错：客户端引用清单不存在求助

我在Next.js 16.1.6中使用并行路由（parallel route），根据路径实现带/不带链接功能的头部组件，但执行构建命令next build --webpack时失败，报错输出如下：

> next build --webpack

▲ Next.js 16.1.6 (webpack)
- Environments: .env.local

  Creating an optimized production build ...
✓ (serwist) Bundling the service worker script with the URL '/sw.js' and the scope '/'...
✓ Compiled successfully in 5.2s
✓ Finished TypeScript in 10.4s    
  Collecting page data using 15 workers  ..global.console will be set to productionOrDebugConsole.
global.console will be set to productionOrDebugConsole.
global.console will be set to productionOrDebugConsole.
✓ Collecting page data using 15 workers in 1023.1ms    
  Generating static pages using 15 workers (0/53)  [=   ]global.console will be set to productionOrDebugConsole.
global.console will be set to productionOrDebugConsole.
global.console will be set to productionOrDebugConsole.
  Generating static pages using 15 workers (26/53)  [==  ]Error occurred prerendering page "/de/splitter3/superAdmin". Read more: https://nextjs.org/docs/messages/prerender-error
Error [InvariantError]: Invariant: The client reference manifest for route "/de/splitter3/superAdmin" does not exist. This is a bug in Next.js.
    at ignore-listed frames
Export encountered an error on /de/splitter3/(splitter3)/superAdmin/@headSuperAdmin/(superAdmin)/page: /de/splitter3/superAdmin, exiting the build.
⨯ Next.js build worker exited with code: 1 and signal: null

错误核心分析 #

预渲染/de/splitter3/superAdmin页面时触发异常，提示该路由的客户端引用清单不存在，官方标注为Next.js的bug，关联的并行路由文件路径为/de/splitter3/(splitter3)/superAdmin/@headSuperAdmin/(superAdmin)/page。

可行解决方向 #

• 检查并行路由文件结构：确认@headSuperAdmin的命名、嵌套层级是否符合Next.js并行路由规范，避免和父路由(splitter3)/superAdmin的路径匹配逻辑冲突。
• 清理缓存后重试：删除.next文件夹与node_modules/.cache目录，重新执行npm install和next build。
• 校验组件导出与语法：检查@headSuperAdmin下的页面组件是否正确导出默认组件，无语法错误或依赖缺失。
• 降级Next.js版本：若确认是16.1.6版本的bug，尝试降级到16.1.5或更早的稳定版本后重新构建。
• 检查国际化配置：因路由包含多语言前缀/de/，确认next.config.js中的i18n配置是否正确，并行路由是否适配多语言路径规则。

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