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

运行npm run flow卡在Please wait. Server is starting up: 如何解决?

Flow启动卡在Please wait. Server is starting up: /的解决方法
    1. 检查版本兼容性
      版本不匹配是最常见的诱因,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转译导致的启动异常。
    1. 完善.flowconfig的忽略规则
      默认配置会扫描项目根目录下所有文件,如果存在未被忽略的大体积目录(比如构建产物、缓存文件、第三方依赖目录),全量扫描会导致启动卡住,修改.flowconfig的[ignore]块添加以下规则,根据你的项目实际情况调整:

    [ignore]
    ./node_modules/.
    ./dist/.
    ./build/.
    ./.git/.
    ./.cache/.
    ./公共静态资源目录/.

    1. 清理损坏缓存和残留进程
      之前异常退出留下的损坏缓存、后台残留的flow进程都会导致启动卡住,依次执行以下命令:
      npx flow stop
      npx flow start --clean
    1. 提升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
    1. 定位具体卡滞点
      执行带verbose参数的启动命令,可查看实时扫描进度,定位到卡滞对应的文件/目录后,将其添加到[ignore]规则即可:
      npm run flow -- --verbose

内容的提问来源于stack exchange,提问作者SHIVAM RAJ

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.15 00:36:13