You need to enable JavaScript to run this app. Nuxt.js SSR项目使用Vite时出现ETXTBSY文本文件占用报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 12:15:04