Laravel 9运行npm run dev时Vite出现EPIPE错误求助

算力阿峰

2026-8-21

Laravel 9运行npm run dev出现EPIPE错误的解决方案

我使用Laravel 9版本，执行npm install完成后，运行npm run dev时出现以下错误：

VITE v3.0.9  ready in 648 ms

  ➜  Local:   http://127.0.0.1:5173/
  ➜  Network: use --host to expose

  LARAVEL v9.26.0  plugin v0.5.4

  ➜  APP_URL: http://127.0.0.1:8000
C:\Software Project\Web Development\AdminPanel\node_modules\esbuild\lib\main.js:1356
        return callback(new Error(error), null);
                        ^

Error: The service was stopped: write EPIPE
    at C:\Software Project\Web Development\AdminPanel\node_modules\esbuild\lib\main.js:1356:25    
    at C:\Software Project\Web Development\AdminPanel\node_modules\esbuild\lib\main.js:678:9      
    at afterClose (C:\Software Project\Web Development\AdminPanel\node_modules\esbuild\lib\main.js:656:7)
    at C:\Software Project\Web Development\AdminPanel\node_modules\esbuild\lib\main.js:2075:11    
    at onwriteError (node:internal/streams/writable:417:3)
    at processTicksAndRejections (node:internal/process/task_queues:85:21)

可行的解决步骤

清理依赖缓存并重装
删除项目根目录下的node_modules文件夹、package-lock.json文件，执行以下命令重置依赖：
```
npm cache clean --force
npm install
```
更新或重新安装esbuild
这个错误大概率和esbuild进程异常有关，直接更新到最新版：
```
npm install esbuild@latest --save-dev
```
检查端口占用情况
确认5173端口未被其他程序占用，Windows下可通过以下命令排查并终止占用进程：
```
netstat -ano | findstr :5173
taskkill /PID <查到的进程ID> /F
```
提升终端权限运行
右键终端选择“以管理员身份运行”，再执行npm run dev，避免权限不足导致的进程写入失败。
调整Node.js版本
部分高版本Node.js和esbuild v3存在兼容性冲突，尝试切换到Node.js 16.x或18.x LTS版本后重试。