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
相关产品推荐
相关产品推荐

