sjdhome blog
·
解决 Next.js build 完成后卡住的问题
💡
原文中文，约3200字，阅读约需8分钟。
📝
内容提要
在构建 Next.js 项目时，可能会遇到卡住的问题，原因是 Next.js 的 Telemetry 导致网络问题。可以通过执行 `npx next telemetry disable` 来禁用 Telemetry，从而避免在中国大陆使用 Vercel 时的构建卡顿。
🎯
关键要点
- 在执行 Next.js 项目的 npm run build 后，构建过程可能会卡住，表现为 bash 提示符不出现。
- 通过使用 strace 和 ss 命令，发现卡住的原因与 Next.js 的 Telemetry 相关，可能是网络问题。
- 可以通过执行 npx next telemetry disable 来禁用 Telemetry，从而避免构建卡顿。
- 在中国大陆使用 Vercel 时，HTTP_PROXY 和 HTTPS_PROXY 对 Next.js 无效，可能需要使用 TUN 或 WireGuard 等全局联网方式。
- Vercel 应该考虑为 Telemetry 添加超时机制，以改善用户体验。
❓
延伸问答
为什么在构建 Next.js 项目时会卡住？
构建卡住的原因与 Next.js 的 Telemetry 相关，可能是网络问题导致的。
如何解决 Next.js 构建卡住的问题？
可以通过执行 `npx next telemetry disable` 来禁用 Telemetry，从而避免构建卡顿。
在中国大陆使用 Vercel 时，Next.js 的构建有什么特别注意的地方？
在中国大陆使用 Vercel 时，HTTP_PROXY 和 HTTPS_PROXY 对 Next.js 无效，可能需要使用 TUN 或 WireGuard 等全局联网方式。
如何使用 strace 和 ss 命令分析 Next.js 的构建过程？
可以通过执行 `strace npx next build` 来查看系统调用，并使用 `ss -tn` 查看 TCP 连接状态。
Vercel 是否考虑改进 Telemetry 的用户体验？
文章提到 Vercel 应该考虑为 Telemetry 添加超时机制，以改善用户体验。
在构建完成后，如何确认构建结果是否正常？
尽管构建过程可能卡住，但可以通过执行 `npm run start` 来确认构建结果是否正常。
➡️
