解决 Vite 开发服务器启动报错：spawn EPERM本文介绍了在 Windows 系统下 Vite 开发服务器启动

问题现象

在 Windows 系统下运行 Vite 开发服务器时，控制台报错：

Error: spawn EPERM 
     at ChildProcess.spawn (node:internal/child_process:420:11) 
     at Object.spawn (node:child_process:787:9) 
     at baseOpen (file:///E:/标签溯源/code/TraceGuard-UI/node_modules/vite/dist/node/chunks/dep-DBxKXgDP.js:26487:36)

开发服务器无法正常启动，或者启动后立即崩溃。

发生原因

这个错误通常由以下几个因素导致：

1. Vite 自动打开浏览器功能

在 vite.config.js 配置文件中，server.open 选项被设置为 true：

server: {
  port: 80,
  host: true,
  open: true,  // 这里是问题所在
  // ...
}

当 open: true 时，Vite 会在服务器启动后自动调用系统默认浏览器打开开发地址。

2. Windows 权限限制

在 Windows 系统上，Node.js 的 child_process.spawn() 方法尝试启动浏览器进程时，可能会遇到以下权限问题：

权限不足：当前进程没有足够的权限启动外部应用程序
安全策略限制：Windows Defender 或企业安全策略阻止了进程创建
路径问题：浏览器可执行文件路径无法正确解析

3. 端口占用（次要原因）

如果配置的端口（如 80）已被其他进程占用，也可能导致类似的错误。

解决方案

方案一：禁用自动打开浏览器（推荐）

修改 vite.config.js 文件，将 open 选项设置为 false：

// vite.config.js
export default defineConfig(({ mode, command }) => {
  return {
    server: {
      port: 80,
      host: true,
      open: false,  // 改为 false，禁用自动打开浏览器
      proxy: {
        // ... 其他配置
      }
    },
    // ... 其他配置
  }
})

优点：

彻底解决权限问题
不影响开发服务器功能
可以手动选择浏览器访问

使用方式：启动开发服务器后，在浏览器中手动访问 http://localhost:80

方案二：指定浏览器路径

如果确实需要自动打开浏览器，可以指定浏览器可执行文件的完整路径：

server: {
  port: 80,
  host: true,
  open: 'chrome',  // 或者指定完整路径
  // 或者
  open: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
}

注意：这种方式仍然可能遇到权限问题，不如方案一稳定。

方案三：以管理员身份运行

以管理员身份运行终端或 IDE，然后执行 npm run dev 命令。

缺点：

不是长期解决方案
可能带来安全风险
不推荐作为常规做法

验证修复

修改配置后，重新启动开发服务器：

npm run dev

应该看到类似以下的成功输出：

  VITE v6.3.5  ready in xxx ms

  ➜  Local:   http://localhost:80/
  ➜  Network: http://192.168.x.x:80/
  ➜  press h + enter to show help

然后在浏览器中手动访问 http://localhost:80 即可。

总结

spawn EPERM 错误是 Windows 系统下 Vite 开发服务器的常见问题，主要原因是自动打开浏览器功能触发了权限限制。最简单有效的解决方案是禁用自动打开浏览器功能，改为手动访问开发地址。

这种方式不仅解决了权限问题，还提供了更好的开发体验——你可以自由选择浏览器和打开时机。

解决 Vite 开发服务器启动报错：spawn EPERM