Laravel 9.0 与 Vite 3.x 存在已知兼容性问题，升级至 Laravel 9.1+ 后易触发 esbuild 的 write EPIPE 错误；降级至官方认证兼容的 Laravel 9.0 版本可稳定运行 Vite 开发服务器。
laravel 9.0 与 vite 3.x 存在已知兼容性问题，升级至 laravel 9.1+ 后易触发 esbuild 的 write epipe 错误；降级至官方认证兼容的 laravel 9.0 版本可稳定运行 vite 开发服务器。
该错误本质是 Laravel Mix 与 Vite 插件协同失效导致的底层构建进程异常中断，并非网络或权限问题。错误堆栈中 esbuild/lib/main.js 抛出的 The service was stopped: write EPIPE 明确指向子进程通信管道意外关闭——这在 Laravel 9.1+ 中因 Vite 插件（@vitejs/plugin-vue、laravel-vite-plugin）与新版 Laravel 内核的资产注入逻辑不匹配而高频出现。
✅ 推荐解决方案：使用 Laravel 9.0 官方稳定基线
Laravel 9.0（发布于 2022 年 2 月）是首个深度集成 Vite 的正式版本，其 laravel-vite-plugin@0.5.4 与 Vite v3.0.9 经过充分测试，可避免此 EPIPE 崩溃：
# 清理当前项目（如需保留代码，请先备份 resources/ 和 routes/ 等核心目录） rm -rf node_modules package-lock.json public/build # 创建全新、兼容的 Laravel 9.0 项目（指定精确版本） composer create-project laravel/laravel example-app "9.0.*" cd example-app # 安装前端依赖（Vite 及配套插件将自动适配） npm install # 启动开发服务器 —— 此时应正常输出： # VITE v3.0.9 ready in XXX ms # ➜ Local: http://127.0.0.1:5173/ # LARAVEL v9.0.x plugin v0.5.4 npm run dev
⚠️ 重要注意事项
- ❌ 不要尝试
npm update或升级laravel-vite-plugin至 0.6+，这会破坏兼容性； - ✅ 若必须使用 Laravel 9.26+，请改用 Laravel官方Vite迁移指南 升级插件与配置，并确保
vite.config.js中laravel({})配置项完整（尤其input和refresh）； - ? Windows 用户若仍遇 EPIPE，可临时添加
--host 127.0.0.1参数规避 IPv6 相关管道冲突：npm run dev -- --host 127.0.0.1。
总结：这不是环境配置失误，而是 Laravel 主版本迭代中 Vite 集成策略变更引发的向后兼容断层。坚持“版本对齐”原则——即 Laravel 核心、Vite、laravel-vite-plugin 三者版本需协同锁定——是保障本地开发稳定性的关键实践。
