当前位置：首页 > news >正文

Next.js build 完成后卡住

news 来源：原创 2025/4/30 4:29:48

Next.js build 完成后卡住

在这里插入图片描述

一、前言

最近一段时间，我在执行 Next.js 项目的 npm run build 之后总是卡住，显示完所有 route 之后，一直卡主，只能手动 Ctrl + C 打断构建流程。

但此时的构建结果可以正常被 npm run start 使用，在 Vercel 上构建也不会出现卡顿问题。

二、解决方法

退出 Next.js 的 Telemetry。

npx next telemetry disable

返回example
在这里插入图片描述

三、原因

执行 strace npx next build，得以看到 Next.js 编译过程中所执行的系统调用。为了能将 strace 的输出和 Next.js 的输出分开，可以使用 mkfifo log 命令建立命名管道，然后执行 strace npx next build 2>log 将 stderr 重定向到管道，使用 cat < log 输出系统调用信息。

strace npx next build 最终卡在以下部分：

First Load JS shared by all 87 kB
├ chunks/23-b022cbf28d88ae21.js 31.4 kB
├ chunks/fd9d1056-e3489de6ce1f07f6.js 53.7 kB
└ other shared chunks (total) 1.94 kB

○ (Static) prerendered as static content
● (SSG) prerendered as static HTML (uses getStaticProps)
而 cat < log 则输出：

epoll_pwait(17, [{events=EPOLLIN, data={u32=22, u64=22}}], 1024, 0, NULL, 8) = 1
read(22, “\1\0\0\0\0\0\0\0”, 1024) = 8
epoll_pwait(17, [], 1024, 0, NULL, 8) = 0
epoll_pwait(17,
epoll 系统调用通常用于网络上，因此大概是遇到了网络问题。

另外打开一个终端，输入 ss -tn，可以看到许多 Vercel IP 段的 TCP 连接：

ESTAB 0 2384
10.20.244.49:60724 76.76.21.22:443 ESTAB 0 1675 10.20.244.49:60970
76.76.21.241:443 FIN-WAIT-1 0 2015 10.20.244.49:60750 76.76.21.142:443 ESTAB 0 4851 10.20.244.49:60844
76.76.21.22:443

结合之前 Vercel 在中国大陆被阻断的事件，我大约感觉出了原因。HTTP_PROXY 和 HTTPS_PROXY 似乎对 Next.js 无效，因此需要借助 TUN 或者 WireGuard 等全局联网方式才能解决。

当然，最简单的方法就是退出 Next.js 的 Telemetry。

参考资料
Telemetry | Next.js by Vercel - The React Framework
注：这个是只有中国用户在权限比较严苛的服务器上才会遇到的问题。