You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Next.js执行yarn build无限挂起,Netlify构建超时求助

Next.js构建挂起/Netlify构建超时问题解决

核心问题定位

从Netlify构建日志能看到关键异常:

warn - The following reserved Next.js pages were detected not directly under the pages directory:
/landing/pages/_app

Next.js要求_app.js/_app.tsx这类保留页面必须直接放在项目根目录的pages文件夹下,嵌套目录的结构会导致生产构建逻辑异常,进而出现无限挂起、超时的情况。开发模式下校验宽松,所以dev能正常运行,但build会触发问题。

解决步骤

  • 调整目录结构:把/landing/pages/_app文件移动到项目根目录的pages文件夹下,确保路径为./pages/_app.js(或对应tsx文件)。
  • 本地验证:执行yarn build --debug,确认构建能正常完成,不再挂起。
  • 重新部署:推送修改后的代码到GitHub,触发Netlify重新构建,即可解决超时问题。

其他说明

日志里的其他警告(无license字段、无构建缓存、无ESLint配置、webpack废弃警告)不会导致构建挂起,可后续按需处理,但嵌套保留页面是本次问题的唯一核心诱因。

内容的提问来源于stack exchange,提问作者like who

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.22 10:57:41