运行npm run flow卡在Please wait. Server is starting up: 如何解决?
Flow启动卡在
Please wait. Server is starting up: /的解决方法 - 检查版本兼容性
版本不匹配是最常见的诱因,flow-bin和Node.js版本存在严格的适配关系,如果你使用的是Node.js 16及以下版本,可降级flow-bin到适配的稳定版本:npm install flow-bin@0.198.2 --save-dev
如果你使用的是M系列芯片的Mac设备,旧版本flow-bin没有arm64原生适配,需升级到v0.187及以上版本的flow-bin才能避免Rosetta转译导致的启动异常。
- 检查版本兼容性
- 完善.flowconfig的忽略规则
默认配置会扫描项目根目录下所有文件,如果存在未被忽略的大体积目录(比如构建产物、缓存文件、第三方依赖目录),全量扫描会导致启动卡住,修改.flowconfig的[ignore]块添加以下规则,根据你的项目实际情况调整:
[ignore]
./node_modules/.
./dist/.
./build/.
./.git/.
./.cache/.
./公共静态资源目录/.- 完善.flowconfig的忽略规则
- 清理损坏缓存和残留进程
之前异常退出留下的损坏缓存、后台残留的flow进程都会导致启动卡住,依次执行以下命令:npx flow stopnpx flow start --clean
- 清理损坏缓存和残留进程
- 提升Node.js内存上限
当项目文件量超过万级时,默认分配的Node.js内存不足以支撑全量类型扫描,会出现假死卡住的情况,执行以下命令启动flow:
- Mac/Linux环境:
NODE_OPTIONS=--max_old_space_size=4096 npm run flow - Windows环境:
set NODE_OPTIONS=--max_old_space_size=4096 && npm run flow
- 提升Node.js内存上限
- 定位具体卡滞点
执行带verbose参数的启动命令,可查看实时扫描进度,定位到卡滞对应的文件/目录后,将其添加到[ignore]规则即可:npm run flow -- --verbose
- 定位具体卡滞点
内容的提问来源于stack exchange,提问作者SHIVAM RAJ
相关产品推荐
相关产品推荐

