记录vue-cli-service serve启动本地服务卡住问题

小白路过2026-02-06 9:50

问题描述

vue2项目，启动本地服务时，控制台一直卡在 "Starting development server..."，后续不再输出，也无任何报错。尝试执行build，发现可以正常build，但是dev server就是起不来，期间尝试切换node版本，升级vue-cli，关闭sourcemap，删除npm缓存重新安装等，均不起作用。

配置项

@vue/cli-service：4.2.3， devServer配置如下

json 复制代码

{
    // 端口
    port: 8088,
    // 启动时自动默认浏览器打开
    open: true,
    //允许主应用跨域，获取当前微应用的静态资源
    headers: {
      'Access-Control-Allow-Origin': '*'
    },
    https: false,
    // 去掉samesite验证
    disableHostCheck: true,
    overlay: {
      // 显示warnings
      warnings: true,
      // 显示error
      errors: true
    }
  }

解决方法

在devServer中添加host指定项

json 复制代码

{
devServer: {
// 必须指定：Windows 下默认 0.0.0.0 会导致 dev 起服时卡住，改为 127.0.0.1 仅监听本机即可正常
    host: '127.0.0.1',
    }
}

原因简述 ：

Vue CLI 默认是 host: '0.0.0.0'，表示「监听所有网卡」。

在 Windows 上，绑定 0.0.0.0 时系统会处理所有网络接口（本机回环、以太网、WiFi、虚拟网卡等），部分环境下这一步会卡住或极慢，表现就是一直停在 "Starting development server..."。

改成 host: '127.0.0.1' 后只监听本机回环，不再枚举其它网卡，所以能正常启动。
注意：用 127.0.0.1 时，同一局域网内的其它设备（手机、别的电脑）不能通过你本机 IP 访问该 dev 服务。如果以后需要真机调试，可以再试本机 IP（例如 host: '192.168.x.x'），或继续用 127.0.0.1 + 用内网穿透/代理做真机访问。