Nuxt.js SSR项目使用Vite时出现ETXTBSY文本文件占用报错如何解决
问题排查与解决方法
根因说明
ETXTBSY错误属于Linux/Unix系统特有错误,代表目标文件正在被其他进程占用,无法执行删除/修改操作。你遇到的报错链是:Vite在路由跳转触发动态依赖预构建时,尝试清空旧的缓存文件,但是该文件被其他进程锁定无法删除,导致Vite预构建流程崩溃,后续前端请求的JS资源返回的是Vite的错误页面(text/html类型),因此触发浏览器MIME类型校验失败。Webpack的依赖预编译逻辑是启动时全量执行,不会在路由跳转时动态修改缓存文件,因此不会触发该类错误。
排查步骤
- 排查是否有后台进程锁定node_modules目录
常见的杀毒扫描工具、系统文件索引服务、IDE的node_modules自动索引插件都会在后台扫描文件,导致缓存文件被临时锁定,Vite执行删除操作失败。可以临时关闭这类工具后重试,确认是否是进程占用导致。 - 排查文件系统兼容性问题
如果项目目录存放在网络挂载盘、共享文件夹、WSL挂载的Windows分区(路径格式为/mnt/c/这类),这类文件系统的文件锁机制和原生本地文件系统存在差异,会误报ETXTBSY错误。可以把项目移动到本地原生磁盘后重试。 - 排查版本兼容性问题
执行npx nuxi info查看当前Nuxt与Vite版本,确认是否存在已知的版本兼容性bug,比如Nuxt 3.4.x版本搭配Vite 4.2.x存在预构建触发时机的bug,会在路由跳转时重复触发全量预构建。
解决方案
- 方案1:修改Vite缓存目录,避开占用风险
在nuxt.config.ts中添加配置,指定Vite的缓存目录为系统临时目录,避开被扫描的路径:export default defineNuxtConfig({ vite: { cacheDir: '/tmp/nuxt-vite-cache' } }) - 方案2:提前指定所有需要预构建的依赖,关闭动态依赖发现
手动列出所有需要预构建的依赖,避免路由跳转时动态触发预构建:export default defineNuxtConfig({ vite: { optimizeDeps: { disabled: false, include: [ // 手动添加项目中用到的所有第三方依赖,比如'element-plus', 'vueuse'等 ], noDiscovery: true } } }) - 方案3:固定兼容的Vite版本
如果是版本兼容性问题,可以将Vite版本固定到4.3.9或者最新的4.x稳定版,以yarn为例在package.json的resolutions中添加配置(pnpm用overrides字段):{ "resolutions": { "vite": "4.3.9" } } - 方案4:临时捕获ETXTBSY异常跳过占用文件
如果以上方案都不生效,可以直接在nuxt.config.ts顶部添加钩子,拦截文件删除异常跳过被占用的文件:import fs from 'fs' const originalUnlink = fs.unlinkSync fs.unlinkSync = (path) => { try { return originalUnlink(path) } catch (e) { if (e.code === 'ETXTBSY') return throw e } } export default defineNuxtConfig({ // 原有项目配置 })
内容的提问来源于stack exchange,提问作者DengSihan
相关产品推荐
相关产品推荐

